发版说明
本文提供声网 Whiteboard HarmonyOS SDK（OHPM 包 @shengwang/whiteboard）的发版说明。
SDK 使用 ArkUI 组件和 ArkWeb 内嵌白板运行时。Native 包版本与内嵌 Web SDK 版本不同，各版本的内嵌依赖请参见对应版本说明。
接入与新增接口见加入白板房间和新版 API 与多窗口课件控制。
0.2.11 版
该版本于 2026 年 10 月 22 日发布。
内嵌 Web SDK 版本为 2.16.59，Window Manager 为 1.0.25，Appliance Plugin 为 1.1.45。动态 PPT 组件 app-slide 升级至 0.2.108，对应 Slide 1.4.65。
新增 WhiteboardController.leaveRoom(): Promise<object>，等待当前控制器所属房间完成清理。原有 disconnect(): Promise<object> 接口继续保留，并使用相同的异步退出流程。通过 await 或 Promise 获取操作结果，并处理退出失败的异常；不应将成功返回值作为房间全局状态读取。
- 同身份房间实例替换前等待旧实例退出，隔离旧实例的生命周期回调。
- 重复退出请求复用正在进行或已经完成的清理结果，保留清理失败信息。
- 更新内嵌动态 PPT 组件，改善课件播放兼容性。
WhiteboardController.leaveRoom(): Promise<object>。
WhiteboardController.disconnect(): Promise<object>保持原签名，等待所属房间清理完成后返回异步结果。
0.2.10 版
该版本于 2026 年 10 月 12 日发布。
新增 WhiteboardOptions.dynamicConfig 和导出 DynamicConfigOptions，按 region 读取配置；保留未显式配置字段的继承语义，提供 buildSdkOptions。
升级内嵌 Web SDK 2.16.59、WindowManager 1.0.25、Appliance Plugin 1.1.45。
0.2.9 版
该版本于 2026 年 9 月 28 日发布。
新增窗口强制最大化、按焦点初始化、本端 App 缓存及 Slide navigationButtonMode 配置；focusApp 返回焦点提交结果。
内嵌 Window Manager 1.0.23、Appliance Plugin 1.1.44、app-slide 0.2.106。改进窗口焦点与关闭交接、图片初始化失败处理和 PPT 媒体恢复。
0.2.8 版
该版本于 2026 年 9 月 14 日发布。
dispatchDocsEvent 支持 MainView、DocsViewer、Slide 和 Presentation 统一异步控制；新增 originSize、pageScaleRange、getPageState、onUnifiedPageStateChange 及 fitOriginSizeAndCamera。addApp 等待 App 初始化，失败 reject 并清理窗口。
内嵌 Window Manager 1.0.22、Appliance Plugin 1.1.43、app-slide 0.2.104。修复相机、橡皮及 Worker 渲染恢复问题。
0.2.7 版
该版本于 2026 年 8 月 28 日发布。
改进动态课件 GIF 解码及 WebGL 转场恢复。
app-slide 升级至 0.2.103，内嵌 Slide 1.4.57。
0.2.6 版
该版本于 2026 年 8 月 27 日发布。
新增 onSlidePageStateChanged，回调包含 appId/page/pageCount，页码从 1 开始；改进初始化失败事件解析。
app-slide 升级至 0.2.102，内嵌 Slide 1.4.56，修复课件冻结恢复和销毁问题。
0.2.5 版
该版本于 2026 年 8 月 22 日发布。
修复回调数据为 JSON 字符串时的解析问题，恢复背景图加载、教具初始化、消息及 Slide 错误事件分发。
内嵌 Whiteboard Web 2.16.58、Window Manager 1.0.19、Appliance Plugin 1.1.42、app-slide 0.2.100。
0.2.4 版
该版本于 2026.08.21 发布。
WhiteboardCallbacks新增sdkSetupFail，用于在 SDK 初始化失败时通知业务侧重新初始化并重新加房，并与 Android、iOS 的公开接口命名保持一致。- 公开导出
SDKError，提供初始化失败原因和 JS 堆栈信息。
详见公开 API。
0.2.3 版
该版本于 2026.08.15 发布。
- 升级内嵌
Whiteboard-bridge资源至提交42c7f0d，将@netless/appliance-plugin从1.1.39升级至1.1.40。 - 新增
workerRenderModeBlacklist与workerCanvasContextBlacklist配置类型，支持按 Harmony ArkWeb 等运行时版本覆盖 Appliance Plugin Worker 渲染和 Canvas context 兼容性策略。 - 导出
VersionWorkerBlacklist与WorkerBlacklistByRuntime，供 Harmony 业务侧构造类型安全的 Worker 黑名单配置。
详见公开 API。
0.2.2 版
该版本于 2026.08.14 发布。
- 升级内嵌
Whiteboard-bridge资源至提交aa1dfd7，包含appliance-plugin@1.1.39和window-manager@1.0.18。 - 新增
enableAppliancePlugin与appliancePluginOptions，支持透传 cursor、同步、贝塞尔曲线和文本编辑器配置。 - Harmony demo 增加自定义 cursor 配置；模拟器验证时局部使用 2D canvas context。
详见公开 API。
0.2.1 版
该版本于 2026.07.17 发布。
- 升级内嵌
Whiteboard-bridgejsbridge 资源，包含white-web-sdk@2.16.56、本地日志上传链路、window-manager@1.0.17以及 Presentation/Docs/Slide 课件能力更新。 WhiteboardOptions新增localLogOptions，支持 Harmony 侧显式开启 WebView 内本地日志与上传配置。WhiteboardCallbacks新增onLocalLogStateChange，用于接收 bridge 侧本地日志运行状态变化。WhiteboardOptions新增slideAppOptions、presentationAppOptions，支持透传 Slide 缩放配置和 Presentation 内置课件配置。WindowParams新增useBoxesStatus参数，用于开启每个窗口独立的状态管理；新增builtinAppOptions用于配置 window-manager 内置 App。- 多窗口 API 补充
dispatchDocsEvent的scalePage事件类型，用于统一缩放 DocsViewer、Slide 和 Presentation 课件页面。 - 更新 Harmony demo：开启本地日志、Slide
enableScale、Presentation 课件插入、scalePage操作按钮，以及固定高度滚动测试按钮区域。 - 补充单元测试覆盖本地日志 bridge 方法、内置 App 配置、
useBoxesStatus和课件配置透传。
详见公开 API。
0.2.0 版
该版本于 2026.05.09 发布。
- 升级内嵌
Whiteboard-bridgejsbridge 资源。 - 对齐 Harmony 与 Android 已公开且 bridge 已支持的
joinRoom、room、多窗口和多页相关接口。 - 新增
WhiteboardController/ 回调解析 / join 参数映射单元测试支持。
详见公开 API。