将 k-ID 集成到应用程序中

📄️ 工作流程

以下流程图展示了 k-ID 引擎的工作流程。在流程中使用的 API 调用点已标记清楚。

📄️ 管理会话

k-ID的`Session包含当前玩家和位置的权限和年龄状态的集合。每个玩家都需要一个活动的Session。游戏应咨询活动的Session`以确定游戏中的功能是启用还是禁用。

📄️ 实施年龄保证

年龄保证被定义为证明用户年龄以用于各种目的的整体过程，包括访问游戏、应用程序或应用程序内的内容。根据司法管辖区和您希望验证年龄的功能的风险程度，可以应用不同的方法。全球合规引擎提供了一个由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。