跳到主要内容

使用面部年龄估算进行年龄验证

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

为了进行面部年龄估算,需要在网页中显示一个 iframe,使用从 /age-assurance/create-verification-request 响应的 url 属性返回的 URL。这将显示基于 Web 的面部年龄估算用户界面,该界面完全在设备的网络浏览器上运行。这意味着用户体验可以托管在游戏控制的自定义网页中,并在游戏中的 Web View 或单独的浏览器窗口中显示。当用户完成验证步骤后,k-ID 发布者门户中指定的 Webhook 将被调用,事件类型为 AdultVerification.Result,其中包含验证结果。

使用年龄门槛

面部年龄估算可以检查玩家是否超过传递到 age 参数的某个特定年龄,如果省略该参数,将检查该司法管辖区的数字同意年龄,或在 k-ID 发布者门户中配置的游戏最低游玩年龄。当为接受自报年龄的年龄门槛实施年龄验证时,可以将 age 参数指定为玩家提供的年龄。

自定义说明

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

接收结果

年龄验证结果将传递到任何已注册的 Webhook。当收到结果时,它将指示成功或失败,并包括 minAgemaxAgeconfidence。这些关于面部年龄估算的额外信息使游戏能够更好地了解用户与正确年龄的接近程度,以及估算的可信度。

测试年龄估算

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

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

然后,使用相同的浏览器窗口,调用 /age-assurance/create-verification-request。为此,请单击列表中的该 API。

API Call

然后单击 Try it out 按钮,然后单击 Execute 按钮。

Result

响应中 url 参数包含了将在您的应用程序或单独的浏览器窗口中使用的 iframe URL。将此 URL 复制到浏览器中。在此示例中,URL 为:

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

然后您将看到说明页面:

FAE instructions

单击 Start 按钮,尝试对自己进行面部年龄估算。请注意为安全性所要求的活体检测。在此视图中不会以视觉方式显示扫描结果,因为它是作为 JavaScript 事件和 Webhook 调用发送的。在此演示中,您的设备不会传输任何摄像头信息。