Windows年龄 API 常见问题解答

本文解答了有关使用 Windows Age API 构建适合年龄的应用体验的常见问题。

Overview

什么是 Windows 年龄 API?

Windows年龄 API 为运行当前进程的用户提供隐私保留年龄信号。 Windows返回应用可用于提供适当年龄体验的年龄范围或成人验证状态,而不是返回确切的年龄或出生日期。

这些 API 是 Windows.System.User 上的 Windows 运行时 方法。 它们可帮助应用做出与年龄相关的体验和策略决策,而无需收到用户的确切出生日期。

如果用户同意,开发人员可以访问应用程序在设计适合相应年龄的体验时可以使用的年龄相关信号。 应用程序开发人员仍负责确定适用的法律和要求如何应用于其产品。

Windows Age API 适用于哪些方案?

当年龄与场景相关时,应用可以使用年龄信号。 例如,应用可能会在以下情况下使用年龄信号:

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

更通常,应用可以使用年龄信号来调整其内容、功能或访问控制,而无需收集出生日期。

哪些 Windows Age API 可用?

以下 API 支持不同的方案:

年龄验证是否验证用户的年龄或年龄组?

No. 年龄验证提供已验证成人身份,而不是任何年龄或年龄组的已验证状态。 对于基于帐户的验证,声称自己是成年人的用户必须通过一个流来检查该人是否为成年人。 该流程检查成人声明;它不会确定儿童或青少年经验证的年龄。

有关为 Microsoft 帐户验证年龄的信息,请参阅为 Microsoft 帐户验证你的年龄。

GetAgeVerificationStatusAsync报告成人验证状态。 Verified结果表示用户具有已验证的成人身份。 其他结果不能确定用户是未成年人:你的应用必须区分Unverified结果、OptedOut结果以及不可用或不确定的结果。

Windows 年龄 API 是否正式可用?

GetUserAgeRangeAsync 并且 GetAgeVerificationStatusAsync 已正式发布。 支持的零售Windows版本包括:

  • Windows 11版本 24H2:内部版本 26100.9550 或更高版本。
  • Windows 11版本 25H2:内部版本 26200.9550 或更高版本。

Windows SDK 版本 10.0.26100.9169 或更高版本包括这些 API。

我的应用应使用哪个 API?

使用:

  • 当你的应用需要年龄段并应用自己的体验或策略逻辑时,使用GetUserAgeRangeAsync。
  • GetAgeVerificationStatusAsync 当决策取决于用户是否已验证成人状态时。

应用可以在适合其场景时使用多个年龄信号。 18 岁或以上的年龄范围结果本身不能证明用户具有已验证的成人身份。

隐私和数据处理

是否可以为 GetUserAgeRangeAsync 配置自己的年龄范围?

No. 返回 GetUserAgeRangeAsync 的年龄组是预定义的。

API 是否返回用户的确切年龄或出生日期?

No. GetUserAgeRangeAsync 返回年龄组,而不是确切的年龄或出生日期。 例如,下限和上限为{13, 15}的结果表示用户属于 13–15 岁年龄组。

GetAgeVerificationStatusAsync 报告成人验证状态,而不是已验证的年龄或已验证的年龄组。

我的应用是否需要收集用户的出生日期才能使用 Windows Age APIs?

No. API 的一个用途是让应用做出与年龄相关的决策,而无需直接接收用户的出生日期。

应用应该存储年龄信号吗?

应用应避免不必要地持久化存储年龄信号。 在需要时检索信号,因为用户的年龄组、验证状态、帐户状态或适用的管理策略可能会更改。

用户和帐户行为

支持哪些帐户类型?

标识提供者年龄信号目前仅适用于Microsoft帐户。 对于其他帐户类型,如果未配置管理默认值,GetUserAgeRangeAsync 返回 null,GetAgeVerificationStatusAsync 返回 NotApplicable。

Age API 返回有关哪个用户的信息?

