`Screentime.QuietHoursWarning`

취침 시간과 같은 조용한 시간대가 시작되기 15분 전에 발생합니다. 플레이가 곧 중단된다는 것을 플레이어에게 알려 저장 지점에 도달할 수 있게 하세요.

엔드포인트를 이 이벤트에 구독하세요

k-ID는 Screentime.QuietHoursWarning를 구독한 엔드포인트에만 전달하고, 나머지에는 전달 시도나 오류 없이 버립니다. 제품의 Developer Settings 페이지에서 엔드포인트에 대해 선택하세요. 시작하기 전에를 참조하세요.

조용한 시간은 사용량 예산이 아니라 달력상의 시간대입니다. 일정에 설정된 요일과 시각에, 그날 얼마나 사용했는지와 무관하게 적용됩니다. 시간대가 실제로 시작될 때 발생하는 짝 이벤트는 Screentime.QuietHoursReached입니다.

15분이라는 사전 알림 시간은 이 버전에서 고정되어 있으며 제품별로 설정할 수 없습니다.

필드

필드	유형	필수	설명
`eventType`	string	예	항상 `"Screentime.QuietHoursWarning"`
`data`	object	예	조용한 시간 경고 데이터
`data.sessionId`	string (UUID)	예	시간대가 적용되는 세션 ID
`data.productId`	number	예	제품 ID
`data.windowName`	string	예	부모가 지정한 시간대 이름, 예: `"취침 시간"`
`data.startsAt`	string (RFC 3339)	예	시간대가 시작되는 시각
`data.minutesUntilStart`	number	예	`startsAt`까지 남은 분(정수), 최소 0

windowName은 부모가 자유롭게 입력하는 텍스트입니다. 어떤 규칙이 적용되는지 플레이어에게 알리기 위해 표시하는 것은 괜찮지만, 그 값에 따라 동작을 분기하지는 마세요.

예시

{
  "eventType": "Screentime.QuietHoursWarning",
  "data": {
    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",
    "productId": 42,
    "windowName": "취침 시간",
    "startsAt": "2026-06-24T21:00:00+09:00",
    "minutesUntilStart": 15
  }
}

세션 진행 여부와 무관하게 발생합니다

한도 및 휴식 알림 이벤트와 달리 조용한 시간 이벤트는 /screentime/start가 아니라 부모의 달력에 의해 구동됩니다. 제품에 유효한 k-ID 세션이 있는 플레이어에게는 스크린 타임 세션이 진행 중이 아니어도 일정에 따라 발생합니다. 이 이벤트는 방어적으로 처리하세요. 발생 시점에 플레이어가 제품 안에 없을 수 있으므로 끼어들 UI가 있다고 가정하지 마세요.

시간대 경계는 일정의 시간대 기준으로 평가됩니다. 따라서 21:00에 시작하는 시간대의 경고는 현지 시간 20:45에 발생하며, 사전 알림 시간이 자정을 넘는 경우에도 해당 요일이 올바르게 이동합니다.

필드​

예시​

세션 진행 여부와 무관하게 발생합니다​

필드

예시

세션 진행 여부와 무관하게 발생합니다