メインコンテンツに移動

Screentime.LimitWarning

プレイヤーが本日のスクリーンタイムの1日の制限に近づいたとき、まだ対処できる時点で発行されます。アクティビティの途中で中断されるのではなく、セーブポイントを見つけたり切り上げたりできるよう、プレイヤーに警告してください。

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

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

k-IDは残り15分と残り5分の時点で警告を送信します。このバージョンでは両方のしきい値は固定されており、プロダクトごとに設定することはできません。

制限に達する前に警告することは、副作用ではなく意図された動作です。このイベントとScreentime.LimitReachedは組にして扱ってください。警告は「プレイヤーに知らせる」、制限到達のイベントは「制限が適用された」と考えてください。

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

警告は/screentime/startの呼び出し時にスケジュールされ、/screentime/endの呼び出し時にキャンセルされます。そのため、セッションの開始と終了をリアルタイムで報告するプロダクトでのみ発行されます。/screentime/pushで報告された利用時間も1日の合計には加算されますが、警告は発行されません。

フィールド​

フィールドタイプ必須説明
eventTypestringはい常に"Screentime.LimitWarning"
dataobjectはい制限警告のデータ
data.sessionIdstring (UUID)はい警告の対象となるセッションID
data.productIdnumberはいプロダクトID
data.timeUsedSecondsnumberはい進行中のセッションの時間を含む、本日の利用時間（秒）
data.timeLimitSecondsnumberはい本日の1日の制限（秒）
data.timeRemainingSecondsnumberはい制限に達するまでの残り時間（秒）。下限は0

2つの警告を区別するには、イベントの数を数えるのではなくtimeRemainingSecondsを読んでください。この値は発行時点で計測されるため、900または300に近い値になりますが、常に正確に一致するとは限りません。

例​

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

発行されない場合​

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