年龄 API 调用适用于运行当前进程的用户。 在具有多个 Windows 用户配置文件的设备上,API 会查询当前用户的配置文件,以用于当前活动应用的体验。 API 不提供查询其他用户配置文件的机制。

应用是否可以查询设备上的其他用户的年龄信号?

No. API 在运行进程的用户的上下文中运行。 使用代表其他用户的User对象调用年龄 API 可能导致E_ACCESSDENIED。

当用户在 Windows 中关联了多种帐户类型时,会发生什么情况?

Windows Age API 在当前登录Windows用户的上下文中运行,并使用与该用户Windows登录关联的Microsoft 帐户。 应用无法为该查询选择另一个已连接的账户。

如果无法确定年龄信号,该怎么办?

应用必须做好准备,以应对年龄信号不可用或不确定的情况。

对于 GetUserAgeRangeAsync, null 表示年龄范围未知或不可用。 可能产生 null 的情况包括:

  • 不支持该帐户类型。
  • 该帐户的年龄信息不可用。
  • 该 API 被管理策略禁用。

对于 GetAgeVerificationStatusAsync, NotApplicable 或 TemporarilyUnavailable 表示不可用或不确定的验证信号。 这些结果不能确定用户是否具有已验证的成人身份。

应用必须提供适当的回退体验,并且不能将不可用的结果解释为特定年龄组或验证状态。

应用是否应假定年龄信号始终可用?

No. 应用应在其 Age API 集成过程中设计回退行为。 将有效的信号、不可用或不确定的信号和拒绝访问的错误视为不同的状态。

应用要求和实现

需要哪些操作系统和 SDK?

Windows 11 是最低受支持的操作系统版本。 GetUserAgeRangeAsync 并且 GetAgeVerificationStatusAsync 可在以下受支持的零售内部版本中使用:

  • Windows 11版本 24H2:内部版本 26100.9550 或更高版本。
  • Windows 11版本 25H2:内部版本 26200.9550 或更高版本。

使用 Windows SDK 版本 10.0.26100.9169 或更高版本生成调用这些 API 的应用。

由于 API 在较旧的或未维护的系统上可能不存在,因此请在调用 API 之前检查 API 的可用性。

我的应用需要声明功能吗?

Yes. UWP 应用必须在其包清单中声明userAccountInformation功能:

<uap:Capability Name="userAccountInformation" />

如果没有所需的访问权限,应用将无法读取用户的年龄数据。

如何获取用于调用 Age API 的用户对象?

使用User.GetDefault获取运行当前进程的用户。 User.FindAllAsync 可以枚举用户,但必须使用表示运行该进程的用户的 User 实例来调用 Age API。

出生日期变更或生日更新后,需要多长时间才会影响年龄信号?

如果用户更改了与其 Microsoft 帐户 关联的出生日期,或到了生日时,则更改将在上次年龄信号提取后的 24 小时内反映。

应用是否可以强制刷新年龄信号?

No. 不支持强制刷新。

错误和回退处理

应用应如何处理不可用的年龄范围?

显式处理不可用的年龄范围,而不是假设年龄。 null结果GetUserAgeRangeAsync意味着年龄范围未知或不可用。

使用经过专门设计的回退体验。 请勿将 null 解释为特定年龄组,包括 18 岁或以上的组。

E_ACCESSDENIED意味着什么?

E_ACCESSDENIED可能表示调用者无权访问帐户信息,或应用使用代表其他用户而非运行该进程的用户的User对象调用了 API。

将此错误与表示信息不可用的信号区分开。 根据 API 的不同,不可用信号会返回为 null、NotApplicable 或 TemporarilyUnavailable。

应用应如何处理未知验证状态?

显式处理不可用或不确定的验证状态,并提供回退体验。 NotApplicable和TemporarilyUnavailable不能确定用户是否具有已验证的成人身份。 不要将这些结果、Unverified或OptedOut解释为用户是未成年人的证据。

另请参阅