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+08:00"
  }
}

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

与警告一样，此事件由父母的日历驱动，而不是由 /screentime/start 驱动。对于在您产品中拥有有效 k-ID 会话的玩家，即使没有进行中的屏幕时间会话，事件也会发出。