본문으로 건너뛰기

Screentime.BreakReminder

플레이어가 부모가 설정한 휴식 간격 동안 하나의 세션을 계속했을 때 발생합니다. 휴식을 권하는 안내를 플레이어에게 표시하세요.

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

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

이 이벤트는 플레이어가 세션을 끝낸 후가 아니라 아직 세션 중일 때 발생합니다. 캘리포니아 SB 243과 같은 휴식 알림 의무가 요구하는 시점이 바로 이때입니다. k-ID는 /screentime/start를 호출할 때 알림을 예약하고 /screentime/end를 호출할 때 취소합니다. 따라서 발생 시점은 제품이 세션의 시작과 종료를 실시간으로 보고하는지에 달려 있습니다.

/screentime/push에서는 발생하지 않습니다

/screentime/push는 사용 시간을 사후에 보고하므로 알림이 끼어들 진행 중인 세션이 없습니다. 휴식 알림이 필요한 제품은 start와 end를 사용해야 합니다. 비교는 스크린 타임 통합 가이드를 참조하세요.

알림은 세션당 최대 한 번 발생합니다. 한 세션에서 휴식 간격의 세 배에 해당하는 시간을 플레이한 플레이어는 알림을 세 번이 아니라 한 번 받습니다. 새 세션을 시작하면 간격은 처음부터 다시 계산됩니다.

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
  }
}

발생하지 않는 경우​

  • 부모가 스크린 타임 일정을 설정하지 않았거나 일정이 비활성화되어 있습니다.
  • 일정에 휴식 알림 간격이 설정되어 있지 않습니다.
  • 간격이 지나기 전에 세션이 종료되었습니다.