Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
API Windows Age предоставляют сигналы, сохраняющие конфиденциальность, которые приложения могут использовать для определения возрастной группы вошедшего в систему пользователя и статуса проверки его совершеннолетия. API возвращают грубые сигналы вместо точного возраста или даты рождения пользователя. Приложения могут использовать эти сигналы для адаптации содержимого, функций или элементов управления доступом и обеспечить соответствующее резервное поведение, если сигнал недоступен.
Что такое сигналы возраста?
Возрастные сигналы — это значения, которые Windows возвращает при вызове приложением API Age для текущего пользователя. Приложение решает, когда запрашивать возрастную группу пользователя или статус проверки совершеннолетия, чтобы определить подходящий пользовательский опыт.
Ни один сигнал напрямую не раскрывает точный возраст пользователя или дату его рождения.
GetUserAgeRangeAsync API предоставляет диапазон возрастов, который приложение может использовать для принятия решений о содержимом. Он предлагает следующие возрастные группы:
- До 10
- 10-12
- 13-15
- 16-17
- 18+
API возраста Windows
GetUserAgeRangeAsync
Метод GetUserAgeRangeAsync возвращает диапазон возрастов пользователя в виде UserAgeRange объекта и LowerUpper свойств.
| Возрастная группа | Возвращаемые значения |
|---|---|
| До 10 | {0, 9} |
| 10-12 | {10, 12} |
| 13-15 | {13, 15} |
| 16-17 | {16, 17} |
| 18+ | {18, INT32_MAX} |
| Неизвестный | null |
Когда результат — null, возрастной диапазон неизвестен или недоступен. Приложения должны использовать свой запасной вариант и не должны интерпретировать null как указание на конкретную возрастную группу.
GetAgeVerificationStatusAsync
Метод GetAgeVerificationStatusAsync возвращает значение UserAgeVerificationStatus, указывающее статус проверки совершеннолетия, сообщаемый для пользователя. Проверка возраста проверяет, является ли пользователь, который утверждает, что он взрослый, действительно взрослым. Он не устанавливает подтвержденный возраст и не подтверждает другие возрастные группы.
Возможны следующие значения:
-
Verified: пользователь подтвердил совершеннолетие. -
Unverified: у пользователя нет подтверждённого статуса совершеннолетнего. Это не устанавливает, что пользователь является несовершеннолетним. -
OptedOut: пользователь отказался от подтверждения совершеннолетия. -
TemporarilyUnavailable: состояние в настоящее время не может быть определено. -
NotApplicable: проверка не применяется, сигнал проверки недоступен или отключен.
Приложения должны обрабатывать каждое значение.
NotApplicable и TemporarilyUnavailable не устанавливают, имеет ли пользователь проверенный статус взрослого. Результат возрастного диапазона 18 лет и старше сам по себе не подтверждает подтверждённый статус совершеннолетнего.
Авторизация вызывающего абонента и согласие
Пакет приложения должен объявить возможность userAccountInformation. Доступ к сигналам о возрасте также зависит от согласия пользователя на предоставление приложению доступа к сведениям учетной записи в параметрах конфиденциальности Windows. Если доступ не предоставлен, вызов может завершиться ошибкой E_ACCESSDENIED. Объект User должен представлять пользователя, от имени которого выполняется текущий процесс.
Политика и доступность
Если API определения возраста недоступны или отключены, GetUserAgeRangeAsync возвращает null, а GetAgeVerificationStatusAsync возвращает NotApplicable. Администраторы также могут настроить возрастную группу по умолчанию или состояние проверки с помощью групповой политики или MDM; При настройке API возвращают соответствующее значение, определенное политикой. Приложения должны проверить, доступны ли методы перед вызовом и сохранить резервное поведение для недоступных сигналов.
Определяемое политикой значение Verified является административным значением по умолчанию, а не свидетельством того, что пользователь завершил процедуру подтверждения совершеннолетия.
В настоящее время сигналы о возрасте от поставщика удостоверений получаются только для учетных записей Microsoft. Для других типов учетных записей, если административное значение по умолчанию не задано, GetUserAgeRangeAsync возвращает null, а GetAgeVerificationStatusAsync возвращает NotApplicable.
Когда следует использовать сигналы возраста
Используйте возрастные сигналы, если ваше приложение:
- Отображает созданное пользователем содержимое, социальные функции или средства коммуникации, которые могут быть не подходящими для всех возрастов.
- Содержит встроенные покупки или виртуальную валюту, для которых действуют возрастные ограничения.
- Выполняет потоковое или обычное воспроизведение медиаконтента с возрастными ограничениями.
Как работают возрастные сигналы в общих чертах
Конфиденциальность и обработка данных
Сигналы возраста разработаны с конфиденциальностью в качестве основного принципа:
- Не возвращается точный возраст или дата рождения. API возвращают возрастную категорию и статус проверки совершеннолетия. Проверка взрослого человека не устанавливает подтвержденный возраст или подтвержденную возрастную группу несовершеннолетнего.
- Возрастные группы являются универсальными. Они указывают стандартные возрастные группы для различных сценариев использования, например для игр или в соответствии с региональным законодательством.
Требования к платформе
| Требование | Сведения |
|---|---|
| Минимальная версия ОС | Windows 11 |
| Поверхность API | Методы среда выполнения Windows для Windows.System.User |
| Контекст пользователя | Вызовы применяются только к пользователю, выполняющего текущий процесс. |
| Возможности приложения | Пакет приложения должен содержать объявление userAccountInformation |
См. также
Windows developer