使用面部年龄估算确保年龄

k-ID 支持通过面部年龄估算来评估用户年龄。这需要使用 /age-assurance/create-verification-request API。

为了进行面部年龄估算，需要在网页中显示一个 iframe，该 iframe 使用 /age-assurance/create-verification-request 响应中的 url 属性返回的 URL。此界面完全在设备上的浏览器中运行。用户界面可以托管在由游戏控制的自定义网页中，并显示在游戏内的 Web View 或单独的浏览器窗口中。当用户完成验证步骤后，k-ID 厂商门户中指定的 Webhook 端点将被触发，生成一个类型为 AgeAssurance.Result 的事件，该事件包含年龄估算的结果。事件负载的架构记录在此处。

自定义说明

k-ID 面部年龄估算默认会显示本地化的用户说明，但可以使用 disableInstructions 参数禁用该功能，以更全面地控制用户体验。

使用年龄阈值

面部年龄估算可以检查玩家是否超过某个通过 age 参数传递的年龄。如果省略 age 参数，将检查当前司法管辖区的数字同意年龄，或在 k-ID 厂商门户中配置的最低游戏年龄。当为接受玩家声明的年龄的年龄门实现年龄验证时，可以将 age 参数指定为玩家提供的年龄。

接收结果

年龄验证结果将传递给任何已注册的 Webhook。结果会指示验证成功或失败，还会包括 minAge、maxAge 和 confidence。关于面部年龄估算的这些附加信息可以帮助游戏更好地理解用户是否接近正确年龄以及估算的可信度。事件负载的架构记录在此处。

测试年龄估算

在编写调用 k-ID API 的代码之前，您可以使用 API 密钥和 API 文档亲自尝试面部年龄估算。

首先，按照步骤进行简单的 k-ID API 调用。

然后，在同一浏览器窗口中调用 /age-assurance/create-verification-request。为此，在列表中点击该 API。

然后点击 Try it out 按钮，再点击 Execute 按钮。

响应中的 url 参数包含将在您的应用程序或单独的浏览器窗口中使用的 iframe 的 URL。将此 URL 复制到您的浏览器中，URL 类似于：

https://d3ogqhtsivkon3.cloudfront.net?token=eyJhbGciOiJFUzM4NCIsImtpZCI6IjEiLCJ0eXAiOiJKV1QifQ.eyJpc3MiOiJodHRwczovL2FwaS5rLWlkLmNvbSIsImF1ZCI6WyJodHRwczovL2FwaS5wcml2YXRlbHkuc3dpc3MiXSwiZXhwIjoxNzI3Mjg1MTQzLCJuYmYiOjE3MjcyODE1NDMsImlhdCI6MTcyNzI4MTU0MywianRpIjoiZmYzNmVjYmItMGRiMC00MzU4LWJlOTktODk3N2JjOTI3NGM4IiwiYWdlIjoxMywiY2ZkIjowLjksImxpdiI6dHJ1ZSwicnRmIjoiaW50ZXJ2YWwiLCJydGIiOiJjYWxsYmFjayIsInJkciI6Imh0dHBzOi8vZ2FtZS1hcGkuay1pZC5jb20vYXBpL3YxL3ByaXZhdGUvd2ViaG9va3MvcHJpdmF0ZWx5LXdlYmhvb2siLCJzaGkiOnRydWV9.AicwoDvpPKwbAAS-UnblxI5esdAJd5Wgvg-GneLShVLsq_mcwesYN-C0KAME10kHgSiUJYXEzmt0Cxp4zcIKslW7mJrykFrhMXjawWotW_oKWV5fnv5XvRLz0Egls_1V

然后您将看到说明页面：

点击 Start 按钮亲自尝试面部年龄估算。请注意，为确保安全，系统需要执行活体检测。扫描结果不会在此视图中以可视化方式显示，因为它以 JavaScript 事件和 Webhook 调用的形式发送。演示中不会有任何摄像头信息离开您的设备。