Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De Windows Age-API's bieden privacybeschermende signalen die apps kunnen gebruiken om inzicht te krijgen in de leeftijdsgroep en de verificatiestatus van volwassenen van de aangemelde gebruiker. De API's geven globale signalen terug in plaats van de exacte leeftijd of geboortedatum van de gebruiker. Apps kunnen deze signalen gebruiken om inhoud, functies of toegangsbeheer aan te passen en moeten het juiste terugvalgedrag bieden wanneer een signaal niet beschikbaar is.
Wat zijn leeftijdssignalen?
Leeftijdssignalen zijn waarden die Windows retourneert wanneer een app de Leeftijd-API's aanroept voor de huidige gebruiker. De app bepaalt wanneer de leeftijdsgroep of verificatiestatus voor volwassenen moet worden aangevraagd om de juiste eindgebruikerservaring te bepalen.
Geen van beide signaal maakt de exacte leeftijd of geboortedatum van de gebruiker rechtstreeks zichtbaar. De GetUserAgeRangeAsync API biedt een leeftijdsbereik dat de app kan gebruiken om inhoudsbeslissingen te nemen. Het biedt de volgende leeftijdsgroepen:
- Onder de 10
- 10-12
- 13-15
- 16-17
- 18+
Leeftijds-API's voor Windows
GetUserAgeRangeAsync
De GetUserAgeRangeAsync methode retourneert het leeftijdsbereik van de gebruiker als een UserAgeRange object met Lower en Upper eigenschappen.
| Leeftijdsgroep | Retourwaarden |
|---|---|
| Onder de 10 | {0, 9} |
| 10-12 | {10, 12} |
| 13-15 | {13, 15} |
| 16-17 | {16, 17} |
| 18+ | {18, INT32_MAX} |
| Onbekend | null |
Wanneer het resultaat is null, is het leeftijdsbereik onbekend of niet beschikbaar. Apps moeten hun terugvalervaring gebruiken en mogen niet interpreteren null als een specifieke leeftijdsgroep.
GetAgeVerificationStatusAsync
De GetAgeVerificationStatusAsync methode retourneert een UserAgeVerificationStatus waarde die de verificatiestatus voor volwassenen aangeeft die voor de gebruiker is gerapporteerd. Leeftijdsverificatie controleert of een gebruiker die claimt een volwassene te zijn een volwassene is. Er wordt geen leeftijd geverifieerd of andere leeftijdsgroepen geverifieerd.
Mogelijke waarden zijn:
-
Verified: De gebruiker is als volwassene geverifieerd. -
Unverified: De gebruiker heeft geen geverifieerde status voor volwassenen. Hiermee wordt niet vastgesteld dat de gebruiker minderjarig is. -
OptedOut: De gebruiker heeft zich afgemeld voor volwassenenverificatie. -
TemporarilyUnavailable: De status kan momenteel niet worden bepaald. -
NotApplicable: Verificatie is niet van toepassing, er is geen verificatiesignaal beschikbaar of de functie is niet beschikbaar of uitgeschakeld.
Apps moeten elke waarde verwerken.
NotApplicable en TemporarilyUnavailable stellen niet vast of de volwassenstatus van de gebruiker is geverifieerd. Een leeftijdsbereikresultaat van 18 of ouder bewijst op zichzelf niet dat de volwassenstatus is geverifieerd.
Autorisatie en toestemming van beller
Het app-pakket moet de userAccountInformation mogelijkheid declareren. Toegang tot leeftijdssignalen is ook onderhevig aan de toestemming van de gebruiker om de app toegang te geven tot accountgegevens in Windows privacy-instellingen. Als er geen toegang is verleend, kan de aanroep mislukken met E_ACCESSDENIED. Het User object moet de gebruiker vertegenwoordigen die het huidige proces uitvoert.
Beleid en beschikbaarheid
Wanneer de leeftijds-API's niet beschikbaar of uitgeschakeld zijn, GetUserAgeRangeAsync retourneert null en GetAgeVerificationStatusAsync retourneert NotApplicable. Beheerders kunnen ook een standaardleeftijdsgroep of verificatiestatus configureren via Groepsbeleid of MDM; wanneer deze is geconfigureerd, retourneren de API's de bijbehorende door beleid gedefinieerde waarde. Apps moeten controleren of de methoden beschikbaar zijn voordat ze worden aangeroepen en het terugvalgedrag behouden voor niet-beschikbare signalen.
Een door beleid gedefinieerde Verified waarde is een administratieve standaardwaarde, geen bewijs dat de gebruiker de verificatiestroom voor volwassenen heeft voltooid.
Leeftijdssignalen van id-providers worden momenteel alleen opgehaald voor Microsoft accounts. Voor andere accounttypen geldt dat wanneer er geen standaardinstelling voor beheerders is geconfigureerd, GetUserAgeRangeAsyncGetAgeVerificationStatusAsync retourneert en nullNotApplicable retourneert.
Wanneer leeftijdssignalen gebruiken
Gebruik leeftijdssignalen wanneer uw app:
- Geeft door de gebruiker gegenereerde inhoud, sociale functies of communicatiehulpmiddelen weer die mogelijk niet geschikt zijn voor alle leeftijden.
- Biedt aankopen in apps of virtuele valuta's waar leeftijdsbeperkingen relevant zijn.
- Streamt of speelt media-inhoud af met volwassenheidsclassificaties.
Hoe leeftijdssignalen op hoog niveau werken
Privacy en gegevensverwerking
Leeftijdssignalen zijn ontworpen met privacy als kernprincipe:
- Er wordt geen exacte leeftijd of geboortedatum geretourneerd. De API's retourneren een leeftijdsbucket en een verificatiestatus voor volwassenen. Verificatie voor volwassenen brengt geen geverifieerde leeftijd of geverifieerde leeftijdsgroep voor minderjarigen tot stand.
- Leeftijdsgroepen zijn algemeen. Ze geven gangbare leeftijdsgroepen aan voor verschillende toepassingen, zoals gaming of regionale wetgeving.
Platformvereisten
| Requirement | Details |
|---|---|
| Minimale versie van het besturingssysteem | Windows 11 |
| API-oppervlak | Windows Runtime-methoden voor Windows.System.User |
| Gebruikerscontext | Aanroepen zijn alleen van toepassing op de gebruiker die het huidige proces uitvoert. |
| App-mogelijkheid | Het app-pakket moet userAccountInformation declareren. |
Zie ook
Windows developer