Introducción a las señales de edad

Las API de Windows Age proporcionan señales que preservan la privacidad y que las aplicaciones pueden usar para comprender el grupo de edad y el estado de verificación para adultos del usuario que ha iniciado sesión. Las API devuelven señales gruesas en lugar de la edad exacta o la fecha de nacimiento del usuario. Las aplicaciones pueden usar estas señales para adaptar contenido, características o controles de acceso y deben proporcionar un comportamiento de reserva adecuado cuando una señal no está disponible.

¿Qué son las señales de edad?

Las señales de edad son valores que Windows devuelve cuando una aplicación llama a las API de edad del usuario actual. La aplicación decide cuándo solicitar el estado de verificación de adultos o el grupo de edad del usuario para ofrecer la experiencia adecuada al usuario final.

Ninguna señal expone directamente la edad exacta del usuario o la fecha exacta de nacimiento. La GetUserAgeRangeAsync API proporciona un intervalo de edad que la aplicación puede usar para tomar decisiones de contenido. Ofrece los siguientes grupos de edad:

  • Menos de 10
  • 10-12
  • 13-15
  • 16-17
  • 18+

API de Windows Age

GetUserAgeRangeAsync

El GetUserAgeRangeAsync método devuelve el intervalo de edad del usuario como un UserAgeRange objeto con Lower propiedades y Upper .

Grupo de edad Valores devueltos
Menos de 10 {0, 9}
10-12 {10, 12}
13-15 {13, 15}
16-17 {16, 17}
18+ {18, INT32_MAX}
Desconocido null

Cuando el resultado es null, el intervalo de edad es desconocido o no está disponible. Las aplicaciones deben usar su experiencia alternativa y no deben interpretar null como un grupo de edad específico.

GetAgeVerificationStatusAsync

El método GetAgeVerificationStatusAsync devuelve un valor UserAgeVerificationStatus que indica el estado de verificación de mayoría de edad notificado para el usuario. La comprobación de edad comprueba si un usuario que dice ser adulto es un adulto. No establece una edad verificada ni comprueba otros grupos de edad.

Los valores posibles son:

  • Verified: El usuario ha verificado que es mayor de edad.
  • Unverified: el usuario no está verificado como adulto. Esto no establece que el usuario es un menor.
  • OptedOut: el usuario ha optado por no realizar la verificación para adultos.
  • TemporarilyUnavailable: el estado no se puede determinar actualmente.
  • NotApplicable: la comprobación no se aplica, no hay ninguna señal de verificación disponible o la característica no está disponible o deshabilitada.

Las aplicaciones deben controlar cada valor. NotApplicable y TemporarilyUnavailable no establecen si el usuario ha verificado que es mayor de edad. Un resultado de intervalo de edad de 18 o más no establece por sí mismo la condición de adulto verificado.

El paquete de la aplicación debe declarar la userAccountInformation funcionalidad. El acceso a los indicadores de edad también está sujeto al consentimiento del usuario para permitir que la aplicación acceda a la información de su cuenta en la configuración de privacidad de Windows. Si no se concede el acceso, la llamada puede fallar con E_ACCESSDENIED. El User objeto debe representar al usuario que ejecuta el proceso actual.

Directiva y disponibilidad

Cuando las API age no están disponibles o deshabilitadas, GetUserAgeRangeAsync devuelve null y GetAgeVerificationStatusAsync devuelve NotApplicable. Los administradores también pueden configurar un grupo de edad predeterminado o un estado de verificación a través de la directiva de grupo o MDM; cuando se configura, las API devuelven el valor definido por la directiva correspondiente. Las aplicaciones deben comprobar que los métodos estén disponibles antes de llamarlos y mantener un comportamiento alternativo cuando las señales no estén disponibles.

Un valor Verified definido por la directiva es un valor predeterminado administrativo, no una prueba de que el usuario haya completado el flujo de verificación de edad.

Actualmente, las señales de edad del proveedor de identidad solo se obtienen para las cuentas de Microsoft. Para otros tipos de cuenta, cuando no se configura ningún valor predeterminado administrativo, GetUserAgeRangeAsync devuelve null y GetAgeVerificationStatusAsync devuelve NotApplicable.

Cuándo usar señales de edad

Usa indicadores de edad cuando tu aplicación:

  • Muestra contenido generado por el usuario, características sociales o herramientas de comunicación que pueden no ser adecuadas para todas las edades.
  • Ofrece compras desde la aplicación o monedas virtuales en las que las restricciones de edad son pertinentes.
  • Transmite o reproduce contenido multimedia con clasificaciones de madurez.

Cómo funcionan las señales de edad a grandes rasgos

Diagrama que muestra una aplicación que intercambia información de grupo de edad con el servicio local de Digital Safety API, que se comunica con las opciones de configuración.

Privacidad y control de datos

Las señales de edad están diseñadas con privacidad como principio básico:

  • No se devuelve la edad exacta ni la fecha de nacimiento. Las API devuelven un grupo de edad y un estado de verificación para adultos. La verificación para adultos no establece una edad comprobada ni un grupo de edad de menor verificado.
  • Los grupos de edad son genéricos. Comunican grupos de edad comunes para diversos casos de uso, como los videojuegos o la legislación regional.

Requisitos de la plataforma

Requisito Detalles
Versión mínima de sistema operativo Windows 11
Superficie de API métodos de Windows Runtime en Windows.System.User
Contexto de usuario Las llamadas solo se aplican al usuario que ejecuta el proceso actual.
Funcionalidad de la aplicación El paquete de la aplicación debe declarar userAccountInformation

Véase también

  • Se actualizó por última vez el