Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Les API Windows Age fournissent des signaux de préservation de la confidentialité que les applications peuvent utiliser pour comprendre le groupe d’âge et l’état de vérification de l’âge de l’utilisateur connecté. Les API renvoient des signaux approximatifs au lieu de l’âge exact ou de la date de naissance de l’utilisateur. Les applications peuvent utiliser ces signaux pour adapter du contenu, des fonctionnalités ou des contrôles d’accès et doivent fournir un comportement de secours approprié lorsqu’un signal n’est pas disponible.
Qu’est-ce que les signaux d’âge ?
Les signaux d’âge sont des valeurs qui Windows retournent lorsqu’une application appelle les API Age pour l’utilisateur actuel. L’application décide à quel moment demander à l’utilisateur sa tranche d’âge ou son statut de vérification de l’âge afin de proposer l’expérience adaptée à l’utilisateur final.
Un signal d’âge n’expose pas directement l’âge exact ou la date de naissance de l’utilisateur. Au lieu de cela, il fournit une plage d’âge que l’application peut utiliser pour prendre des décisions de contenu. L’API GetUserAgeRangeAsync propose les groupes d’âge suivants :
- Moins de 10 ans
- 10-12
- 13-15
- 16-17
- 18+
API de vérification de l’âge pour Windows
GetUserAgeRangeAsync
La GetUserAgeRangeAsync méthode retourne la plage d’âge de l’utilisateur en tant qu’objet UserAgeRange avec Lower et Upper propriétés.
| Tranche d’âge | Valeurs de retour |
|---|---|
| Moins de 10 ans | {0, 9} |
| 10-12 | {10, 12} |
| 13-15 | {13, 15} |
| 16-17 | {16, 17} |
| 18+ | {18, INT32_MAX} |
| Unknown | null |
Lorsque le résultat est null, la plage d’âge est inconnue ou indisponible. Les applications doivent utiliser leur solution de repli et ne doivent pas interpréter null comme un groupe d’âge spécifique.
GetAgeVerificationStatusAsync
La GetAgeVerificationStatusAsync méthode retourne une UserAgeVerificationStatus valeur indiquant l’état de vérification de l’âge signalé pour l’utilisateur. Les valeurs possibles sont les suivantes :
-
Verified: l’âge de l’utilisateur a été vérifié. -
Unverified: l’âge de l’utilisateur n’a pas été vérifié. -
OptedOut: l’utilisateur a refusé la vérification de l’âge. -
TemporarilyUnavailable: L’état ne peut pas être déterminé actuellement. -
NotApplicable: la vérification ne s’applique pas, aucun signal de vérification n’est disponible, ou la fonctionnalité n’est pas disponible ou désactivée.
Les applications doivent gérer chaque valeur.
NotApplicable et TemporarilyUnavailable n’établissez pas que l’utilisateur est vérifié ou non vérifié.
Autorisation et consentement de l’appelant
Le package d’application doit déclarer la userAccountInformation fonctionnalité. L’accès aux signaux d’âge est également subordonné au consentement de l’utilisateur autorisant l’application à accéder aux informations du compte dans les paramètres de confidentialité de Windows. Si l’accès n’est pas accordé, l’appel peut échouer avec E_ACCESSDENIED. L’objet User doit représenter l’utilisateur exécutant le processus actuel.
Stratégie et disponibilité
Lorsque les API Age ne sont pas disponibles ou désactivées, GetUserAgeRangeAsync retourne null et GetAgeVerificationStatusAsync retourne NotApplicable. Les administrateurs peuvent également configurer un groupe d’âge par défaut ou un état de vérification par le biais d’une stratégie de groupe ou d’une gestion des appareils mobiles ; lorsqu’elles sont configurées, les API retournent la valeur définie par la stratégie correspondante. Les applications doivent vérifier que les méthodes sont disponibles avant de les appeler et de conserver le comportement de secours pour les signaux indisponibles.
Les signaux d’âge du fournisseur d’identité sont actuellement récupérés uniquement pour les comptes Microsoft. Pour les autres types de comptes, lorsqu’aucune valeur par défaut d’administration n’est configurée, GetUserAgeRangeAsync retourne null et GetAgeVerificationStatusAsync retourne NotApplicable.
Quand utiliser des signaux d’âge
Utilisez les signaux d’âge lorsque votre application :
- Affiche le contenu généré par l’utilisateur, les fonctionnalités sociales ou les outils de communication qui peuvent ne pas convenir à tous les âges.
- Offre des achats dans l’application ou des devises virtuelles où les restrictions d’âge sont pertinentes.
- Diffuse ou lit du contenu multimédia avec des classifications d’âge.
Comment fonctionnent les signaux d’âge dans les grandes lignes
Confidentialité et gestion des données
Les signaux d’âge sont conçus avec la confidentialité comme principe de base :
- Aucun âge exact ou date de naissance n’est retourné. Les API renvoient une tranche d’âge et un statut de vérification de l’âge.
- Les groupes d’âge sont génériques. Ils indiquent les tranches d’âge courantes pour différents usages, tels que les jeux ou la législation régionale.
Configuration requise pour la plateforme
| Requirement | Détails |
|---|---|
| Version de système d’exploitation minimale | Windows 11 |
| Surface d’API | Méthodes Windows Runtime sur Windows.System.User |
| Contexte de l’utilisateur | Les appels s’appliquent uniquement à l’utilisateur exécutant le processus actuel. |
| Fonctionnalité de l’application | Le package d’application doit déclarer userAccountInformation |
Voir aussi
Windows developer