📄️ 工作流程
以下流程图展示了 k-ID 引擎的工作流程。在流程中使用的 API 调用点已标记清楚。
📄️ 管理会话
k-ID的`Session包含当前玩家和位置的权限和年龄状态的集合。每个玩家都需要一个活动的Session。游戏应咨询活动的Session`以确定游戏中的功能是启用 还是禁用。
📄️ 获取玩家的年龄
收集年龄的司法要求
📄️ 通过年龄验证确保年龄
k-ID 支持通过扫描政府签发的证件来验证用户年龄。这需要使用 /age-verification/perform-id-verification API。
📄️ Implementing Age Assurance
Age Verification currently includes following APIs
📄️ 检查年龄
如果需要显示年龄门，则现在必须调用 /age-gate/check API 来确定工作流程的下一步。如果玩家的年龄低于厂商门户中为游戏配置的最低年龄，返回的 status 字段将为 PROHIBITED。此时，应阻止玩家继续游戏。如果玩家提供了一个需要在当前位置获得可验证家长同意的出生日期，则 status 字段的值为 CHALLENGE，并在名为 challengeID 的字段中返回新的同意挑战的 ID。游戏必须要求玩家寻求家长同意。最后，如果 status 值为 PASS，则玩家可以继续进入游戏。
📄️ 请求家长同意
如果 /age-gate/check 的 status 字段返回值为 CHALLENGE，响应中的 challengeId 字段将包含 k-ID 引擎中的 Consent Challenge（同意挑战）ID。此时应显示一个窗口，允许玩家请求家长同意。
📄️ Webhooks
Webhook 是一种可以在事件发生时订阅 k-ID 引擎事件的机制，而无需轮询 API 来检查数据是否可用。
📄️ 使用会话权限
当用户通过年龄门检查后，无论是因为他们符合继续游戏的年龄，还是因为家长已授予同意，游戏都可以检索当前玩家的特定司法管辖区权限。这可以通过以下两种方式完成：在 /age-gate/check 调用的结果中，当 status 字段为 PASS 时，或者如果会话已创建并被缓存，调用 /session/get。
📄️ Account System Integration
Some studios have a common Account system that spans across multiple games. It is often desirable in these situations to integrate an age gate and to handle Verifiable Parental Consent (VPC) directly in the Account creation flow so that players are asked for their age only once for all games from the same publisher.
📄️ Multi-Product Approval
k-ID supports the ability to present multiple products for parents to approve at the same time in the consent workflow, reducing friction in the approval process so that kids can more easily experience multiple games or apps from the same publisher.
📄️ 为新权限请求同意
当玩家已经获得会话权限后，他们可能希望启用其他权限。权限可能被禁用的原因包括：