Veelgestelde vragen over Windows leeftijds-API's

In dit artikel vindt u antwoorden op veelgestelde vragen over het gebruik van Windows Age-API's om leeftijdsspecifieke app-ervaringen te bouwen.

Overview

Wat zijn de Windows Age-API's?

De Windows Leeftijd-API's bieden privacybehoudende leeftijdssignalen voor de gebruiker die het huidige proces uitvoert. In plaats van een exacte leeftijd of geboortedatum te retourneren, retourneert Windows een leeftijdsbereik of volwassenenverificatiestatus die een app kan gebruiken om een passende leeftijdsgebonden ervaring te bieden.

Deze API's zijn Windows Runtime methoden op Windows.System.User. Ze helpen apps beslissingen over gebruikerservaring op basis van leeftijd en beleidsbeslissingen te nemen zonder de exacte geboortedatum van de gebruiker te ontvangen.

Als een gebruiker toestemming geeft, heeft een ontwikkelaar toegang tot leeftijdssignalen die toepassingen kunnen gebruiken bij het ontwerpen van leeftijdsgeschikte ervaringen. Toepassingsontwikkelaars blijven verantwoordelijk voor het bepalen hoe toepasselijke wetten en vereisten van toepassing zijn op hun producten.

Voor welke scenario's zijn de Windows Age API's bedoeld?

Apps kunnen leeftijdssignalen gebruiken wanneer leeftijd relevant is voor de gebruikerservaring. Een app kan bijvoorbeeld een leeftijdssignaal gebruiken als die:

  • Geeft door de gebruiker gegenereerde inhoud, sociale functies of communicatie weer die mogelijk niet geschikt zijn voor alle leeftijden.
  • Biedt in-app aankopen of virtuele valuta's waarvoor leeftijdsbeperkingen van toepassing kunnen zijn.
  • Streamt media of speelt media af met leeftijdsclassificaties.

Over het algemeen kan een app een leeftijdssignaal gebruiken om de inhoud, functies of toegangsbeheer aan te passen zonder een geboortedatum te verzamelen.

Welke Windows Age API's zijn beschikbaar?

De volgende API's ondersteunen verschillende scenario's:

  • GetUserAgeRangeAsync retourneert een UserAgeRange met de inclusieve onder- en bovengrenzen van de leeftijdsgroep van de gebruiker. De vooraf gedefinieerde groepen zijn minder dan 10, 10-12, 13-15, 16-17 en 18 of ouder. Een null resultaat betekent dat het leeftijdsbereik onbekend of niet beschikbaar is.
  • GetAgeVerificationStatusAsync geeft een UserAgeVerificationStatus terug die de volwassenverificatiestatus van de gebruiker aangeeft. Er wordt geen willekeurige leeftijd of leeftijdsgroep geverifieerd.

Controleert de leeftijdsverificatie de leeftijd of leeftijdsgroep van de gebruiker?

No. Leeftijdscontrole biedt status als geverifieerde volwassene, geen geverifieerde status voor welke leeftijd of leeftijdsgroep dan ook. Voor verificatie op basis van accounts moet een gebruiker die claimt een volwassene te zijn een stroom doorlopen waarmee wordt gecontroleerd of die persoon een volwassene is. De flow controleert de volwassenenclaim; er wordt geen geverifieerde leeftijd vastgesteld voor een kind of tiener.

Zie Uw leeftijd voor een Microsoft-account verifiëren voor informatie over het verifiëren van uw leeftijd voor een Microsoft-account.

GetAgeVerificationStatusAsync rapporteert de status van de volwassenenverificatie. Een Verified resultaat geeft de geverifieerde volwassenstatus aan. Andere resultaten stellen niet vast dat de gebruiker minderjarig is: uw app moet een Unverified resultaat, een OptedOut resultaat en niet-beschikbare of onbepaalde resultaten onderscheiden.

Zijn de Windows Age-API's algemeen verkrijgbaar?

GetUserAgeRangeAsync en GetAgeVerificationStatusAsync zijn algemeen beschikbaar. De ondersteunde Windows-builds voor retail zijn:

  • Windows 11, versie 24H2: build 26100.9550 of hoger.
  • Windows 11, versie 25H2: build 26200.9550 of hoger.

