Przegląd sygnałów związanych z wiekiem

Interfejsy API Windows Age zapewniają sygnały chroniące prywatność, których aplikacje mogą używać do określania grupy wiekowej i statusu weryfikacji pełnoletności zalogowanego użytkownika. Interfejsy API zwracają grubsze sygnały zamiast dokładnego wieku lub daty urodzenia użytkownika. Aplikacje mogą używać tych sygnałów do dostosowywania zawartości, funkcji lub kontroli dostępu i muszą zapewnić odpowiednie zachowanie rezerwowe, gdy sygnał jest niedostępny.

Co to są sygnały wieku?

Sygnały wieku to wartości zwracane przez system Windows, gdy aplikacja wywołuje interfejsy API klasyfikacji wiekowej dla bieżącego użytkownika. Aplikacja decyduje, kiedy poprosić użytkownika o grupę wiekową lub stan weryfikacji dla dorosłych, aby zapewnić odpowiednie środowisko użytkownika końcowego.

Żaden sygnał nie ujawnia bezpośrednio dokładnego wieku lub daty urodzenia użytkownika. Interfejs GetUserAgeRangeAsync API udostępnia zakres wiekowy, którego aplikacja może używać do podejmowania decyzji dotyczących zawartości. Oferuje ona następujące grupy wiekowe:

  • Poniżej 10
  • 10-12
  • 13-15
  • 16-17
  • 18+

interfejsy API wieku Windows

GetUserAgeRangeAsync

Metoda GetUserAgeRangeAsync zwraca zakres wiekowy użytkownika jako UserAgeRange obiekt z właściwościami Lower i Upper .

Grupa wiekowa Wartości zwracane
Poniżej 10 {0, 9}
10-12 {10, 12}
13-15 {13, 15}
16-17 {16, 17}
18+ {18, INT32_MAX}
Nieznane null

Gdy wynik to null, zakres wiekowy jest nieznany lub niedostępny. Aplikacje muszą korzystać z własnego trybu awaryjnego i nie mogą interpretować elementu null jako określonej grupy wiekowej.

GetAgeVerificationStatusAsync

Metoda GetAgeVerificationStatusAsync zwraca UserAgeVerificationStatus wartość wskazującą stan weryfikacji wieku zgłoszony dla użytkownika. Weryfikacja wieku sprawdza, czy użytkownik, który twierdzi, że jest dorosłym, jest dorosłym. Nie ustanawia zweryfikowanego wieku ani nie weryfikuje innych grup wiekowych.

Dopuszczalne wartości:

  • Verified: użytkownik zweryfikował status osoby dorosłej.
  • Unverified: Użytkownik nie ma zweryfikowanego statusu osoby dorosłej. Nie określa to, że użytkownik jest niepełnoletni.
  • OptedOut: Użytkownik zrezygnował z weryfikacji pełnoletności.
  • TemporarilyUnavailable: Nie można obecnie określić stanu.
  • NotApplicable: Weryfikacja nie ma zastosowania, nie jest dostępny sygnał weryfikacyjny lub funkcja jest niedostępna lub wyłączona.

Aplikacje muszą obsługiwać każdą wartość. NotApplicable i TemporarilyUnavailable nie ustalają, czy użytkownik zweryfikował status osoby dorosłej. Wynik z zakresu wiekowego 18 lat lub więcej sam w sobie nie potwierdza statusu zweryfikowanej osoby dorosłej.

Pakiet aplikacji musi deklarować funkcję userAccountInformation. Dostęp do sygnałów dotyczących wieku zależy również od zgody użytkownika na umożliwienie aplikacji dostępu do informacji o koncie w ustawieniach prywatności systemu Windows. Jeśli dostęp nie zostanie przyznany, wywołanie może zakończyć się niepowodzeniem z komunikatem E_ACCESSDENIED. Obiekt User musi reprezentować użytkownika uruchamiającego bieżący proces.

Zasady i dostępność

Gdy interfejsy API wieku są niedostępne lub wyłączone, GetUserAgeRangeAsync zwraca wartość GetAgeVerificationStatusAsync, a NotApplicable zwraca wartość null. Administratorzy mogą również skonfigurować domyślną grupę wiekową lub stan weryfikacji za pomocą zasad grupy lub zarządzania urządzeniami przenośnymi; po skonfigurowaniu interfejsy API zwracają odpowiednią wartość zdefiniowaną przez zasady. Aplikacje muszą sprawdzić, czy metody są dostępne przed ich wywołaniem i zachować zachowanie rezerwowe dla niedostępnych sygnałów.

Wartość zdefiniowana przez zasady Verified jest administracyjną wartością domyślną, a nie dowodem na to, że użytkownik ukończył przepływ weryfikacji dla dorosłych.

Sygnały dotyczące wieku od dostawcy tożsamości są obecnie pobierane tylko dla kont Microsoft. W przypadku innych typów kont, jeśli nie skonfigurowano domyślnej wartości administracyjnej, GetUserAgeRangeAsync zwraca GetAgeVerificationStatusAsync, a NotApplicable zwraca null.

Kiedy używać sygnałów wieku

Użyj sygnałów wieku, gdy aplikacja:

  • Wyświetla zawartość wygenerowaną przez użytkownika, funkcje społecznościowe lub narzędzia komunikacyjne, które mogą nie być odpowiednie dla wszystkich grup wiekowych.
  • Oferuje zakupy w aplikacji lub waluty wirtualne, w których obowiązują ograniczenia wieku.
  • Przesyła lub odtwarza treści multimedialne z klasyfikacją wiekową.

Jak działają sygnały wieku na wysokim poziomie

Diagram przedstawiający aplikację wymieniającą informacje o grupie wiekowej z lokalną usługą interfejsu API bezpieczeństwa cyfrowego, która komunikuje się z ustawieniami konfiguracji.

Ochrona prywatności i obsługa danych

Sygnały dotyczące wieku zostały zaprojektowane z myślą o ochronie prywatności jako naczelnej zasadzie:

  • Nie jest zwracany dokładny wiek ani data urodzenia. Interfejsy API zwracają przedział wiekowy i status weryfikacji pełnoletności. Weryfikacja dla dorosłych nie potwierdza zweryfikowanego wieku ani zweryfikowanej grupy wiekowej nieletnich.
  • Grupy wiekowe są ogólne. Określają typowe kategorie wiekowe dla różnych zastosowań, takich jak gry lub przepisy regionalne.

Wymagania dotyczące platformy

Wymaganie Szczegóły
Minimalna wersja systemu operacyjnego Windows 11
Powierzchnia interfejsu API Metody środowisko wykonawcze systemu Windows w elemencie Windows.System.User
Kontekst użytkownika Wywołania dotyczą tylko użytkownika uruchamiającego bieżący proces.
Możliwość aplikacji Pakiet aplikacji musi zadeklarować userAccountInformation

Zobacz także

  • Ostatnia aktualizacja o