メインコンテンツに移動

Screentime.QuietHoursReached

静かな時間帯が開始したときに発行されます。対になるより早いシグナルはScreentime.QuietHoursWarningで、時間帯が始まる時点ではなくその前にプレイヤーに知らせるため15分前に発行されます。

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

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

役立つフィールドはendsAtです。これは時間帯が終了する時刻であり、今はプレイできないという情報だけでなく、いつ戻れるのかをプレイヤーに伝えられます。時間帯はスケジュールのタイムゾーンで評価され、21:00から07:00のように深夜をまたぐ時間帯ではendsAtが翌日に正しく繰り越されます。

k-IDはプレイヤーをサインアウトさせず、何もブロックしません。判定はGET /screentime/get-stateで確認してください。時間帯が有効な間はaccess.allowedがfalse、access.details.reasonがquiet_hoursとなり、access.details.resumesAtはこのイベントのendsAtと一致します。

プレイヤーは/screentime/request-overrideで保護者に時間帯の解除をリクエストできます。回答はScreentime.OverrideResultとして届きます。

フィールド​

フィールドタイプ必須説明
eventTypestringはい常に"Screentime.QuietHoursReached"
dataobjectはい静かな時間のデータ
data.sessionIdstring (UUID)はい時間帯が適用されるセッションID
data.productIdnumberはいプロダクトID
data.windowNamestringはい保護者が付けた時間帯の名前。例："就寝時間"
data.endsAtstring (RFC 3339)はい時間帯が終了し、プレイを再開できる時刻

例​

{
  "eventType": "Screentime.QuietHoursReached",
  "data": {
    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",
    "productId": 42,
    "windowName": "就寝時間",
    "endsAt": "2026-06-25T07:00:00+09:00"
  }
}

セッションが進行中かどうかに関係なく発行されます​

警告と同様に、このイベントは/screentime/startではなく保護者のカレンダーによって駆動されます。プロダクトで有効なk-IDセッションを持つプレイヤーに対しては、スクリーンタイムのセッションが進行中でなくても発行されます。