メインコンテンツに移動

Screentime.BreakReminder

保護者が設定した休憩間隔にわたってプレイヤーが1回のセッションを継続したときに発行されます。休憩を促すメッセージをプレイヤーに表示してください。

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

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

このイベントは、プレイヤーがセッションを終了した後ではなく、まだセッション中に発行されます。カリフォルニア州SB 243などが定める休憩リマインダーの義務が求めるのは、このタイミングです。k-IDは/screentime/startの呼び出し時にリマインダーをスケジュールし、/screentime/endの呼び出し時にキャンセルします。そのため、発行のタイミングはプロダクトがセッションの開始と終了をリアルタイムで報告することに依存します。

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

/screentime/pushは事後に利用時間を報告するため、リマインダーが割り込む対象となる進行中のセッションが存在しません。休憩リマインダーが必要なプロダクトはstartとendを使用してください。比較はスクリーンタイム統合ガイドを参照してください。

リマインダーは1セッションにつき最大1回発行されます。1回のセッションで休憩間隔の3倍の時間プレイしたプレイヤーが受け取るリマインダーは、3回ではなく1回です。新しいセッションを開始すると間隔は最初から数え直されます。

k-IDはプレイヤーに割り込むこともセッションを終了することもありません。プロダクトにおける休憩をどのような形にするかは、プロダクト側の判断です。閉じられる通知、強制的な一時停止、チェックポイントの保存など、いずれでも構いません。

フィールド​

フィールドタイプ必須説明
eventTypestringはい常に"Screentime.BreakReminder"
dataobjectはい休憩リマインダーのデータ
data.sessionIdstring (UUID)はいリマインダーの対象となるセッションID
data.productIdnumberはいプロダクトID
data.continuousDurationSecondsnumberはい現在のセッションが進行している時間（秒）
data.breakIntervalSecondsnumberはいこのリマインダーを発生させた、保護者が設定した休憩間隔（秒）

continuousDurationSecondsはイベントの発行時点で計測されるため、配信の遅延によりbreakIntervalSecondsよりわずかに大きくなることがあります。

例​

{
  "eventType": "Screentime.BreakReminder",
  "data": {
    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",
    "productId": 42,
    "continuousDurationSeconds": 2700,
    "breakIntervalSeconds": 2700
  }
}

発行されない場合​

  • 保護者がスクリーンタイムのスケジュールを設定していない、またはスケジュールが無効になっている。
  • スケジュールに休憩リマインダーの間隔が設定されていない。
  • 間隔が経過する前にセッションが終了した。