同步观看
房间的播放状态由 SyncTV 服务端维护。客户端进入房间后获取当前播放状态和播放信息，再通过 Realtime 接收后续变化。
你会看到什么
Section titled “你会看到什么”| 行为 | 说明 |
|---|---|
| 开始播放或暂停 | 有权限的人操作后，房间成员跟随变化 |
| seek | 跳转到新的播放时间，客户端按服务端状态校正 |
| 切换媒体 | 当前媒体变化后，客户端重新获取播放信息 |
| 修改播放速度 | 有权限的人可以改变房间共享速度 |
| 重新连接 | 网络断开后，客户端应刷新关键状态 |
没有播放控制权限的用户只能跟随房间状态。看不到控制按钮时，先确认自己在房间中的角色和成员权限。
| 现象 | 先尝试 | 仍失败时收集 |
|---|---|---|
| 进度不同步 | 刷新页面或重新进入房间 | 房间 ID、时间、是否只有自己异常 |
| 切换媒体失败 | 重新点选媒体或刷新播放列表 | 媒体 ID、错误文本、HTTP 状态码 |
| 播放 URL 过期 | 重新获取播放信息或重新进入房间 | Provider 名称、过期提示、requestId |
| seek 后卡住 | 等待缓冲，确认网络和上游是否支持 Range | 上游响应状态、是否走代理 |
| 多人同时异常 | 等待管理员检查 WebSocket、Ingress 或 Provider | 时间范围、房间 ID、影响人数 |
直连还是代理
Section titled “直连还是代理”浏览器无法设置部分上游要求的 header，例如某些 User-Agent、Referer 或 Cookie。遇到这种情况时，应使用 SyncTV proxy 播放。代理播放会让 SyncTV 承担出口带宽，但能统一请求头并隐藏上游凭据。