Přehled věkových signálů

Rozhraní API Windows Age poskytují signály pro zachování ochrany osobních údajů, které můžou aplikace používat k pochopení věkové skupiny a stavu ověření pro dospělé přihlášeného uživatele. Rozhraní API vracejí pouze obecné údaje namísto přesného věku uživatele nebo jeho data narození. Aplikace můžou tyto signály používat k přizpůsobení obsahu, funkcí nebo řízení přístupu a musí poskytovat vhodné náhradní chování, pokud signál není k dispozici.

Co jsou věkové signály?

Věkové signály jsou hodnoty, které Windows vrací, když aplikace volá rozhraní AGE API pro aktuálního uživatele. Aplikace se rozhodne, kdy požádat o věkovou skupinu uživatele nebo stav ověření dospělosti, aby určila odpovídající uživatelské prostředí.

Žádný signál přímo nezpřístupňuje přesný věk nebo datum narození uživatele. Rozhraní GetUserAgeRangeAsync API poskytuje věkový rozsah, který může aplikace použít k rozhodování o obsahu. Nabízí následující věkové skupiny:

  • Méně než 10
  • 10-12
  • 13-15
  • 16-17
  • 18+

rozhraní API pro Windows Age

GetUserAgeRangeAsync

Metoda GetUserAgeRangeAsync vrátí věkový rozsah uživatele jako UserAgeRange objekt s vlastnostmiLower.Upper

Věková skupina Návratové hodnoty
Méně než 10 {0, 9}
10-12 {10, 12}
13-15 {13, 15}
16-17 {16, 17}
18+ {18, INT32_MAX}
Neznámý null

Pokud je výsledkem null, je věkový rozsah neznámý nebo nedostupný. Aplikace musí používat svou záložní variantu a nesmí považovat null za konkrétní věkovou skupinu.

GetAgeVerificationStatusAsync

Metoda GetAgeVerificationStatusAsync vrátí hodnotu UserAgeVerificationStatus, která označuje stav ověření plnoletosti nahlášený pro uživatele. Ověření věku kontroluje, jestli je uživatel, který tvrdí, že je dospělým, skutečně dospělý. Nestanoví ověřený věk ani neověří jiné věkové skupiny.

Možné hodnoty jsou:

  • Verified: U uživatele byla ověřena plnoletost.
  • Unverified: Uživatel nemá ověřenou plnoletost. Tím se nezjistí, že uživatel je nezletilý.
  • OptedOut: Uživatel odmítl ověření dospělosti.
  • TemporarilyUnavailable: Stav nelze nyní určit.
  • NotApplicable: Ověření se nepoužije, není k dispozici žádný ověřovací signál nebo je funkce nedostupná nebo zakázaná.

Aplikace musí zpracovávat každou hodnotu. NotApplicable a TemporarilyUnavailable neurčují, jestli má uživatel ověřený stav dospělého. Výsledek odhadu věku 18 let nebo více sám o sobě nepotvrzuje ověřený status dospělého.

Balíček aplikace musí deklarovat userAccountInformation schopnost. Přístup k věkovým signálům podléhá také souhlasu uživatele, který umožní přístup k informacím účtu aplikace v nastavení ochrany osobních údajů Windows. Pokud přístup není udělen, volání může selhat s E_ACCESSDENIED. Objekt User musí představovat uživatele, který spouští aktuální proces.

Zásady a dostupnost

Pokud jsou rozhraní AGE API nedostupná nebo zakázaná, GetUserAgeRangeAsync vrátí null a GetAgeVerificationStatusAsync vrátí hodnotu NotApplicable. Správci mohou také nakonfigurovat výchozí věkovou skupinu nebo stav ověření prostřednictvím zásad skupiny nebo MDM; po nakonfigurování vrátí rozhraní API odpovídající hodnotu definovanou zásadou. Aplikace musí před voláním zkontrolovat, jestli jsou metody dostupné, a zachovat záložní chování pro nedostupné signály.

Hodnota definovaná zásadou Verified je administrativní výchozí hodnota, nikoli důkaz, že uživatel dokončil tok ověření pro dospělé.

Údaje o věku od poskytovatele identity jsou v současné době získávány pouze pro účty Microsoft. U jiných typů účtů, pokud není nakonfigurované žádné výchozí nastavení pro správu, GetUserAgeRangeAsync vrátí null a GetAgeVerificationStatusAsync vrátí .NotApplicable

Kdy používat věkové signály

Při aplikaci používejte věkové signály:

  • Zobrazí uživatelem generovaný obsah, sociální funkce nebo komunikační nástroje, které nemusí být vhodné pro všechny věkové kategorie.
  • Nabízí nákupy v aplikaci nebo virtuální měny, kde jsou relevantní věková omezení.
  • Streamuje nebo přehrává multimediální obsah s věkovým hodnocením.

Jak fungují věkové signály na vysoké úrovni

Diagram znázorňující aplikaci, která vyměňuje informace o věkové skupině s místní službou rozhraní API pro digitální bezpečnost, která komunikuje s nastavením konfigurace

Ochrana osobních údajů a zpracování dat

Věkové signály jsou navrženy s ochranou osobních údajů jako základním principem:

  • Nevrátí se přesný věk ani datum narození. Rozhraní API vrací věkovou kategorii a stav ověření dospělosti. Ověření dospělosti nestanoví ověřený věk ani ověřenou věkovou skupinu nezletilé osoby.
  • Věkové skupiny jsou obecné. Komunikují s běžnými věkovými skupinami pro různé případy použití, jako je hraní her nebo regionální právo.

Požadavky na platformu

Požadavek Podrobnosti
Minimální verze operačního systému Windows 11
Plocha rozhraní API prostředí Windows Runtime metody zapnutéWindows.System.User
Kontext uživatele Volání platí jenom pro uživatele, který spouští aktuální proces.
Funkce aplikace Balíček aplikace musí deklarovat userAccountInformation

Viz také

  • Poslední aktualizace v