Windows SDK-versie 10.0.26100.9169 of hoger bevat deze API's.

Welke API moet mijn app gebruiken?

Gebruik:

  • GetUserAgeRangeAsync wanneer uw app een leeftijdscategorie nodig heeft en zijn eigen ervaring of beleidslogica toepast.
  • GetAgeVerificationStatusAsync wanneer een beslissing afhangt van de vraag of de gebruiker de meerderjarigheidsstatus heeft geverifieerd.

Een app kan meer dan één leeftijdssignaal gebruiken wanneer dit geschikt is voor het scenario. Een resultaat van de leeftijdsinschatting van 18 jaar of ouder bewijst op zichzelf geen geverifieerde meerderjarigheid.

Privacy en gegevensverwerking

Kan ik mijn eigen leeftijdsbereiken configureren voor GetUserAgeRangeAsync?

No. De leeftijdsgroepen die door GetUserAgeRangeAsync worden geretourneerd, zijn vooraf gedefinieerd.

Geven de API's de exacte leeftijd of geboortedatum van de gebruiker terug?

No. GetUserAgeRangeAsync geeft een leeftijdsgroep, niet een exacte leeftijd of geboortedatum. Een resultaat met onder- en bovengrenzen van {13, 15} betekent bijvoorbeeld dat de gebruiker in de leeftijdsgroep van 13–15 jaar zit.

GetAgeVerificationStatusAsync rapporteert de status van leeftijdsverificatie voor volwassenen, niet een geverifieerde leeftijd of geverifieerde leeftijdsgroep.

Moet mijn app de geboortedatum van een gebruiker verzamelen om de WINDOWS Leeftijd-API's te gebruiken?

No. Een doel van de API's is om apps leeftijdsgerelateerde beslissingen te laten nemen zonder rechtstreeks de geboortedatum van de gebruiker te ontvangen.

Moeten apps een leeftijdssignaal opslaan?

Apps moeten leeftijdssignalen niet onnodig opslaan. Haal het signaal op wanneer dit nodig is, omdat de leeftijdsgroep van een gebruiker, de verificatiestatus, de accountstatus of het toepasselijke beheerbeleid kan worden gewijzigd.

Gedrag van gebruikers en accounts

Welke accounttypen worden ondersteund?

Leeftijdssignalen van id-providers zijn momenteel alleen beschikbaar voor Microsoft accounts. Voor andere accounttypen, wanneer een beheerstandaard niet is geconfigureerd, retourneert GetUserAgeRangeAsyncnull en retourneert GetAgeVerificationStatusAsyncNotApplicable.

Over welke gebruiker retourneert een Age-API informatie?

Leeftijds-API-aanroepen zijn van toepassing op de gebruiker die het huidige proces uitvoert. Op een apparaat met meerdere Windows-profielen doorzoeken de API's het profiel van de huidige gebruiker voor de actieve app-ervaring. De API's bieden geen mechanisme voor het uitvoeren van query's op een ander profiel.

Kan een app een leeftijdssignaal opvragen voor een andere gebruiker op het apparaat?

No. De API's worden uitgevoerd in de context van de gebruiker die het proces uitvoert. Het aanroepen van een Age-API met een User object dat een andere gebruiker vertegenwoordigt, kan leiden tot E_ACCESSDENIED.

Wat gebeurt er wanneer een gebruiker meerdere accounttypen aan Windows heeft gekoppeld?

De Windows Age-API's worden uitgevoerd in de context van de momenteel aangemelde Windows-gebruiker en gebruiken de Microsoft-account die is gekoppeld aan de Windows-aanmelding van die gebruiker. Apps kunnen geen ander verbonden account voor de query selecteren.

Wat gebeurt er als een leeftijdssignaal niet kan worden bepaald?

Apps moeten voorbereid zijn op een leeftijdssignaal dat niet beschikbaar of onbepaald kan zijn.

Voor null betekent GetUserAgeRangeAsync dat het leeftijdsbereik onbekend of niet beschikbaar is. Omstandigheden die null kunnen optreden, zijn:

  • Het accounttype wordt niet ondersteund.
  • Leeftijdsgegevens zijn niet beschikbaar voor het account.
  • De API is uitgeschakeld door administratief beleid.

