跳到主要内容

4 篇博文 含有标签「cdk」

查看所有标签

现已支持 Google Play Age Signals v0.0.4 `ageRangeSource`

对于 google-play 平台年龄信号，k-ID 现在接受 Google Play Age Signals v0.0.4 的 ageRangeSource 值作为 declarationType。

新功能​

  • google-play 信号上的 ageRangeSource。 Google Play Age Signals v0.0.4 已将 userStatus 替换为 ageRangeSource。调用年龄门控和会话端点时，请将 Google Play age signals responses 中的 ageRangeSource 值作为 PlatformAgeSignal 的 declarationType 提供。
  • 已弃用的 userStatus 值仍然有效。 为保持向后兼容，k-ID 会继续接受使用旧版架构的商店的旧版 userStatus 值，因此来自尚未迁移的应用的信号不受影响。

文档​

现已支持 Apple iOS "confirmed" 年龄信号

对于 iOS 26.5 及更高版本的玩家，k-ID 现在接受 Apple 的 confirmed 声明类型作为已验证的平台年龄信号。

新功能​

  • confirmed 是已验证的 Apple 声明类型。 从 iOS 26.5 开始，Apple 的 Age Range Service 仅返回 selfDeclared、guardianDeclared 或 confirmed，其中 confirmed 表示年龄范围是通过信用卡或政府颁发的身份证件等经过审核的方式设置的。k-ID 将 confirmed 视为已验证，因此可以抑制年龄门控、满足验证阈值并记录 ageVerification。
  • 已弃用的类型仍然有效。 Apple 弃用了 paymentChecked、governmentIDChecked、guardianPaymentChecked 和 guardianGovernmentIDChecked。为保持向后兼容，k-ID 会继续接受这些类型，因此来自早期 iOS 版本的信号不受影响。
  • selfDeclared 和 guardianDeclared 仍为未验证。 它们不能绕过年龄验证要求。

文档​

小部件与年龄验证的移动集成指南

我们更新了文档，以阐明 k-ID 在移动端的最佳集成方式：对于年龄门控和同意步骤，原生构建的 UX 能为玩家提供最无缝的体验；而年龄验证和年龄保证 URL 等 Web 嵌入则通过系统浏览器组件显示。

新功能​

年龄门控和端到端小部件的移动端指南​

年龄门控和端到端小部件在移动端受到完全支持。对于年龄门控和同意步骤，我们鼓励使用自定义工作流原生构建 UX 并遵循 CDK UX 指南，以获得最贴合品牌的体验。

k-ID API 返回的年龄验证和年龄保证 URL 采用相同的方式显示。有关具体端点和挑战类型，请参阅移动应用指南。

重新编写的移动应用指南​

移动应用指南已重新以年龄验证为中心，这是移动端最常见的 Web 嵌入：

默认浏览器方法​

在移动端实现方法下，我们记录了默认外部浏览器方法。它在 Android（Intent.ACTION_VIEW）和 iOS（UIApplication.open）上均可使用，完全支持 AgeKeys，并通过 redirectUrl 回调将焦点返回到您的应用。

设备方向指南​

年龄验证在竖屏方向下效果最佳。由于应用内浏览器界面会继承您应用的方向锁定，锁定横屏方向的应用应在默认外部浏览器中打开验证 URL。浏览器管理自己的方向，因此用户可以旋转到竖屏，并且当流程完成时 redirectUrl 回调会将他们返回到您的应用。

文档更新​

后续步骤​

  • 如果您在移动端集成，可以考虑使用自定义工作流和 CDK UX 指南原生构建您的年龄门控和同意 UX，以获得最无缝的体验
  • 在显示验证 URL 时，对锁定横屏的应用使用默认浏览器方法

平台年龄信号文档

我们已发布 平台年龄信号 的端到端文档，说明 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 的描述已与上文文档统一为 已验证平台信号 的表述。

文档​