# 发版说明 (/zh-CN/realtime-media/whiteboard/whiteboard-sdk/reference/release-notes-wb/android) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). :::info[桥接说明] 为了确保 Whiteboard SDK 在不同平台上提供一致的用户体验,同时允许各端以原生方式接入,Whiteboard Android SDK 通过桥接 Whiteboard Web SDK 实现,不是完全原生的 SDK。因此,Android SDK 的版本更新内容会默认包含指定 Web SDK 版本及以前的更新内容,你可以根据 Android 各版本的桥接说明,前往 [Web SDK 发版说明](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/reference/release-notes-wb)查看包含的更新内容。 ::: ## 2.16.134 版 [#216134-版] 该版本于 2026 年 10 月 21 日发布。 :::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。 ::: ### 新增特性 [#新增特性] #### 等待房间退出完成 [#等待房间退出完成] 新增 `WhiteSdk.leaveRoom(Promise promise)`,用于等待待完成的入房流程以及当前房间或回放实例清理。通过 `Promise.then` 或 `Promise.catchEx` 获取操作完成或失败结果;不应将成功返回值作为房间全局状态读取。 ### 改进 [#改进] #### 房间与回放生命周期 [#房间与回放生命周期] - 串行处理房间、回放实例的替换,新实例创建前等待旧实例退出,降低重叠入房造成的状态冲突。 - 隔离旧实例的生命周期回调,避免已退出实例的事件影响当前房间。 - 按入房参数指定的 region 获取动态配置。 - 更新内嵌动态 PPT 组件,改善课件播放兼容性。 ### API 变更 [#api-变更] #### 新增 [#新增] - `WhiteSdk.leaveRoom(Promise promise)`。 ## 2.16.133 版 [#216133-版] 该版本于 2026 年 10 月 12 日发布。 ### 改进 [#改进-1] #### 构建与依赖兼容 [#构建与依赖兼容] 调整 JitPack 依赖下载与 Java 8 构建基线;SDK 接口及运行时沿用 2.16.132。 ## 2.16.132 版 [#216132-版] 该版本于 2026 年 10 月 12 日发布。 ### 新增特性 [#新增特性-1] #### 动态配置 [#动态配置] 新增 WhiteSdkConfiguration.dynamicConfig 地址映射,按入房 region 下载动态配置,默认超时 5 秒,失败使用本地参数。 ### 改进 [#改进-2] 升级内嵌 Web SDK 2.16.59、WindowManager 1.0.25、Appliance Plugin 1.1.45。 ## 2.16.131 版 [#216131-版] 该版本于 2026 年 9 月 28 日发布。 ### 新增特性 [#新增特性-2] - 新增强制最大化、课件按需加载、本地 App 缓存和 `navigationButtonMode`。本地 App 缓存默认容量为 4。 - `focusApp` 返回成功表示焦点、窗口层级和 zIndex 已提交,不代表页面已经完成渲染。 ### 改进 [#改进-3] - 依赖升级,提升背景图恢复、焦点切换和播放器生命周期的稳定性。 - 相关依赖升级至 Window Manager `1.0.23`、Appliance Plugin `1.1.44` 和 app-slide `0.2.106`。 ## 2.16.130 版 [#216130-版] 该版本于 2026 年 9 月 14 日发布。 ### API 变更 [#api-变更-1] - 新增 `originSize`、`fitOriginSizeAndCamera`、`getPageState` 和 `onUnifiedPageStateChange`。 ### 改进 [#改进-4] - `Room.addApp` 等待 App setup 完成,失败时返回失败结果并清理窗口。 - 新增 `pageScaleRange`,并完善渲染任务同步以及 camera/eraser 恢复。 ## 2.16.129 版 [#216129-版] 该版本于 2026 年 8 月 27 日发布。 ### 改进 [#改进-5] - 升级课件播放器,支持本地 GIF 播放、旧版 Safari 兼容和 WebGL 页面转场恢复。 ## 2.16.128 版 [#216128-版] 该版本于 2026 年 8 月 27 日发布。 ### 改进 [#改进-6] - 完善 Slide 页状态回调。 ### 问题修复 [#问题修复] - 修复冻结恢复闪烁和 Canvas/WebGL 播放器销毁问题。 ## 2.16.127 版 [#216127-版] 该版本于 2026 年 8 月 21 日发布。 ### 新增特性 [#新增特性-3] - 新增主动刷新尺寸、背景图查询和恢复能力。 ## 2.16.100 版 [#216100-版] 该版本于 2025 年 4 月 7 日发布。 :::info[桥接说明] 桥接的 Web SDK 已升级至 [v2.16.53](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/reference/release-notes-wb#21653-版)。 ::: ### 新增特性 [#新增特性-4] #### 高性能白板绘制工具 [#高性能白板绘制工具] 该版本新增 `appliance-plugin` 插件,实现了一套高性能的白板绘制工具。安装 `@netless/appliance-plugin` 后,你可以通过 `WhiteSdkConfiguration.enableAppliancePlugin` 配置项启用该插件。详见[`appliance-plugin`](https://github.com/netless-io/fastboard/blob/main/docs/zh/appliance-plugin.md)。 :::warning[注意] - `@netless/appliance-plugin` 为必需外部依赖,需要单独安装。 - 为确保笔迹正常显示,请在所有终端(Web、Android 和 iOS)上都开启 `appliance-plugin` 插件。如果某个终端未开启,其他终端使用 `appliance-plugin` 绘制的笔迹将无法在该终端显示。 - 开启 `appliance-plugin` 插件后,白板上的历史内容仍会显示,但无法对其进行操作或升级。为避免影响使用体验,建议在全新的白板上使用该插件。关闭插件后,使用该插件绘制的内容将会丢失。 ::: 开启 `appliance-plugin` 插件后,你可以: - 使用新增的激光铅笔工具 `LASER_PENCIL`,使用方式详见[`appliance-plugin`](https://github.com/netless-io/fastboard/blob/main/docs/zh/appliance-plugin.md#%E6%96%B0%E5%8A%9F%E8%83%BD)。 - 新增 `MemberState.strokeOpacity` 属性,用于更改线框透明度。 - 新增 `MemberState.fillOpacity` 属性,用于更改填充透明度。 - 新增 `MemberState.fillColor` 属性,用于更改填充颜色。 #### 处理 PPT 渲染错误 [#处理-ppt-渲染错误] 该版本新增 `SlideListener.onSlideError` 方法,用于监听 PPT 渲染错误。此外,发生 PPT 渲染错误时,你可以调用 `WhiteSdk.recoverSlide` 方法恢复 PPT 渲染。 ### API 变更 [#api-变更-2] #### 新增 [#新增-1] - `WhiteSdkConfiguration` 新增 `enableAppliancePlugin` - `MemberState` 新增以下属性: - `strokeOpacity` - `fillOpacity` - `fillColor` - `onSlideError` - `recoverSlide` ## 2.16.86 版 [#21686-版] 该版本于 2024 年 6 月 6 日发布。 :::info[桥接说明] 桥接的 Web SDK 已升级至 [v2.16.51](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/reference/release-notes-wb#21651-版)。 ::: ### 新增特性 [#新增特性-5] #### 接入域名预选 [#接入域名预选] 该版本新增 `prepareWhiteConnection` 方法,用于提前选择连接线路以加快首次加入白板方间的连接速度。 ### API 变更 [#api-变更-3] #### 新增 [#新增-2] - `prepareWhiteConnection` - `ConnectionPrepareParam` ## 2.16.81 版 [#21681-版] 该版本于 2024 年 3 月 13 日发布。 :::info[桥接说明] 桥接的 Web SDK 已升级至 [v2.16.48](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/reference/release-notes-wb#21648-版)。 ::: ### 新增特性 [#新增特性-6] #### 小窗应用管理 [#小窗应用管理] 在[多窗口模式](/zh-CN/realtime-media/whiteboard/concepts#多窗口模式)下,SDK 支持以新建窗口的方式插入 PPT 或白板插件等,它们统称为[小窗应用](/zh-CN/realtime-media/whiteboard/concepts#小窗应用)。该版本起,`Room` 对象新增以下方法用于在多窗口模式下管理小窗应用: - `addApp`:插入小窗应用,并返回应用 ID。 - `closeApp`:关闭指定小窗应用的窗口。 - `focusApp`:切换聚焦窗口为指定小窗应用的窗口。 - `queryApp`:查询指定小窗应用的信息。 - `queryAllApps`:查询当前所有小窗应用的信息。 #### 白板工具自定义 [#白板工具自定义] `MemberState` 新增以下属性用于自定义白板工具: - `textColor`:文本工具中文字的颜色。 - `pencilEraserSize`:铅笔橡皮工具的尺寸。 #### PPT 渲染配置新增 [#ppt-渲染配置新增] PPT 渲染配置项 `WhiteSdkConfiguration.SlideAppOptions` 新增了以下属性: - `minFPS`:设置 PPT 动画的最小帧率。 - `maxFPS`:设置 PPT 动画的最大帧率。 - `resolution`:设置 PPT 渲染分辨倍率。 - `maxResolutionLevel`:设置 PPT 最大分辨率。 - `bgColor`:设置 PPT 动画的背景色。 - `forceCanvas`:是否强制使用 2D 渲染,默认不开启。 - `enableGlobalClick`:是否可以通过点击 PPT 画面执行下一步功能,默认开启。 #### 白板绘制性能优化策略 [#白板绘制性能优化策略] `RoomParams` 新增 `optimizeOptions` 属性,用于设置白板绘制的性能优化策略。性能优化的方式包括以下三种: - 调整白板绘制的刷新间隔:刷新间隔越低,笔迹显示越流畅,性能开销越大;刷新间隔越高,笔迹越卡,性能消耗越少。 - 使用单画布绘制:白板默认使用两个画布交替绘制以避免在部分设备上绘制时可能出现的画面闪烁现象,使用单个画布绘制可以避免重绘,降低性能消耗。 - 使用浮动画布:书写场景下,启用单画布绘制后,会根据绘制位置生成一个大小约为 256 × 256 px 的浮动画布,后续绘制不超过该画布的范围时,同步绘制笔迹的范围会限定在这个浮动画布中,而不是同步整个画布,从而降低性能消耗。 #### 其他新增 [#其他新增] 该版本还新增了以下特性: - 新增 `updateText` 方法, 用于更新调用 `insertText` 插入的文本。 - 新增 `setSyncMode` 方法, 用于立即处理白板事件,绘制画笔。 - 新增 `setDisableInitialStateCallback` 方法, 用于禁止加入房间后的全量状态回调。 ### 问题修复 [#问题修复-1] 该版本修复了以下问题: - `WhiteWindowParams.fullscreen` 开启后,第二次打开 App 没有全屏。 - `WindowParams.fullscreen` 开启后偶现状态栏闪烁。 - 路径动画跳页后无法恢复到原位。 - 菱形填充会充满图形。 - 重连后,SDK 内置光标消失。 - 使用淡入淡出动画时偶现闪烁。 - SDK 内置光标在修改 `isWritable` 后消失。 ### API 变更 [#api-变更-4] #### 新增 [#新增-3] - `addApp` - `closeApp` - `focusApp` - `queryApp` - `queryAllApps` - `WindowAppSyncAttrs` - `MemberState` 新增 - `textColor` - `pencilEraserSize` - `SlideAppOptions` 新增 - `minFPS` - `maxFPS` - `resolution` - `maxResolutionLevel` - `bgColor` - `forceCanvas` - `enableGlobalClick` - `setSyncMode` - `updateText` - `setDisableInitialStateCallback` #### 修改 [#修改] - `insertText` ## 2.16.59 版 [#21659-版] 该版本于 2023 年 8 月 31 日发布。 :::info[桥接说明] 桥接的 Web SDK 已升级至 v2.16.42。 ::: ### 升级必看 [#升级必看] 该版本废弃了白板数据中心原有的英国伦敦数据中心(`Region.gb-lon`),并新增了欧洲法兰克福数据中心(`Region.eu`),服务区覆盖欧洲。如果你在之前版本中设置了 `Region.gb-lon`,请在升级到该版本后改用 `Region.eu`,并在控制台-互动白板服务配置中启用该数据中心。 ### 新增特性 [#新增特性-7] #### PPT 音量控制 [#ppt-音量控制] 该版本废新增 `getSlideVolume` 和 `updateSlideVolume` 方法用于获取和更新 PPT 内音频的音量。 #### PPT URL 拦截替换 [#ppt-url-拦截替换] `WhiteSdkConfiguration` 新增 `enableSlideInterrupterAPI` 配置项,用于开启 PPT 资源 URL 拦截替换功能。该功能可用于加密用户上传的 PPT 资源,保护用户隐私。 开启后,通过调用 `WhiteSdk.setSlideListener(SlideListener)` 实现 PPT 文件 URL 的拦截替换功能。 #### PPT 渲染提示 [#ppt-渲染提示] `WhiteSdkConfiguration` 新增 `whiteSlideAppParams` 配置项用于 [@netless/app-slide](https://github.com/netless-io/netless-app/tree/master/packages/app-slide) 渲染相关的显示配置。当前支持配置 `WhiteSlideAppParams.showRenderError`,用于配置显示/隐藏渲染错误提示。 #### 自定义 API 服务器域名 [#自定义-api-服务器域名] `WhiteSdkConfiguration` 新增 `apiHosts` 配置项, 用于配置白板的 API 服务器域名列表,可用于实现服务器代理。 #### 自定义模块源 [#自定义模块源] `RoomParams` 和 `PlayerConfiguration` 分别新增 `modulesOrigin` 配置项,用于配置白板请求模块(modules)数据的地址。 #### 文档操作事件 [#文档操作事件] 新增 `dispatchDocsEvent` 方法,用于向插入白板的 PDF/PPTX 文档发送事件,实现控制文档翻页、页面跳转和幻灯片动画播放。 ### 改进 [#改进-7] #### 优化插入文档 [#优化插入文档] 该版本优化了使用[新版文档转换服务](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/extend-whiteboard/convert-files)转换 PPT 文件并插入至白板的流程。 你可以使用新增的 `createSlideApp` 方法即可构建 `WindowAppParam` 对象,该对象包含 `ProjectorAttributes` 和 `ProjectorOptions`, 对应打开文档时传入的参数,详见 [`addApp`](https://github.com/netless-io/window-manager/blob/master/docs/basic.md#open-dynamicstatic-ppt)。 #### 窗口全屏 [#窗口全屏] 新增 `WindowParams.fullscreen` 属性, 用于控制窗口是否全屏。 ### 问题修复 [#问题修复-2] 该版本修复了新版 Android Studio 无法预览布局的问题。 ### API 变更 [#api-变更-5] #### 新增 [#新增-4] - `getSlideVolumeWithCompletionHandler` - `updateSlideVolume` - `WhiteSdkConfiguration` 中新增: - `enableSlideInterrupterAPI` - `whiteSlideAppParams` - `apiHosts` - `setSlideDelegate` - `RoomParams` 新增 `modulesOrigin` - `PlayerConfiguration` 新增 `modulesOrigin` - `dispatchDocsEvent` - `WindowDocsEvent` - `createSlideApp` - `ProjectorAttributes` - `ProjectorOptions` - `WindowAppParam` - `WindowParams.fullscreen` ## 2.16.42 版 [#21642-版] 该版本于 2022 年 12 月 2 日发布。 :::info[桥接说明] 桥接的 Web SDK 已升级至 [v2.16.37](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/reference/release-notes-wb#21637-版)。 ::: ### 新增特性 [#新增特性-8] #### 教具新特性 [#教具新特性] 该版本为以下白板教具添加了新特性: - 铅笔工具:支持画虚线。你需要设置 `room.memberState.dottedLine` 为 `true` 开启该功能。 - 文字工具:支持直接选择并编辑文字。你需要设置 `room.memberState.textCanSelectText` 为 `true` 以开启该功能。 此外,该版本还新增了铅笔橡皮工具,用于擦除局部铅笔笔迹。 #### 浮动条 [#浮动条] 该版本新增浮动条功能,选中任意白板元素即可弹出浮动条,方便用户快速编辑指定白板元素。例如,选中笔迹可以快速删除笔迹、调整位置、更变笔迹颜色等,选中文字可以快速删除文字、调整文字样式、修改字体等。你可以通过调用 `setUsingFloatBar` 方法启用浮动条功能。 ![浮动条功能示意图](https://web-cdn.agora.io/docs-files/1669884020024) #### 删除白板页 [#删除白板页] 该版本新增了 `removePage` 方法用于删除指定白板页。 #### 获取 PPT 日志 [#获取-ppt-日志] `WhiteSdk` 类新增 `requestSlideLog` 方法,用于客户端获取 PPT 日志,方便排查 PPT 相关问题。 #### 回放回调 [#回放回调] 为方便监听 `Player` 的状态变化,该版本在 `Player` 类中新增 `addPlayerListener` 和 `removePlayerListener` 方法,用于添加和删除白板回放回调。 ### 改进 [#改进-8] 该版本优化了 PPT 音频播放控制,现在可以通过调用 `AudioMixerBridge` 接口下新增的 `pauseAudioMixing` 和 `resumeAudioMixing` 方法,实现暂停和恢复播放动态 PPT 中的音频和混音。 ### 问题修复 [#问题修复-3] 该版本修复了如下问题: - 多窗口模式下 `sceneState` 变化时收不到回调。 - 重连后,白板 app 可能无法正确创建。 - 创建 app 时,无法正确同步白板初始宽度和高度。 - 切换只读/读写状态时可能导致 `mainView` 的 `disableCameraTransform` 配置丢失。 ### API 变更 [#api-变更-6] #### 新增 [#新增-5] - `MemberState` 类新增属性 `dottedLine` 和 `textCanSelectText` - `Appliance` 类新增属性 `PENCIL_ERASER` - `removePage` - `pauseAudioMixing` - `resumeAudioMixing` - `addPlayerListener` - `removePlayerListener` - `setUsingFloatBar` - `requestSlideLog` ## 2.16.21 版 [#21621-版] 该版本于 2022 年 7 月 8 日发布。 ### 升级必看 [#升级必看-1] #### SDK 集成变更 [#sdk-集成变更] 自 2.16.0 版本起,声网仅更新 `netless-io:whiteboard-android` GitHub 仓库,不再维护 `duty-os:white-sdk-android` GitHub 仓库。使用 JitPack 集成 2.16.0 版本之后的 SDK 时,你需要将 `/Gradle Scripts/build.gradle(Module: .app)` 文件中 `dependencies` 下的 `implementation` 字段修改为: ``` dependencies { implementation 'com.github.netless-io:whiteboard-android:' } ``` 详见[获取 SDK](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/reference/downloads)。 ### 新增特性 [#新增特性-9] #### 插入文字 [#插入文字] 该版本新增 `insertText` 方法,支持在指定位置插入文字。 #### 设置笔锋效果 [#设置笔锋效果] 该版本在 `WhiteSdkConfiguration` 类中新增 `setDisableNewPencilStroke` 方法,用于开启或关闭新铅笔的笔锋效果。该方法中 `disableNewPencilStrokeSDK` 参数的默认值为 `true`,当你调用 `setDisableNewPencil(false)` 开启新铅笔后,SDK 立即开启笔锋效果。如果需要关闭新铅笔的笔锋效果,可以设置 `setDisableNewPencilStroke(true)`。 同时,该版本在 `WhiteSdkConfiguration` 类中新增 `isDisableNewPencilStroke` 方法,用于查询笔锋效果的开启状态。 #### 获取场景信息 [#获取场景信息] 该版本在 `Displayer` 类中新增 `getScene` 方法,支持使用场景路径获取指定场景的信息。 #### 全链路加速 [#全链路加速] 自该版本起,声网互动白板服务集成并支持声网全链路加速(FPA)服务。集成声网 Whiteboard SDK 后,你只需调用 `setUseNativeWebSocket(true)`,即可在互动白板应用中开启全链路加速服务,提升传输质量。 ### 改进 [#改进-9] 该版本进行了如下改进: - 为新铅笔工具添加补间动画。当用户使用新铅笔书写时,SDK 会自动在关键帧之间插入帧,使远端用户看到的笔迹绘制过程更加流畅。要体验该优化,请确保你已调用 `setDisableNewPencil(false)` 开启新铅笔工具。 - 优化了在 Android 浏览器上的书写性能。 - 优化了弱网环境下的重连机制,减少不必要的重连。 ### 问题修复 [#问题修复-4] 该版本修复了如下问题: - 放缩、移动视角后,偶现画面出现偏移、重影。 - 偶现动态 PPT 在断线重连后无法翻页。 - 刚加入房间时,如果白板上已经有内容,可能显示不全。 - SDK 断线重连后可能会发生内存泄漏。 - 反复调用 `setWritable` 时可能会发生错误。 - 用户切换为只读模式,再切换回读写模式并写写画画时,远端用户看到该用户的光标是固定的。 ### API 变更 [#api-变更-7] #### 新增 [#新增-6] - `insertText` - `setDisableNewPencilStroke` - `isDisableNewPencilStroke` - `getScene` ## 2.15.24 版 [#21524-版] 该版本于 2022 年 1 月 21 日发布。 该版本进行了如下改进: - 更新封装的 `white-web-sdk` 至 2.15.16 版。 - 优化 `getSceneSnapshotImage` 和 `getScenePreviewImage` 方法,确保在截图中正常显示场景中插入的图片。 ## 2.15.0 版 [#2150-版] 该版本于 2021 年 11 月 16 日发布。 ### 升级必看 [#升级必看-2] 为方便管理房间内的用户,该版本在 `RoomParams` 中新增 `uid` 参数,用于设置用户 ID。 如果你将 SDK 升级到 v2.15.0 或之后版本,为保证你的业务功能不受影响,调用 `joinRoom` 时必须在 `RoomParams` 传入字符串格式的 `uid`,长度不超过 1024 字节,并确保同一房间内每个用户的 `uid` 唯一。详见[加入实时房间](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/get-started/join-room-wb)。 ### 新增特性 [#新增特性-10] 该版本新增支持转换和展示如下 PowerPoint(PPT)特性: - 动作按钮 - 母版动画 ### 改进 [#改进-10] 该版本进行了如下改进: - 更新封装的 `white-web-sdk` 至 2.15.1 版。 - 进一步优化书写体验。 ### 问题修复 [#问题修复-5] 该版本修复了在白板中展示动态 PPT 时遇到的如下问题: - 偶现的图片位置偏移 - 部分样式读取失败导致的白屏 - 部分文字旋转角度和颜色错误 - 带有动画效果的元素可能不出现 - 文字的动画效果表现不正确 ### API 变更 [#api-变更-8] #### 修改 [#修改-1] - RoomParams [1/3] - RoomParams [2/3] - RoomParams [3/3] ## 2.14.3 版 [#2143-版] 该版本于 2021 年 10 月 21 日发布。 ### 升级必看 [#升级必看-3] 自该版本起,互动白板 Android SDK 支持的最低平台要求变更如下: - Android 4.4 变更为 Android 5.0 - Android SDK API level 19 变更为 Android SDK API level 21 ### 改进 [#改进-11] 该版本进行了如下优化: - 更新封装的 `white-web-sdk` 至 2.14.5 版。 - 持续优化书写性能。 - 优化书写笔迹的形态。 - 提高 `onPhaseChanged` 回调的准确性。 - 隐藏动态 PPT 母版中不应该显示的元素。 ### 问题修复 [#问题修复-6] 该版本修复了如下问题: - 切换到抓手工具后,无法切换回光标。 - 书写过程中偶现的笔迹突然消失。 - 书写时偶现的笔迹带有不自然的水滴状笔锋。 - 手动缩放文本框后再编辑文字,文本框和文字复原到原来的大小。 - 在部分设备上窗口尺寸发生变化后,视角出现异常。 - 快速拖动橡皮擦时,橡皮擦的图标放大效果和快速删除功能失效。 - 偶现的动态 PPT 中多个音频文件同时播放。 - 动态 PPT 返回上一页后动画显示异常。 - 动态 PPT 中带动画的文本框偶现镜像翻转。 ## 2.13.22 版 [#21322-版] 该版本于 2021 年 8 月 20 日发布。 ### 新增特性 [#新增特性-11] 该版本新增如下特性: - 在 `CommonCallback` 接口中新增 `onLogger` 回调,用于获取 SDK 输出的本地调试日志。 - 为完善动态文档转换功能,该版本新增支持转换和展示如下 PowerPoint(PPT)特性: - 对文本按段落添加动画。 - 对文本添加的动画可逐字或逐词显示。 - 所有的表格预设样式。 - 小于 12 px 的文字。 ### 改进 [#改进-12] 该版本更新封装的 `white-web-sdk` 至 2.13.17 版。 ### 问题修复 [#问题修复-7] 该版本修复了如下问题: - `onLogger` 和 `onMessage` 回调不生效。 - 偶现的加入房间时,房间一直卡在 `connecting` 状态。 - 断线重连后,部分用户的光标消失。 - 断线重连后,部分插件的状态出现混乱。 - 抓手工具不受设置的视角边界的限制。 - 在某些高分辨率的设备上,当用户处于跟随模式时,视角的中心点出现轻微偏移。 - 在白板中展示动态 PPT 时遇到的如下问题: - 段间距显示不正确 - 文本分栏无效 - 使用幻灯片背景填充形状时显示不正确 - 悬挂缩进异常 - 动画回退后显示异常 - 文字编号错误 - 转换后公式显示不全 - 部分换行不正确 - 从右往左书写的文字(如阿拉伯文)显示异常 ## 2.13.17 版 [#21317-版] 该版本于 2021 年 7 月 23 日发布。 ### 新增特性 [#新增特性-12] 为完善动态文档转换功能,该版本新增支持转换和展示如下 PowerPoint(PPT)特性: - 反转路径方向动画效果 - 纵向文本框 - Microsoft 公式编辑器 3.0 - 母版隐藏背景图形 - 编辑图片颜色 - 部分图片效果: - 金属框架 - 柔化边缘矩形 - 双框架,黑色 - 厚重哑光,黑色 - 简单框架,黑色 - 中等复杂框架,黑色 - 居中矩形阴影 - 柔化边缘椭圆 - 金属圆角矩形 - 金属椭圆 ### 改进 [#改进-13] 该版本进行了如下优化: - 更新封装的 `white-web-sdk` 至 2.13.11 版。 - 更新封装的 `@netless/video-js-plugin` 至 0.3.3 版本。 - 降低了播放动态 PPT 动画时占用的 CPU。 - 提升了在白板上书写绘画的流畅度。 - 为提升时间同步的准确性,将 `setTimeDelay` 方法中 `delaySec` 参数的数据类型由 Integer 改为 Double。 - 打印的日志中包含场景变更信息。 - 在 `PptPage` 中新增 `preview` 参数,支持在白板场景中展示动态 PPT 预览图。 ### 问题修复 [#问题修复-8] 该版本修复了如下问题: - 调整视角时偶现的白板清晰度异常。 - 偶现的用户进入房间后无法画出第一笔线。 - 偶现的 `refreshViewSize` 调用不生效。 - 在白板中展示动态 PPT 时遇到的如下问题: - 动画未按设置的顺序播放。 - 动画播放后未按设置隐藏。 - 表格高度显示异常。 - 无法显示占位符中插入图片。 - 部分形状绘制错误。 - 文字缩进错误。 - 无法点击动画触发器。 - 图片透明度过大。 ## 2.13.4 版 [#2134-版] 该版本于 2021 年 6 月 15 日发布。 该版本更新 `white-web-sdk` 至 2.13.4。 ## 2.13.2 版 [#2132-版] 该版本于 2021 年 6 月 11 日发布。 该版本更新 `white-web-sdk` 至 2.13.3。 ## 2.13.1 版 [#2131-版] 该版本于 2021 年 6 月 11 日发布。 #### 改进 [#改进-14] 该版本更新 `white-web-sdk` 至 2.13.2。 #### 问题修复 [#问题修复-9] 该版本修复了 `disableDeviceInputs` 设为 `true` 时,用户可能仍然可以操作 iframe 插件的问题。 ## 2.12.36 版 [#21236-版] 该版本于 2021 年 6 月 8 日发布。 该版本修复的问题如下: 主播模式的用户在使用点选工具(`Clicker`)时,如果对 HTML5 课件进行缩放,会导致跟随模式的用户看到的课件内容不完整。 ## 2.12.35 版 [#21235-版] 该版本于 2021 年 6 月 7 日发布。 该版本更新 [`@netless/cursor-tool `](https://www.npmjs.com/package/@netless/cursor-tool)至 0.1.0,并且更新 `@netless/iframe-bridge `至 2.1.2。 ## 2.12.34 版 [#21234-版] 该版本于 2021 年 6 月 4 日发布。 该版本更新 `white-web-sdk `至 2.12.21。 ## 2.12.33 版 [#21233-版] 该版本于 2021 年 6 月 3 日发布。 该版本更新 [`@netless/video-js-plugin`](https://www.npmjs.com/package/@netless/video-js-plugin) 至 0.1.5。 ## 2.12.32 版 [#21232-版] 该版本于 2021 年 6 月 2 日发布。 该版本修复了 `video-js-plugin` 插件在白板上无法显示的问题。 ## 2.12.31 版 [#21231-版] 该版本于 2021 年 6 月 1 日发布。 该版本更新 [`@netless/video-js-plugin`](https://www.npmjs.com/package/@netless/video-js-plugin)至 0.1.3,修复了 video-js-plugin 和低版本 Android 系统的 WebView 不兼容的问题。 ## 2.12.30 版 [#21230-版] 该版本于 2021 年 5 月 25 日发布。 该版本更新 [`@netless/cursor-tool`](https://www.npmjs.com/package/@netless/cursor-tool) 至 0.0.9。 ## 2.12.29 版 [#21229-版] 该版本于 2021 年 5 月 24 日发布。 ### 新增特性 [#新增特性-13] 该版本集成 [`@netless/video-js-plugin`](https://www.npmjs.com/package/@netless/video-js-plugin) 插件,用于在 Android 端观看 Web 端白板上播放的视频。支持的视频格式包括 M3U8 等。 ### 改进 [#改进-15] 该版本更新 `white-web-sdk `至 2.12.20。 ## 2.12.28 版 [#21228-版] 该版本于 2021 年 5 月 20 日发布。 该版本更新 `white-web-sdk `至 2.12.19。 ## 2.12.27 版 [#21227-版] 该版本于 2021 年 5 月 17 日发布。 该版本有以下改进: - 更新 `white-web-sdk `至 2.12.18。 - 服务端排版(`useServerWrap`)由默认关闭改为默认开启。开启服务端排版后,服务端会裁剪字体包的体积,提高渲染速度。 ## 2.12.26 版 [#21226-版] 该版本于 2021 年 5 月 13 日发布。 该版本新增以下特性: - `Appliance` 新增点选工具 (`Clicker`),用于 H5 课件的操作和交互。 - `MemberState` 新增 `ShapeType`,支持设置图形工具。目前支持的图形包括三角形、菱形、五角星、对话气泡。 - `Room` 类新增 `syncBlockTimestamp` 方法,用于设置发送白板内容的延时,保证白板内容与音视频同步。 - 更新 `white-web-sdk `至 2.12.17。 ## 2.12.25 版 [#21225-版] 该版本于 2021 年 4 月 28 日发布。 该版本更新 [`@netless/white-audio-plugin2`](https://github.com/netless-io/whiteboard-demo/tree/master/packages/white-audio-plugin) 和 [`@netless/white-video-plugin2`](https://github.com/netless-io/react-whiteboard/tree/master/packages/white-video-plugin) 插件,修复了部分显示问题。 ## 2.12.24 版 [#21224-版] 该版本于 2021 年 4 月 27 日发布。 ### 新增特性 [#新增特性-14] 该版本支持 [`@netless/white-audio-plugin2`](https://github.com/netless-io/whiteboard-demo/tree/master/packages/white-audio-plugin) 和 [`@netless/white-video-plugin2`](https://github.com/netless-io/react-whiteboard/tree/master/packages/white-video-plugin),用于在 Android 端观看 Web 端白板上播放的音频或视频。 ### 问题修复 [#问题修复-10] - 更新 `@netless/white-audio-plugin` 至 1.2.23,修复了白板回放中音频文件的显示问题。 - 修复了 `getRoomState` 异步方法没有回调的问题。 ## 2.12.22 版 [#21222-版] 该版本于 2021 年 4 月 22 日发布。 该版本更新 `white-web-sdk` 至 2.12.14。 ## 2.12.21 版 [#21221-版] 该版本于 2021 年 4 月 22 日发布。 该版本有以下改进: - 更改 `RoomListener` 和 `PlayerListener` 为主线程回调。 - 更新 `white-web-sdk` 至 2.12.13。 - 更新 `@netless/iframe-bridge` 至 2.12.17,优化了白板回放的 iframe 插件逻辑。 ## 2.12.20 版 [#21220-版] 该版本于 2021 年 4 月 17 日发布。 该版本更新 `white-web-sdk` 至 2.12.12。 ## 2.12.19 版 [#21219-版] 该版本于 2021 年 4 月 14 日发布。 该版本有以下改进: - 新增 `PptParams` 的构造方法,无需配置 `scheme` 参数。 - 更新 `@netless/iframe-bridge` 至 2.0.14,优化了 iframe 插件。 ## 2.12.18 版 [#21218-版] 该版本于 2021 年 4 月 12 日发布。 该版本更新 `@netless/iframe-bridge` 至 2.0.13,优化了消息通知。 ## 2.12.17 版 [#21217-版] 该版本于 2021 年 4 月 12 日发布。 该版本更新 `@netless/iframe-bridge` 至 2.0.11,优化了 Android 端的显示问题。 ## 2.12.16 版 [#21216-版] 该版本于 2021 年 4 月 9 日发布。 该版本更新 `@netless/iframe-bridge` 至 2.0.10,优化了 Android 端的显示问题。 ## 2.12.15 版 [#21215-版] 该版本于 2021 年 4 月 10 日发布。 该版本更新 `white-web-sdk` 至 2.12.9。 ## 2.12.14 版 [#21214-版] 该版本于 2021 年 4 月 9 日发布。 该版本更新 `@netless/iframe-bridge` 至 2.0.9,修复了 H5 课件的显示问题。 ## 2.12.13 版 [#21213-版] 该版本于 2021 年 4 月 9 日发布。 该版本恢复了 `Displayer` 接口的 `scaleIframeToFit` 方法。 ## 2.12.12 版 [#21212-版] 该版本于 2021 年 4 月 9 日发布。 该版本更新 `@netless/iframe-bridge` 至 2.0.8,修复了 H5 课件的显示问题。 ## 2.12.11 版 [#21211-版] 该版本于 2021 年 4 月 6 日发布。 该版本更新 `white-web-sdk` 至 2.12.8,修复了设置跟随者模式无法立即生效的问题。 ## 2.12.10 版 [#21210-版] 该版本于 2021 年 4 月 2 日发布。 该版本更新 `white-web-sdk` 至 2.12.7,优化了动态 PPT 的显示。 ## 2.12.9 版 [#2129-版] 该版本于 2021 年 3 月 30 日发布。 该版本更新 `@netless/iframe-bridge` 至 2.0.7。 ## 2.12.8 版 [#2128-版] 该版本于 2021 年 3 月 30 日发布。 该版本更新 `white-web-sdk` 至 2.12.6。 ## 2.12.7 版 [#2127-版] 该版本于 2021 年 3 月 25 日发布。 该版本更新 `@netless/iframe-bridge` 至 2.0.5,优化白板回放时的 H5 课件展示。 ## 2.12.6 版 [#2126-版] 该版本于 2021 年 3 月 25 日发布。 该版本在 `Displayer` 类中新增 `scaleIframeToFit` 方法,支持等比例缩放视角,以保证完整显示 H5 课件的内容。 ## 2.12.5 版 [#2125-版] 该版本于 2021 年 3 月 25 日发布。 该版本更新 [`@netless/cursor-tool`](https://github.com/netless-io/whiteboard-demo/tree/master/packages/cursor-tool) 至 0.0.7。 ## 2.12.3 版 [#2123-版] 该版本于 2021 年 3 月 20 日发布。 为解决笔锋效果与 2.2.12 之前版本 SDK 不兼容的问题,该版本将 `setDisableNewPencil` 方法的 `disableNewPencil` 参数默认值由 `false` 改为 `true`,以默认关闭笔锋效果。 :::warning[注意] 为正常显示笔迹,在开启笔峰效果前,请确保该房间内的所有用户使用如下 SDK: - Android SDK 2.12.3 版或之后 - iOS SDK 2.12.3 版或之后 - Web SDK 2.12.5 版或之后 ::: ## 2.12.2 版 [#2122-版] 该版本于 2021 年 3 月 16 日发布。 ### 新增特性 [#新增特性-15] 为优化笔迹显示,该版本新增笔锋效果。你可以调用 `setDisableNewPencil` 关闭或开启笔锋效果;调用 `isDisableNewPencil` 获取是否开启笔锋效果。 :::warning[注意] 为正常显示笔迹,在开启笔峰效果前,请确保该房间内的所有用户使用如下 SDK: - Android SDK 2.12.2 版或之后 - iOS SDK 2.12.3 版或之后 - Web SDK 2.12.5 版或之后 ::: ### 改进 [#改进-16] - 更新 `white-web-sdk` 至 2.12.4 版本,优化 PPT 显示逻辑。 - 优化音视频插件在白板回放时的按钮显示。 ### 问题修复 [#问题修复-11] 修复 `debug` 模式下,实时房间异常回调导致的崩溃问题。 ## 2.12.2 版之前 [#2122-版之前] 关于更多版本的发版说明,详见[发版说明](https://developer.netless.link/android-zh/home/android-changelog)。 :::warning[注意] 2.6.4 及之前版本已经停止维护,建议升级到最新版本。 :::