📄️ 工作流程
以下流程图展示了 k-ID 引擎的工作流程。在流程中使用的 API 调用点已标记清楚。
📄️ 管理会话
k-ID的`Session包含当前玩家和位置的权限和年龄状态的集合。每个玩家都需要一个活动的Session。游戏应咨询活动的Session`以确定游戏中的功能是启用还是禁用。
📄️ 获取玩家的年龄
收集年龄的司法要求
📄️ 使用面 部年龄估算确保年龄
k-ID 支持通过面部年龄估算来评估用户年龄。这需要使用 /age-assurance/create-verification-request API。
📄️ 通过年龄验证确保年龄
k-ID 支持通过扫描政府签发的证件来验证用户年龄。这需要使用 /age-verification/perform-id-verification API。
📄️ 检查年龄
如果需要显示年龄门,则现在必须调用 /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。
📄️ 为新权限请求同意
当玩家已经获得会话权限后,他们可能希望启用其他权限。权限可能被禁用的原因包括: