メインコンテンツに移動

Screentime.LimitReached

プレイヤーの利用時間が本日のスクリーンタイムの1日の制限に達した、または超えたときに発行されます。制限に達する時点ではなくその前にプレイヤーに知らせるため、より早く発行されるScreentime.LimitWarningと組になっています。

エンドポイントをこのイベントに購読させてください

k-IDはScreentime.LimitReachedを、購読しているエンドポイントにのみ配信します。それ以外には配信の試行もエラーもなく破棄されます。プロダクトのDeveloper Settingsページで、エンドポイントに対して選択してください。始める前にを参照してください。

k-IDはセッションを終了せず、プレイヤーをサインアウトさせず、何もブロックしません。制限が適用されたことを報告するだけです。それがプロダクトにおいて何を意味するかはプロダクト側の判断であり、参照すべきエンドポイントはGET /screentime/get-stateです。access.allowedがfalseでaccess.details.reasonがlimit_reachedの場合、access.details.resumesAtが制限の解除時刻を示します。

この時点でプレイヤーに/screentime/request-overrideを提示し、行き詰まる代わりに保護者へ延長をリクエストできるようにしてください。保護者の回答はScreentime.OverrideResultとして届きます。

/screentime/pushでは発行されません

他のリアルタイムのシグナルと同様に、このイベントは/screentime/startの呼び出し時にスケジュールされ、/screentime/endの呼び出し時にキャンセルされます。/screentime/pushは利用時間を加算しますが、制限に関するイベントは発行しません。

フィールド​

フィールドタイプ必須説明
eventTypestringはい常に"Screentime.LimitReached"
dataobjectはい制限到達のデータ
data.sessionIdstring (UUID)はい制限が適用されるセッションID
data.productIdnumberはいプロダクトID
data.timeUsedSecondsnumberはい進行中のセッションの時間を含む、本日の利用時間（秒）
data.timeLimitSecondsnumberはい本日の1日の制限（秒）

timeUsedSecondsはイベントの発行時点で計測されるため、timeLimitSecondsをわずかに超えることがあります。

例​

{
  "eventType": "Screentime.LimitReached",
  "data": {
    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",
    "productId": 42,
    "timeUsedSeconds": 7200,
    "timeLimitSeconds": 7200
  }
}

発行されない場合​

  • 保護者がスクリーンタイムのスケジュールを設定していない、またはスケジュールが無効になっている。
  • スケジュールのタイムゾーンにおける本日の曜日に1日の制限が設定されていない。
  • 本日すでに制限に達している。