📄️ ワークフロー
以下のフローチャートは、k-IDエンジンのワークフローの概要を示しています。ワークフロー内でAPI呼び出しが使用されるポイントが示されています。k-ID Workflow
📄️ セッションの管理
れています。すべてのプレイヤーにはアクティブな「Session」が必要です。ゲームはアクティブな「Session」を参照して、ゲーム内の機能が有効か無効かを判断する必要があります。
📄️ プレーヤーの年齢を取得
年齢収集に関する管轄区域の要件
📄️ Age Verification
There are various scenarios where you must verify the age of a user, such as before granting access to your product, when restoring access to suspected underage accounts, or when providing access to age-restricted content.
📄️ Implementing Age Assurance
Age Verification currently includes following APIs
📄️ 年齢を確認すること
年齢ゲートが必要な場合、次のワークフローのステップを判断するために/age-gate/check API呼び出しを行う必要があります。プレイヤーの年齢がパブリッシャーポータルで設定されたゲームの最低年齢を下回る場合、返されるstatusフィールドはPROHIBITEDとなります。この時点で、プレイヤーはゲームの継続をブロックされるべきです。現在の場所で検証可能な親の同意が必要な年齢をプレイヤーが入力した場合、statusフィ ールドにはCHALLENGEという値が入り、新しい同意チャレンジのIDがchallengeIDフィールドで返されます。ゲームはその後、プレイヤーに親の同意を求めるよう促さなければなりません。最後に、statusの値がPASSであれば、プレイヤーはゲームを続行できます。
📄️ 保護書の同意を求めること
/age-gate/check の status フィールドで CHALLENGE の値が返された場合、レスポンスの challengeId フィールドには、k-IDエンジンの Consent Challenge のIDが含まれています。この時点で、プレイヤーが親の同意を求めるためのウィンドウを表示する必要があります。
📄️ 新しい権限の同意をリクエストする
（これはロードマップ機能でありまだ展開していなく、APIドキュメントでは実験的と記載されています）
📄️ セッション権限の使用
ユーザーが年齢ゲートチェックを通過した場合（適切な年齢であるか、保護者から同意が得られた場合）、ゲームは現在のプレイヤーに対する管轄地域固有のすべての権限を取得できます。これは、/age-gate/check呼び出しでstatusフィールドがPASSの場合に取得するか、セッションが以前に作成されてキャッシュされている場合は、/session/getを呼び出して取得します。
📄️ Webhooks(ウエブフック)
Webhooks を使用すると、k-ID エンジン内で発生しているイベントをリアルタイムで購読できます。これにより、API をポーリングしてデータが利用可能かどうかを確認する必要がなくなります。
📄️ Account System Integration
Some studios have a common Account system that spans across multiple games. It is often desirable in these situations to integrate an age gate and to handle Verifiable Parental Consent (VPC) directly in the Account creation flow so that players are asked for their age only once for all games from the same publisher.
📄️ Multi-Product Approval
k-ID supports the ability to present multiple products for parents to approve at the same time in the consent workflow, reducing friction in the approval process so that kids can more easily experience multiple games or apps from the same publisher.