数字安全年龄信号概述

Windows年龄 API 为应用提供了一种隐私保留机制，用于确定已登录用户的年龄组和年龄验证状态。 这些 API 专为需要遵守儿童安全法规的应用而设计，无需应用收集、存储或处理出生日期或其他个人身份信息。 应用使用这些信号根据用户的年龄和已验证状态来调整内容、功能或访问控制，而无需实施自己的年龄验证系统。

什么是年龄信号？

年龄信号是当用户采取措施访问与年龄相关的内容或受限内容时，Windows提供给应用程序的值。 调用方应用程序发出访问用户的年龄组和/或年龄验证状态的请求，以通知相应的最终用户体验。

年龄信号 不会 直接公开用户的年龄或出生日期。 相反，它会提供一个年龄范围，供应用程序据此做出内容决策。 GetUserAgeRangeAsync API 提供以下年龄组：

• 低于 10
• 10-12
• 13-15
• 16-17
• 18+

数字安全 API

Note

这些 API 在正式可用之前就已有文档说明。 它们尚未在运行时启用，并计划在今年晚些时候的未来版本中启用。 在此之前，调用会返回未知的年龄范围（null），并且验证状态不可用，因此请确保您的应用会退回到其默认行为或年龄限制机制。

GetUserAgeRangeAsync

以具有Upper和UserAgeRange属性的Lower对象形式返回用户的年龄范围。

年龄组	返回值
低于 10	{0, 9}
10-12	{10, 12}
13-15	{13, 15}
16-17	{16,17}
18+	{18， INT32_MAX}
未知	null

当结果为 null 时，应用应回退到默认行为或年龄验证机制。

GetAgeVerificationStatusAsync

返回用户的年龄验证状态，以指示用户年龄是否已由标识提供者独立验证。 此 API 可用于 1P 和 3P 调用方。 可能的输出包括：

• Verified
• Unverified
• 已选择退出
• 暂时不可用
• 不适用

呼叫方标识

数字安全平台在返回信号值之前验证调用应用的标识。 这可以防止未经授权的应用查询另一个应用的安全设置。 应用必须正确注册并识别，才能接收有意义的信号数据。

何时使用年龄信号

在您的应用符合以下情况时，请使用年龄信号：

• 显示可能不适合所有年龄的用户生成内容、社交功能或通信工具。
• 提供存在年龄限制的应用内购买或虚拟货币。
• 流式传输或播放具有成熟度分级的媒体内容。

年龄信号的高层工作原理

隐私和数据处理

年龄信号的设计以隐私为核心原则：

• 不会公开任何个人数据。 API 不返回用户的年龄、出生日期或家庭关系详细信息。
• 年龄组是通用的。 它们表示了适用于各种场景（如游戏或地区法律）的常见年龄分组。

平台要求

要求	详细信息
最低操作系统版本	Windows 11
API 图面	Win32 COM （C/C++）
用户上下文	必须在已登录 Microsoft 帐户的用户会话中运行
应用注册	必须使用数字安全平台建立应用标识

另见

• Microsoft Family Safety
• Windows应用的安全和标识开发