Whiteboard 文档协作功能

实时同步、光标、头像

进入一个有人正在协作的项目,画板会实时呈现其他所有协作者的动作。

你能看到什么

1. 实时元素同步

任何人在画板上添加、移动、删除元素,其他人几百毫秒内就能看到变化——就像同一块物理白板一样。

刷新页面也不会断:重新进入后会自动接上正在进行的协作。

2. 鼠标光标

每个协作者的鼠标位置都会在你的画板上以彩色光标 + 名字显示:


   张三  ← 别人的光标 + 名字
  • 同一个人始终是同一种颜色
  • 名字来自 ta 的昵称或邮箱前缀

3. 协作者头像

画板右上角显示一排当前在线的协作者头像(包括你自己):

🧑 🧑 🧑   ← 当前在线 3 人
张三 李四 王五

鼠标移到头像上能看到完整邮箱,对方下线后头像消失。

4. 选中状态

某个协作者选中了画板上的元素时,元素四角会出现 ta 的颜色的小方块——提示「这个东西 ta 正在编辑」,避免你跟 ta 同时去改。

不同模式下的实时行为

你的模式看别人的改动自己改动同步给别人看别人光标自己光标可见
编辑
观察❌(你不能改)
批注仅批注

访客(通过分享链接进来的人)默认就在观察模式,行为参考上表后两行。

谁负责保存

很多人同时画的时候,画板内容只会保存出一条「最终一致」的版本,刷新后大家看到的是同一份。系统会在房间里自动协调,避免多人写入互相覆盖。你完全不需要操心这一层,照常画就好。

网络断开 / 重连

  • 网络抖动时画板顶部会短暂出现「连接中断」提示
  • 系统会自动重连,恢复后继续接收实时同步
  • 断开期间你正在画的内容会暂存在本地,重连后会自动同步给其他人

协作中的几个小限制

  • 离线时不能正常保存:网络断开后,你画的内容会暂存在本地。如果一直没恢复连接就关闭页面,本地未同步的内容会丢失
  • 大图片上传中:上传过程中画板会短暂显示加载占位,传完才会同步给其他人
  • 极快连续操作:系统每隔约 100ms 同步一次,超快的连续操作可能被合并成一帧

协作服务不可用时

如果协作服务整体不可用(比如自部署的服务器关闭),画板会自动进入「离线模式」:

  • 你可以正常画,改动会保存到自己的浏览器内存
  • 但和其他人不再有实时同步
  • 刷新后看到的是上一次正常保存的版本

恢复服务后再进入,会自动回到正常的实时协作状态。


下一步:活动记录