DOMイベントイベント構造
Widget.AgeGate.Result
Age Gateフローが結果とともに完了したときに発行されます。フローが正常に完了するとセッションが作成され、フローがチャレンジを必要とするたびに、確認可能な保護者の同意、またはプレイヤーが保護者の同意をスキップできる年齢を申告した場合のAutomatic age assuranceのためにチャレンジが作成されます。
フィールド
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
eventType | string | はい | 常に"Widget.AgeGate.Result" |
data | object | はい | 結果の詳細 |
data.status | string | はい | 結果ステータス。"PASS"、"FAIL"、または"PROHIBITED"のいずれか(ステータス値を参照)。 |
data.sessionId | string (UUID) | いいえ | フローが正常に完了したときのセッションID。statusが"PASS"の場合は常に存在し、それ以外の場合は存在しません。 |
data.challengeId | string (UUID) | いいえ | フローでチャレンジが関与した場合のチャレンジID(たとえば、保護者の同意またはAutomatic age assurance)。チャレンジが作成された場合にのみ存在します。 |
data.age | number | いいえ | プレイヤーが年齢ゲートで入力した年齢。statusが"PROHIBITED"の場合に存在します。 |
ステータス値
status | 意味 | 対応 |
|---|---|---|
PASS | プレイヤーが年齢ゲートを通過し、セッションが作成されました。sessionIdが存在します。 | 返されたsessionIdを使用してアクセスを許可します。 |
FAIL | フローで必要なチャレンジが通過しませんでした。たとえば、信頼できる大人が保護者の同意を拒否した、またはプレイヤーがAutomatic age assuranceを完了しなかった場合です。セッションは作成されません。challengeIdがそのチャレンジを識別します。 | アクセスを許可しないでください。 |
PROHIBITED | プレイヤーはこの管轄区域におけるプロダクトの最低年齢に達しておらず、続行できません。セッションは作成されません。ageに入力された年齢が含まれます。 | プレイヤーの続行をブロックします。 |
結果はサーバーサイドで確認してください
イベントのstatusはUXのヒントとして扱ってください。アクセスを許可する前に、Challenge.StateChange webhookまたは/session/getでサーバーサイドで結果を確認してください。
例
フロー中にチャレンジが解決された場合
{
"eventType": "Widget.AgeGate.Result",
"data": {
"status": "PASS",
"sessionId": "f1af4704-74b4-4966-b13a-18eb16bccf9c",
"challengeId": "a04467a0-83de-40ca-8572-8cc761e896aa"
}
}チャレンジが不要だった場合
{
"eventType": "Widget.AgeGate.Result",
"data": {
"status": "PASS",
"sessionId": "f1af4704-74b4-4966-b13a-18eb16bccf9c"
}
}プレイヤーが最低年齢に達していない場合
セッションは作成されません。プレイヤーの続行をブロックしてください。
{
"eventType": "Widget.AgeGate.Result",
"data": {
"status": "PROHIBITED",
"age": 8
}
}