发版说明

  • HarmonyOS

更新时间

查看互动白板 SDK 的版本更新、问题修复、行为变更和兼容性说明,评估升级影响。

本文提供声网 Whiteboard HarmonyOS SDK(OHPM 包 @shengwang/whiteboard)的发版说明。

桥接说明

SDK 使用 ArkUI 组件和 ArkWeb 内嵌白板运行时。Native 包版本与内嵌 Web SDK 版本不同,各版本的内嵌依赖请参见对应版本说明。

接入与新增接口见加入白板房间和新版 API 与多窗口课件控制。

该版本于 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 组件,改善课件播放兼容性。

API 变更

新增

  • WhiteboardController.leaveRoom(): Promise<object>。

调整

  • WhiteboardController.disconnect(): Promise<object> 保持原签名,等待所属房间清理完成后返回异步结果。