Preguntas más frecuentes sobre las API de Windows Age

En este artículo se responden las preguntas más frecuentes sobre el uso de las API de Age de Windows para crear experiencias de aplicación adecuadas para la edad.

Overview

¿Cuáles son las interfaces API de antigüedad de Windows?

Las API de Age de Windows proporcionan señales de edad que conservan la privacidad para el usuario que ejecuta el proceso actual. En lugar de devolver una edad exacta o una fecha de nacimiento, Windows devuelve un intervalo de edad o un estado de verificación para adultos que una aplicación puede usar para proporcionar una experiencia adecuada para la edad.

Estas API son métodos Windows Runtime en Windows.System.User. Ayudan a las aplicaciones a tomar decisiones sobre políticas y experiencias relacionadas con la edad sin recibir la fecha exacta de nacimiento del usuario.

Si un usuario da su consentimiento, un desarrollador puede acceder a señales de edad que las aplicaciones pueden usar al diseñar experiencias adecuadas para la edad. Los desarrolladores de aplicaciones siguen siendo responsables de determinar cómo se aplican las leyes y los requisitos aplicables a sus productos.

¿Para qué escenarios están pensadas las API de Windows Age?

Las aplicaciones pueden usar señales de edad cuando la edad es relevante para la experiencia. Por ejemplo, una aplicación podría usar una señal de edad si esta:

  • Muestra contenido generado por el usuario, características sociales o comunicaciones que podrían no ser adecuados para todas las edades.
  • Ofrece compras en la aplicación o monedas virtuales para las que se pueden aplicar restricciones de edad.
  • Transmite o reproduce elementos multimedia con clasificaciones por edades.

Por lo general, una aplicación puede usar una señal de edad para adaptar su contenido, características o controles de acceso sin recopilar una fecha de nacimiento.

¿Qué API de Windows Age están disponibles?

Las API siguientes admiten diferentes escenarios:

  • GetUserAgeRangeAsync devuelve un UserAgeRange que contiene los límites inferiores y superiores inclusivos del grupo de edad del usuario. Los grupos predefinidos están por debajo de 10, 10–12, 13–15, 16–17 y 18 o más. Un null resultado significa que el intervalo de edad es desconocido o no disponible.
  • GetAgeVerificationStatusAsync devuelve un valor UserAgeVerificationStatus que indica el estado de verificación para adultos del usuario. No comprueba una edad arbitraria ni un grupo de edad.

¿La comprobación de edad comprueba la edad o el grupo de edad de un usuario?

N. º La verificación de edad proporciona la condición de adulto verificado, no una condición verificada para ninguna edad o grupo de edad. Para la verificación basada en cuentas, un usuario que dice ser adulto debe pasar por un flujo que compruebe si esa persona es un adulto. El flujo comprueba la declaración de mayoría de edad; no establece una edad comprobada para un niño o adolescente.

Para obtener información sobre cómo verificar tu edad para una cuenta Microsoft, consulta Verificar tu edad para una cuenta Microsoft.

GetAgeVerificationStatusAsync informa del estado de verificación de adultos. Un Verified resultado informa del estado de adulto verificado. Otros resultados no establecen que el usuario es un menor: la aplicación debe distinguir un Unverified resultado, un OptedOut resultado y resultados no disponibles o indeterminados.

¿Las Windows Age APIs están disponibles con carácter general?

GetUserAgeRangeAsync y GetAgeVerificationStatusAsync ya están disponibles. Las compilaciones de Windows comerciales admitidas son:

  • Windows 11, versión 24H2: compilación 26100.9550 o posterior.
  • Windows 11, versión 25H2: compilación 26200.9550 o posterior.

La versión 10.0.26100.9169 o posterior de Windows SDK incluye estas API.

¿Qué API debe usar mi aplicación?

Uso:

  • GetUserAgeRangeAsync cuando la aplicación necesita una franja de edad y aplica su propio criterio o lógica de directiva.
  • GetAgeVerificationStatusAsync cuando una decisión depende de si el usuario ha verificado su mayoría de edad.

Una aplicación puede usar más de una señal de edad cuando sea adecuado para su escenario. Un resultado de intervalo de edad de 18 o más no establece por sí mismo la condición de adulto verificado.

Privacidad y control de datos

¿Puedo configurar mis propios intervalos de edad para GetUserAgeRangeAsync?

N. º Los grupos de edad devueltos por GetUserAgeRangeAsync están predefinidos.

¿Devuelven las API la edad exacta del usuario o su fecha de nacimiento?

N. º GetUserAgeRangeAsync devuelve un grupo de edad, no una edad exacta o una fecha de nacimiento. Por ejemplo, un resultado con límites inferiores y superiores de {13, 15} significa que la edad del usuario está en el grupo de edad de 13 a 15 años.

GetAgeVerificationStatusAsync notifica el estado de verificación de mayoría de edad, no una edad comprobada ni un grupo de edad comprobado.

¿Necesita mi aplicación recopilar la fecha de nacimiento de un usuario para usar las API de edad de Windows?

N. º Un propósito de las API es permitir que las aplicaciones tomen decisiones relacionadas con la edad sin recibir directamente la fecha de nacimiento del usuario.

¿Las aplicaciones deben almacenar una señal de edad?

Las aplicaciones deben evitar que las señales de edad persistan innecesariamente. Recupere el indicador cuando sea necesario porque el grupo de edad de un usuario, el estado de verificación, el estado de la cuenta o la directiva administrativa aplicable pueden cambiar.

