4 篇博文 含有标签「age-gate」

/age-gate/check 现在接受一个重定向 URL，k-ID 会在自动年龄保证挑战完成后跳转到该地址。此功能适用于无法使用基于 iframe 的结果处理程序的顶层浏览器切换场景（例如跳转到 k-ID 再返回的移动 webview）。

新功能​

• options.playerAgeAssurance.redirectUrl。 在 /age-gate/check 上传入 http(s) URL 或自定义方案的移动深层链接（例如 myapp://age-gate/return）。当玩家完成或关闭 CHALLENGE_AGE_GATE_AGE_ASSURANCE 流程后，k-ID 会重定向到该 URL，并将 challengeId、productId、sessionId（PASS 时）和 status（PASS 或 FAIL）作为查询参数附加。URL 上现有的查询参数会被保留。
• 范围。 该选项仅对 CHALLENGE_AGE_GATE_AGE_ASSURANCE 生效。CHALLENGE_PARENTAL_CONSENT 不受影响，仍通过可信成人流程返回。
• 在服务器端确认结果。 重定向查询参数只是 UX 提示。在授予访问权限之前，请将 Challenge.StateChange webhook 或 /challenge/get-status 作为可信来源。

文档​

• 年龄门控 → 挑战后重定向
• /age-gate/check API 参考
• Challenge.StateChange webhook

我们已发布 平台年龄信号 的端到端文档，说明 Apple iOS、Google Play、Xbox、Meta Horizon 与 k-ID 的年龄数据如何进入 k-ID、何时可以跳过年龄门，以及 已验证 与 未验证 信号如何影响高风险权限与年龄保障流程。

新功能​

CDK — 平台年龄信号​

• 平台年龄信号 — 快速集成路径、API 地图、推荐请求顺序、POST /age-gate/check 如何使用平台信号、支持的平台与 已验证声明类型，以及已验证与未验证信号的行为说明。
• 平台信号详情 — 各平台的字段形态、如何获取各原生信号、按接口的说明（get-requirements、check、get-default-permissions、session/get、get-platform-age-range、session/upgrade）、校验、年龄冲突以及 k-id 信号规则。

概念与相关文档​

• 年龄信号 — 平台年龄信号与其他信号类型的关系，以及 PlatformAgeSignal 集成细节的查阅入口。
• 高风险功能的年龄保障 与 权限 — 关于 verifiedAgeThreshold 与在年龄门通过已验证平台信号满足条件的交叉引用说明。

API 参考（OpenAPI）​

会话升级、AgeVerification 与 platformAgeSignal 的描述已与上文文档统一为 已验证平台信号 的表述。

文档​

• 平台年龄信号
• 平台信号详情
• 年龄信号
• 高风险功能的年龄保障
• 权限

我们已补充 附加法律链接（Developer Details）及 Check age gate API 的 options 参数说明，便于在同意流程中展示平台相关法律文档（如 Xbox、PlayStation、Steam）。

新功能​

附加法律链接（Developer Details）​

在 Compliance Studio 的产品 Developer Details 标签页中，可添加在同意流程中显示的可选 附加法律链接：

• 标题与链接：本地化显示标题与 URL（与主法律文档相同的语言选项）。
• 变体 ID：调用 Check age gate API 时使用的标识符（如 xbox-tos、playstation-privacy-policy）。当始终显示为关时必填。
• 始终显示：开（默认）时，该链接在同意流程中始终显示。关时，仅当您的游戏在 options 中传入对应变体 ID 调用年龄验证 API 时才显示。

当游戏在多个平台分发且各平台需使用不同法律文档 URL 时可使用此功能。

Check age gate API — options 参数​

POST /api/v1/age-gate/check 的请求体现支持可选的 options 对象：

• termsOfServiceDocument：服务条款变体 ID（须与已配置的附加法律链接一致）。
• privacyPolicyDocument：隐私政策变体 ID（须与已配置的附加法律链接一致）。
• additionalLegalLinks：与服务条款和隐私政策一起显示的附加法律文档变体 ID 数组（每个须与已配置的附加法律链接一致）。

当创建挑战时，同意界面将显示所请求的法律链接，而非产品默认的 Privacy Policy 与 Terms of Service。

文档​

• Developer Details — 基本信息（含附加法律链接）
• Check age gate（请求体与 CheckAgeGateRequestOptions）

我们已为 Age Gate Widget 端点添加了 redirectUrl 作为可选参数。

新功能​

Age Gate Widget API 更新​

/widget/generate-age-gate-url 端点现在支持在 options 对象中使用可选的 redirectUrl 参数。这允许您指定在 Age Gate Widget 完成后重定向到的 URL，类似于端到端 Widget 端点。

redirectUrl 参数支持 HTTP/HTTPS URL 或具有自定义协议方案的移动端深度链接。

更新的 API​

• /widget/generate-age-gate-url