# 发版说明 (/zh-CN/realtime-media/whiteboard/whiteboard-sdk/reference/release-notes-wb/harmonyos) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 本文提供声网 Whiteboard HarmonyOS SDK(OHPM 包 `@shengwang/whiteboard`)的发版说明。 :::info[桥接说明] SDK 使用 ArkUI 组件和 ArkWeb 内嵌白板运行时。Native 包版本与内嵌 Web SDK 版本不同,各版本的内嵌依赖请参见对应版本说明。 ::: 接入与新增接口见[加入白板房间](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/get-started/join-room-wb)和[新版 API 与多窗口课件控制](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/extend-whiteboard/native-api-extension)。 ## 0.2.11 版 [#0211-版] 该版本于 2026 年 10 月 22 日发布。 :::info[桥接说明] 内嵌 Web SDK 版本为 [2.16.59](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/reference/release-notes-wb#21659-版),Window Manager 为 1.0.25,Appliance Plugin 为 1.1.45。动态 PPT 组件 app-slide 升级至 0.2.108,对应 Slide 1.4.65。 ::: ### 新增特性 [#新增特性-50] #### 等待房间退出完成 [#等待房间退出完成-2] 新增 `WhiteboardController.leaveRoom(): Promise`,等待当前控制器所属房间完成清理。原有 `disconnect(): Promise` 接口继续保留,并使用相同的异步退出流程。通过 `await` 或 Promise 获取操作结果,并处理退出失败的异常;不应将成功返回值作为房间全局状态读取。 ### 改进 [#改进-45] #### 房间生命周期 [#房间生命周期] - 同身份房间实例替换前等待旧实例退出,隔离旧实例的生命周期回调。 - 重复退出请求复用正在进行或已经完成的清理结果,保留清理失败信息。 - 更新内嵌动态 PPT 组件,改善课件播放兼容性。 ### API 变更 [#api-变更-27] #### 新增 [#新增-23] - `WhiteboardController.leaveRoom(): Promise`。 #### 调整 [#调整] - `WhiteboardController.disconnect(): Promise` 保持原签名,等待所属房间清理完成后返回异步结果。 ## 0.2.10 版 [#0210-版] 该版本于 2026 年 10 月 12 日发布。 ### 新增特性 [#新增特性-51] #### 动态配置 [#动态配置-3] 新增 WhiteboardOptions.dynamicConfig 和导出 DynamicConfigOptions,按 region 读取配置;保留未显式配置字段的继承语义,提供 buildSdkOptions。 ### 改进 [#改进-46] 升级内嵌 Web SDK 2.16.59、WindowManager 1.0.25、Appliance Plugin 1.1.45。 ## 0.2.9 版 [#029-版] 该版本于 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 版 [#028-版] 该版本于 2026 年 9 月 14 日发布。 ### 更新 [#更新-1] `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 版 [#027-版] 该版本于 2026 年 8 月 28 日发布。 ### 更新 [#更新-2] 改进动态课件 GIF 解码及 WebGL 转场恢复。 app-slide 升级至 0.2.103,内嵌 Slide 1.4.57。 ## 0.2.6 版 [#026-版] 该版本于 2026 年 8 月 27 日发布。 ### 更新 [#更新-3] 新增 `onSlidePageStateChanged`,回调包含 `appId/page/pageCount`,页码从 1 开始;改进初始化失败事件解析。 app-slide 升级至 0.2.102,内嵌 Slide 1.4.56,修复课件冻结恢复和销毁问题。 ## 0.2.5 版 [#025-版] 该版本于 2026 年 8 月 22 日发布。 ### 更新 [#更新-4] 修复回调数据为 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 版 [#024-版] 该版本于 2026.08.21 发布。 ### 新增特性与改进 [#新增特性与改进] - `WhiteboardCallbacks` 新增 `sdkSetupFail`,用于在 SDK 初始化失败时通知业务侧重新初始化并重新加房,并与 Android、iOS 的公开接口命名保持一致。 - 公开导出 `SDKError`,提供初始化失败原因和 JS 堆栈信息。 ### API 变更 [#api-变更-28] 详见[公开 API](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/overview)。 ## 0.2.3 版 [#023-版] 该版本于 2026.08.15 发布。 ### 新增特性与改进 [#新增特性与改进-1] - 升级内嵌 `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 变更 [#api-变更-29] 详见[公开 API](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/overview)。 ## 0.2.2 版 [#022-版] 该版本于 2026.08.14 发布。 ### 新增特性与改进 [#新增特性与改进-2] - 升级内嵌 `Whiteboard-bridge` 资源至提交 `aa1dfd7`,包含 `appliance-plugin@1.1.39` 和 `window-manager@1.0.18`。 - 新增 `enableAppliancePlugin` 与 `appliancePluginOptions`,支持透传 cursor、同步、贝塞尔曲线和文本编辑器配置。 - Harmony demo 增加自定义 cursor 配置;模拟器验证时局部使用 2D canvas context。 ### API 变更 [#api-变更-30] 详见[公开 API](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/overview)。 ## 0.2.1 版 [#021-版] 该版本于 2026.07.17 发布。 ### 新增特性与改进 [#新增特性与改进-3] - 升级内嵌 `Whiteboard-bridge` jsbridge 资源,包含 `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 变更 [#api-变更-31] 详见[公开 API](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/overview)。 ## 0.2.0 版 [#020-版] 该版本于 2026.05.09 发布。 ### 新增特性与改进 [#新增特性与改进-4] - 升级内嵌 `Whiteboard-bridge` jsbridge 资源。 - 对齐 Harmony 与 Android 已公开且 bridge 已支持的 `joinRoom`、`room`、多窗口和多页相关接口。 - 新增 `WhiteboardController` / 回调解析 / join 参数映射单元测试支持。 ### API 变更 [#api-变更-32] 详见[公开 API](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/overview)。 ## 0.1.0 版 [#010-版] 该版本于 2024.12.09 发布。 ### 新增特性与改进 [#新增特性与改进-5] - initial ### API 变更 [#api-变更-33] 详见[公开 API](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/overview)。