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로 도착합니다.
필드
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
eventType | string | 예 | 항상 "Screentime.QuietHoursReached" |
data | object | 예 | 조용한 시간 데이터 |
data.sessionId | string (UUID) | 예 | 시간대가 적용되는 세션 ID |
data.productId | number | 예 | 제품 ID |
data.windowName | string | 예 | 부모가 지정한 시간대 이름, 예: "취침 시간" |
data.endsAt | string (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 세션이 있는 플레이어에게는 스크린 타임 세션이 진행 중이 아니어도 발생합니다.