メインコンテンツに移動

顔年齢推定による年齢確認

k-IDは、顔年齢推定を使用してユーザーの年齢を推定する機能をサポートしています。これには、/age-assurance/create-verification-request API の使用が必要です。

顔年齢推定を実行するには、/age-assurance/create-verification-request のレスポンスから返された url プロパティを使用して、iframe をウェブページに表示する必要があります。これにより、デバイス上で完全に実行される、ウェブブラウザ内での顔年齢推定のユーザー体験が表示されます。つまり、ユーザー体験はゲームが制御するカスタムウェブページにホストされ、ゲーム内のWebビューで表示するか、別のブラウザウィンドウで表示することが可能です。ユーザーが確認ステップを完了すると、k-IDパブリッシャーポータルに指定されたWebhookが呼び出され、AdultVerification.Result タイプのイベントが確認結果と共に送信されます。

年齢しきい値の使用​

顔年齢推定では、ageパラメータに渡された特定の年齢を基準に、プレイヤーがその年齢を上回っているかどうかを確認することができます。age パラメータが省略された場合、管轄区域のデジタル同意年齢、またはk-IDパブリッシャーポータルで設定されたゲームのプレイに必要な最低年齢が基準となります。自己申告された年齢を受け入れる年齢ゲートの年齢確認を実装する際には、age パラメータとしてプレイヤーが提供した年齢を指定することができます。

指示のカスタマイズ​

k-IDの顔年齢推定はデフォルトでプレイヤー向けにローカライズされた指示を表示しますが、disableInstructions パラメータを使用してこれを無効にすることで、ユーザー体験をより完全にコントロールすることができます。

結果の受信​

年齢確認の結果は、登録されたWebhookに送信されます。結果を受信すると、成功または失敗の情報が含まれますが、さらに minAge、maxAge、および confidence も含まれます。この顔年齢推定に関する追加情報により、ユーザーの年齢がどれだけ正確に近いか、また推定の信頼度がどれほど高いかをゲーム側でよりよく把握することができます。

年齢推定のテスト​

k-ID APIを呼び出すコードを書く前に、APIキーを使用してAPIドキュメントを参照しながら、自分で顔年齢推定を試すことができます。

まず、簡単なk-ID APIコールを行う手順に従ってください。(

次に、同じブラウザウィンドウを使用して、/age-assurance/create-verification-request を呼び出します。これを行うには、リスト内のこのAPIをクリックしてください。

API Call

次に、Try it out ボタンをクリックし、その後 Execute ボタンをクリックしてください。

Result

アプリまたは別のブラウザウィンドウで使用するiframeのURLは、レスポンスの url パラメータに含まれています。このURLをブラウザにコピーしてください。この場合、URLは次の通りです：

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

次に、指示ページが表示されます：

顔年齢推定ガイダンス

Start ボタンをクリックして、顔年齢推定を試してみてください。セキュリティのために必要なライブネスチェックに注意してください。このビューではスキャン結果は視覚的に表示されず、JavaScriptのイベントおよびWebhookの呼び出しとして送信されます。このデモンストレーションでは、カメラ情報がデバイス外に送信されることはありません。