Voor NotApplicable, TemporarilyUnavailable of GetAgeVerificationStatusAsync vertegenwoordigt een niet-beschikbaar of onbepaald verificatiesignaal. Deze resultaten stellen niet vast of de gebruiker de volwassen status heeft geverifieerd.

Apps moeten een geschikte terugvalervaring bieden en mogen een niet-beschikbaar resultaat niet interpreteren als een specifieke leeftijdsgroep of verificatiestatus.

Moeten apps aannemen dat een leeftijdssignaal altijd beschikbaar is?

No. Apps moeten het terugvalgedrag ontwerpen als onderdeel van hun Age API-integratie. Behandel een geldig signaal, een niet-beschikbaar of onbepaald signaal en een fout met geweigerde toegang als afzonderlijke statussen.

App-vereisten en -implementatie

Welk besturingssysteem en welke SDK zijn vereist?

Windows 11 is het minimaal ondersteunde besturingssysteem. GetUserAgeRangeAsync en GetAgeVerificationStatusAsync zijn beschikbaar in de volgende ondersteunde retailversies:

  • Windows 11, versie 24H2: build 26100.9550 of hoger.
  • Windows 11, versie 25H2: build 26200.9550 of hoger.

Gebruik Windows SDK-versie 10.0.26100.9169 of hoger om een app te bouwen die deze API's aanroept.

Omdat een API niet aanwezig kan zijn op een ouder of niet-onderhouden systeem, controleert u of de API beschikbaar is voordat u deze aanroept.

Moet mijn app een capability declareren?

Yes. Een UWP-app moet de userAccountInformation-mogelijkheid in het pakketmanifest declareren:

<uap:Capability Name="userAccountInformation" />

Zonder de vereiste toegang kan de app de leeftijdsgegevens van de gebruiker niet lezen.

Hoe kan ik het gebruikersobject ophalen dat wordt gebruikt om een Age-API aan te roepen?

Gebruik User.GetDefault om de gebruiker te verkrijgen die het huidige proces uitvoert. User.FindAllAsync kan gebruikers opsommen, maar een Age API moet worden aangeroepen met het User exemplaar dat de gebruiker vertegenwoordigt die het proces uitvoert.

Hoe lang duurt het voordat een wijziging van de geboortedatum of een verjaardag van invloed is op een leeftijdssignaal?

Als een gebruiker de geboortedatum wijzigt die is gekoppeld aan de Microsoft-account of een verjaardag heeft, wordt de wijziging binnen 24 uur na het ophalen van het laatste leeftijdssignaal doorgevoerd.

Kan een app het vernieuwen van een leeftijdssignaal afdwingen?

No. Een geforceerde vernieuwing wordt niet ondersteund.

Fout- en terugvalafhandeling

Hoe moet een app een niet-beschikbaar leeftijdsbereik verwerken?

Een niet-beschikbaar leeftijdsbereik expliciet verwerken in plaats van een leeftijd aan te nemen. Een null resultaat van GetUserAgeRangeAsync betekent dat het leeftijdsbereik onbekend of niet beschikbaar is.

Gebruik een speciaal ontworpen fallbackervaring. Interpreteer null niet als een bepaalde leeftijdsgroep, inclusief de groep van 18 jaar en ouder.

Wat betekent E_ACCESSDENIED?

E_ACCESSDENIED kan betekenen dat de aanroeper geen toegang heeft tot accountgegevens of dat de app de API aanroept met een User object voor iemand anders dan de gebruiker die het proces uitvoert.

Behandel deze fout als verschillend van een niet-beschikbaar signaal. Er wordt een niet-beschikbaar signaal geretourneerd als null, NotApplicableof TemporarilyUnavailable, afhankelijk van de API.

Wat moet een app doen met een onbekende verificatiestatus?

Handel niet-beschikbare of onbepaalde verificatiestatussen expliciet af en bied een fallbackoptie. NotApplicable en TemporarilyUnavailable stellen niet vast of de volwassenstatus van de gebruiker is geverifieerd. Interpreteer deze resultaten, Unverified, of OptedOut niet als bewijs dat de gebruiker een minderjarige is.

Zie ook

  • Laatst bijgewerkt om