Comportamiento del usuario y de la cuenta

¿Qué tipos de cuenta se admiten?

Las señales de edad del proveedor de identidades solo están disponibles actualmente para cuentas de Microsoft. Para otros tipos de cuenta, cuando un valor predeterminado administrativo no está configurado, GetUserAgeRangeAsync devuelve nully GetAgeVerificationStatusAsync devuelve NotApplicable.

¿Sobre qué usuario devuelve información una API de edad?

Las llamadas a Age API se aplican al usuario que ejecuta el proceso actual. En un dispositivo con varios perfiles de Windows, las API consultan el perfil del usuario actual para la experiencia de aplicación activa. Las API no proporcionan un mecanismo para consultar un perfil diferente.

¿Puede una aplicación consultar una señal de edad para otro usuario en el dispositivo?

N. º Las API funcionan en el contexto del usuario que ejecuta el proceso. Llamar a una API age con un User objeto que represente a un usuario diferente puede dar lugar a E_ACCESSDENIED.

¿Qué ocurre cuando un usuario tiene varios tipos de cuenta conectados a Windows?

Las API de Windows Age funcionan en el contexto del usuario de Windows que ha iniciado sesión actualmente y usan la cuenta Microsoft asociada al inicio de sesión de Windows de ese usuario. Las aplicaciones no pueden seleccionar otra cuenta conectada para la consulta.

¿Qué ocurre si no se puede determinar un indicador de edad?

Las aplicaciones deben estar preparadas para que una señal de edad no esté disponible o indeterminada.

Para GetUserAgeRangeAsync, null significa que el intervalo de edad es desconocido o no disponible. Las condiciones que pueden producir null incluyen:

  • No se admite el tipo de cuenta.
  • La información de edad no está disponible para la cuenta.
  • La API está deshabilitada por la directiva administrativa.

Para GetAgeVerificationStatusAsync, NotApplicable o TemporarilyUnavailable representa una señal de comprobación no disponible o indeterminada. Estos resultados no establecen si el usuario ha verificado que es mayor de edad.

Las aplicaciones deben proporcionar una experiencia alternativa adecuada y no deben interpretar un resultado no disponible como un grupo de edad específico o un estado de verificación.

¿Deben las aplicaciones suponer que una señal de edad siempre está disponible?

N. º Las aplicaciones deben diseñar el comportamiento alternativo como parte de su integración de Age API. Trate una señal válida, una señal no disponible o indeterminada y un error de acceso denegado como estados distintos.

Requisitos e implementación de aplicaciones

¿Qué sistema operativo y SDK son necesarios?

Windows 11 es el sistema operativo mínimo admitido. GetUserAgeRangeAsync y GetAgeVerificationStatusAsync están disponibles en las siguientes compilaciones comerciales admitidas:

  • Windows 11, versión 24H2: compilación 26100.9550 o posterior.
  • Windows 11, versión 25H2: compilación 26200.9550 o posterior.

Use la versión 10.0.26100.9169 o posterior del SDK de Windows para compilar una aplicación que llame a estas API.

Dado que una API puede estar ausente en un sistema anterior o sin mantenimiento, compruebe la disponibilidad de la API antes de llamarla.

¿Necesita mi aplicación declarar una capacidad?

Yes. Una aplicación para UWP debe declarar la capacidad userAccountInformation en su manifiesto de paquete:

<uap:Capability Name="userAccountInformation" />

Sin el acceso necesario, la aplicación no puede leer los datos de edad del usuario.

¿Cómo obtengo el objeto User usado para llamar a age API?

Utilice User.GetDefault para obtener el usuario que ejecuta el proceso actual. User.FindAllAsync puede enumerar usuarios, pero se debe llamar a una API Age con la instancia User que representa al usuario que ejecuta el proceso.

¿Cuánto tiempo tarda en afectar a la señal de edad un cambio en la fecha de nacimiento o el cumpleaños?

Si un usuario cambia la fecha de nacimiento asociada a su cuenta Microsoft o cumple años, el cambio se refleja en un plazo de 24 horas después de la última obtención de la señal de edad.

¿Una aplicación puede forzar una actualización de señal de edad?

N. º No se admite una actualización forzada.

Control de errores y mecanismo alternativo

¿Cómo debe gestionar una aplicación un intervalo de edad no disponible?

Gestiona explícitamente un intervalo de edad no disponible en lugar de asumir una edad. Un null resultado de GetUserAgeRangeAsync significa que el intervalo de edad es desconocido o no disponible.

Utiliza una experiencia alternativa diseñada deliberadamente. No interpretes null como un grupo de edad determinado, incluido el grupo de 18 o más años.

¿Qué significa E_ACCESSDENIED?

E_ACCESSDENIED puede significar que quien realiza la llamada no tiene acceso a la información de la cuenta o que la aplicación llamó a la API con un objeto User para alguien que no sea el usuario que ejecuta el proceso.

Trate este error como distinto de una señal no disponible. Se devuelve una señal no disponible como null, NotApplicableo TemporarilyUnavailable, en función de la API.

¿Qué debe hacer una aplicación con un estado de comprobación desconocido?

Gestiona explícitamente los estados de comprobación no disponibles o indeterminados y proporciona una experiencia alternativa. NotApplicable y TemporarilyUnavailable no establecen si el usuario ha verificado que es mayor de edad. No interprete estos resultados, Unverified ni OptedOut como prueba de que el usuario es un menor.

Consulte también

  • Se actualizó por última vez el