白板变更记录

版本号、新增或变更的操作、兼容窗口与对应版本。

版本 v1.0.0 · 更新于 2026-10-28 · 修订 1

本页记录互动白板产品线的版本变化。版本号与 REST 接口定义、Web SDK 版本一一对应。

版本 1.0.0（2026-10-28）#

首个正式版本，覆盖房间、场景、内容、快照、回放与 Token 全链路。

• 新增 /v1/whiteboard/rooms：创建、列表、详情、封禁/解禁、永久关闭。
• 新增 /v1/whiteboard/rooms/{uuid}/scenes 与 scene-state：场景列表、新增、切换。
• 新增 strokes、images、viewport：笔迹追加/擦除、图片插入、视口更新。
• 新增 undo / redo：按成员隔离的撤销重做，带完整操作日志。
• 新增 snapshot、snapshot.svg、replay：JSON 快照、SVG 导出与回放时间线。
• 新增 tokens/rooms/{uuid} 与 tokens/teams：房间 Token 与项目 Token，支持 admin / writer / reader。
• 新增 members：加入与离开房间，写者名额限制。
• 发布 @nimeet/sdk-whiteboard-web 1.0.0：Room、Scene、Camera、Member、Player/Replay、错误码。
• Android / iOS 仅发布接口定义与显式 NOT_SUPPORTED 桩；不提供渲染或媒体链路。

兼容窗口#

• 1.0.0 的 REST 接口固定在 v1 白板接口定义，新增可选字段属于兼容变更。
• 破坏性变更会以新路径（/v2/...）与新的 SDK 主版本发布，1.0.0 至少保留 90 天双版本期。
• 房间 Token 与项目 Token 的前缀（NETLESSROOM_ / NETLESSSDK_）保持稳定。

已知限制#

• 操作日志每房间保留最近 10000 条。
• 服务端不提供文档转换与场景删除。
• 内存存储实现重启即清空；生产需接入持久化存储。