跳到主要内容

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

不会发出的情况​

  • 父母没有设置屏幕时间安排，或安排已停用。
  • 安排中未设置休息提醒间隔。
  • 会话在间隔到达之前结束。