跳到主要内容

Screentime.QuietHoursWarning

在安静时段（例如就寝时间）开始前 15 分钟发出。请提醒玩家游玩即将暂停，让他们能够到达存档点。

请为您的端点订阅此事件

k-ID 只会把 Screentime.QuietHoursWarning 投递给已订阅它的端点，其余端点会被丢弃，既不尝试投递也不报错。请在产品的 Developer Settings 页面为您的端点选择它。请参阅开始之前。

安静时段是日历上的时间段，而不是使用量预算。它们在安排中配置的日期和时刻生效，与当天已使用多少时间无关。时段真正开始时发出的配对事件是 Screentime.QuietHoursReached。

15 分钟的提前时间在此版本中为固定值，无法按产品配置。

字段​

字段类型必需说明
eventTypestring是始终为 "Screentime.QuietHoursWarning"
dataobject是安静时段警告数据
data.sessionIdstring (UUID)是时段适用的会话 ID
data.productIdnumber是产品 ID
data.windowNamestring是父母为该时段起的名称，例如 "就寝时间"
data.startsAtstring (RFC 3339)是时段开始的时刻
data.minutesUntilStartnumber是距 startsAt 的整分钟数，最小为 0

windowName 是父母自由填写的文本。若您希望告知玩家即将生效的是哪条规则，可以显示它，但不要根据它的值切换行为。

示例​

{
  "eventType": "Screentime.QuietHoursWarning",
  "data": {
    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",
    "productId": 42,
    "windowName": "就寝时间",
    "startsAt": "2026-06-24T21:00:00+08:00",
    "minutesUntilStart": 15
  }
}

无论是否有进行中的会话都会发出​

与限制和休息提醒事件不同，安静时段事件由父母的日历驱动，而不是由 /screentime/start 驱动。对于在您产品中拥有有效 k-ID 会话的玩家，即使没有进行中的屏幕时间会话，事件也会按计划发出。请以防御性的方式处理该事件：发出时玩家可能并不在您的产品中，因此不要假设存在可以介入的界面。

时段边界按安排所用的时区计算，因此在 21:00 开始的时段，其警告会在当地时间 20:45 发出；当提前时间跨过午夜时，所属的日期也会正确前移。