离线与可靠性
网络中断时每块屏幕如何运作、如何恢复,以及如何保障房间安全。
房间保存在服务器上,每块屏幕都保留一份自己的副本。网络中断时,屏幕会继续计时,网络恢复后会自动重新连接。

连接状态
每个页面都会显示其连接情况。控制室、操作员、主持人和提问页面会在页眉中以名称显示状态。观众屏幕则显示一个小圆点。
| 状态 | 含义 | 观众屏幕圆点 |
|---|---|---|
| Live | 已连接,并与房间保持同步。 | 已连接 |
| readonly | 已连接,但此页面无法更改房间。 | 已连接 |
| connecting | 首次打开房间,尚未加载任何内容。 | 正在重新连接 |
| stale | 房间状态已更新,页面正在追赶同步。 | 正在重新连接 |
| offline | 连接已断开。页面显示其最后获得的状态。 | 离线 |
网络中断时
- 时钟持续运行。 每块屏幕使用自己的时钟,从最后获得的状态继续倒计时,因此即使连接中断,正在运行的计时器仍会在屏幕上继续走动。
- 自动重新连接。 页面会在半秒后重试,之后每次等待时间加倍,两次重试之间最长间隔 10 秒。连接恢复后,等待时间重新从半秒开始计算。
- 立即同步。 重新连接时,服务器会再次发送整个房间,因此屏幕会显示错过的所有更改。
- 更改不会排队。 离线时按下的按钮会被立即拒绝,而不会保存到稍后执行。请在页面恢复 Live 后再按一次。
状态过期(stale)
如果房间的变化方式使页面无法跟上,页面会显示 stale,房间的下一份完整副本会让它重新同步。无需任何操作。遇到这种情况的 API 调用会收到 409 Refused: staleEpoch:请重新发送。
只读房间
当页面的链接无法更改房间,或房间本身为只读时,页面会显示 readonly。超出您套餐房间数量的房间仍会保存,但以只读方式打开;最早创建的房间保持可写。您可以将房间移至回收站,或参阅套餐与限制。
演示房间
位于 https://cliqer.io/timer 的演示房间与其他房间一样在服务器上运行,无需账户。它采用 Free 套餐的限制,有效期为一小时。
已删除的房间
将房间移至回收站后,房间会保留 30 天。在 Cliqer Timer 房间中打开 回收站,即可从中恢复。30 天后房间将被永久删除。当您的房间数量已达到套餐上限时,无法恢复房间。
常见问题
这是正常现象。屏幕会从最后获得的状态继续计时,并自动重新连接。在此期间您所做的更改会在其恢复连接后同步过去。
离线时更改不会排队。请等待显示 Live 后再按一次。
请检查设备的网络。它最多每 10 秒重试一次,因此网络恢复后会自行重新连接。重新加载页面也可以解决。