Shared Worker 可作为跨窗口摇杆中央协调器,统一归集、验证并广播标准化摇杆数据(如 {angle, power, isPressed}),需兜底超时重置、冷启动同步及 Safari 降级方案。

Shared Worker 本身不能直接操作 Canvas 或读取鼠标/触摸事件,但它可以作为跨窗口摇杆状态的“中央协调器”——把各页面采集到的原始输入(如 touchstart/touchmove 坐标、按钮按下状态)统一归集、计算、裁剪并广播标准化后的摇杆数据(如 { angle: 135, power: 0.7, isPressed: true }),让所有游戏窗口渲染一致的控制意图。
摇杆状态需标准化后再同步
不同窗口的 Canvas 尺寸、坐标系、缩放比例可能不同,直接传 raw touch 坐标会导致行为错位。Shared Worker 不处理 DOM,但可接收各页面发来的归一化参数:
- 页面在 touchmove 后,先将 clientX/clientY 转为相对于摇杆中心的 [-1, 1] 范围内向量,再计算 angle(0–360°)和 power(0–1)
- 页面通过 port.postMessage({ type: 'JOYSTICK_UPDATE', payload: { angle, power, isPressed } }) 上报
- Shared Worker 不做二次转换,只验证数值合法性(如 power ≤ 1),然后立即广播给所有连接端口
Worker 内必须维护“最后有效状态”而非仅转发
用户松手后,touchend 可能因页面失焦未触发;某个窗口崩溃也会中断上报。Worker 需主动兜底:
- 收到 JOYSTICK_UPDATE 时更新全局 lastState = { ...payload, ts: Date.now() }
- 启动 setInterval 检查:若 lastState.ts 超过 300ms 无更新,自动广播 { isPressed: false, power: 0 } 作为安全默认
- 每个新连接的页面首次通信时,Worker 主动发送当前 lastState,避免冷启动抖动
防抖与节流由页面层完成,Worker 只负责保真分发
高频 touchmove 容易引发消息洪峰,Shared Worker 的 message queue 并非无限缓冲。策略要分层:
- 页面层用 requestAnimationFrame 聚合连续 touchmove,每帧最多上报一次 JOYSTICK_UPDATE
- Worker 层不实现 throttle,但对同一端口的重复相同 payload(如连续 { power: 0 })做简单去重,避免冗余广播
- 广播使用 ports.forEach(port => port.postMessage(...)),不 await,不校验接收方是否存活——异常断开由 onclose 自动清理
兼容性与降级必须前置考虑
Safari 全平台不支持 SharedWorker,iOS 所有浏览器均不可用。上线前需明确 fallback 方案:
- 初始化时 try/catch new SharedWorker(),失败则退回到 BroadcastChannel + localStorage 快照同步(精度略低,但可用)
- 摇杆状态字段设计保持轻量(仅 angle/power/isPressed/ts 四个 key),确保降级通道也能高效序列化
- HTTPS 是硬性前提;localhost 可调试,但生产环境 HTTP 域名下 SharedWorker 直接静默失败


















