本文介绍网易云信互动白板 Web 端 SDK 的更新日志。具体功能请前往 下载 SDK 体验 和 查看 API 文档。

3.9.15 (2025-04-22)

通过调用新的 API setStrokeCursor 来自定义涂鸦（直线）和图形绘制时的鼠标样式，让鼠标指针在绘制过程中显示为不同的形状，例如箭头、画笔图标等。

新增 API

API	说明
setStrokeCursor	设置涂鸦（直线）、图形的鼠标样式。

3.9.13 (2024-07-10)

变更 API

API	说明
drawPlugin.exportAsImage	content 新增 region 模式，支持导出白板中任意区域。
drawPlugin.exportAsBase64String	content 新增 region 模式，支持导出白板中任意区域。

问题优化

• 优化调整页面大小时的坐标变动的体验。

3.9.12 (2024-04-26)

新增特性

• PPT 中音视频播放控制器改为鼠标悬浮出现。

问题修复

• 修复若干个 PPT 中音视频播放问题。

3.9.11 (2024-04-08)

问题修复

• 优化视频播放是宽高不合理导致出现重影的问题。
• 修复上传弹窗缺少底部 footer。
• 修复出现动画特效被删除的异常。
• 优化多个媒体资源切换播放时的抖动问题。

3.9.10 (2023-09-18)

问题修复

修复当网页处于前台或后台运行时，推流的帧率不一致的问题。

3.9.9 (2023-09-01)

变更 API

API	说明
drawPlugin.setAppConfig	新增 deleteBoardBehavior 属性，控制删除 board 后的跳转逻辑。

问题修复

• 修复视频最大化时位置错误的问题。
• 修复偶现音视频未停止播放的问题。
• 修复 docConverter 可能会清空 localStorage 的异常。
• 修复删除 board 后的跳转逻辑。

3.9.8 (2023-08-09)

新增特性

• 支持将白板内容导出为文件。

• 支持通过 URL 导入白板内容。

• 白板视频添加最大化按钮。

• 支持通过 API 弹出预览窗口和资源弹窗。

问题修复

• 修复推流时，页面退至背景时断流的问题。
• 修复调用 joinRoom 结束后，白板处于同步中状态的问题。

新增 API

API	说明
drawPlugin.exportBoards	导出白板内容。
drawPlugin.importBoards	导入白板内容。

变更 API

API	说明
drawPlugin.setAppConfig	新增 showImportProgress，workerTimerInterval 等属性。
drawPlugin.on	新增 event:importBoard 事件。
toolCollection.setCompVisibility	新增接口打开/关闭部分工具栏组件。
toolCollection.on	新增 compVisibilityUpdate 事件。
toolCollection.off	新增 compVisibilityUpdate 事件。

3.9.7 (2023-08-01)

新增特性

• 支持白板推流设置 FPS。
• 支持设置最大和最小缩放比例。
• 音视频转码模板支持使用 SD、HD、SHD、UHD 任意格式。
• 产物中提供 TypeScript 声明文件。
• 支持设置默认白板显示名称。

问题修复

• 修复 Safari 中 PPT 视频单击无效的问题。
• 修复推流时 CPU 占用率高的问题。
• 修复推流时偶尔出现黑帧的问题。

优化

• 文档默认 100%缩放比为文档撑满页面的大小。

变更 API

API	说明
WhiteBoardSDK.getStream	新增 frameRate 属性。
drawPlugin.setAppConfig	新增 cameraMaxZoom、cameraMinZoom、defaultBoardName 等属性。

3.9.6 (2023-06-12)

问题修复

• 修复开启防盗链后，音视频上传后转码。

3.9.5 (2023-06-02)

新增特性

• 新增防盗链支持。
• 新增资源下载地址私有化配置。

问题修复

• 修复图片在不同设备旋转角度不一致偶现问题。
• 修复预览窗口视频未显示问题。
• 修复 iOS 中预览窗口页码更新问题。

变更 API

API	说明
WhiteBoardSDK.getInstance	新增 getAntiLeechInfo 获取防盗链参数。新增 drawPluginParams.appConfig，设置 drawPlugin 初始化参数。
drawPlugin.setAppConfig	新增参数 nosAntiLeech。新增参数 nosAntiLeechExpire。
drawPlugin.addImage	新增参数 antiLeechProp
drawPlugin.addAudio	新增参数 antiLeechProp
drawPlugin.addVideo	新增参数 antiLeechProp
drawPlugin.setPageBackground	新增参数 antiLeechProp
drawPlugin.isCameraReady	新增函数 isCameraReady。在初始化视角调整后，isCameraReady 返回 true
drawPlugin.getResourceMetadata	根据 url 获取资源的加载情况。
drawPlugin.on	新增 'event:resource:onload' 回调。新增。

3.9.4 (2022-12-02)

新增特性

• 新增宏教具，支持添加自定义图章、预设置文本等。
• 新增自定义弹窗按钮。

问题修复

• 修复大量图形组合时的偶现问题。
• 修复断网时涂鸦的偶现同步问题。

变更 API

API	说明
drawPlugin.setTool	新增 macro 教具。新增 payload 参数，支持宏教具预设置内容。
ICustomPopup	新增自定义弹窗按钮。

3.9.3 (2022-11-04)

新增特性

• 支持笔锋效果。
• 支持 PPT 中音视频播放及同步。

优化

• 始终显示音视频的播放控制栏。
• 优化移动端流程图的热区范围。

问题修复

• 修复移动端流程图双击热区无反应问题。
• Safari 特定版本导出图片异常时，给出错误提示。
• 修复音视频播放的音量未保存问题。
• 修复安卓 5 设置中，PPT 动画播放过慢问题。

变更 API

API	说明
drawPlugin.setAppConfig	新增 uniqueDocName 参数，支持设置是否禁止导入同名文档。
drawPlugin.showToast	msgType 中新增 EXPORT_IMG_ERROR 类型，表示导出图片时捕获到异常。

3.9.2 (2022-10-20)

新增特性

• 支持 LBS，优化海外进入房间速度。
• 支持中文、英文切换。

优化

• 优化对齐辅助线的流畅度。

问题修复

• 修复导出 pdf 时的资源超时逻辑问题。

变更 API

API	说明
WhiteBoardSDK.getInstance	新增 lang 参数，支持设置语言为中文，或者英文。
jsJoinWB	webview 登录时，支持配置 lang 参数，支持配置语言为中文，或者英文。

3.9.1 (2022-09-16)

新增特性

• 支持客户端创建持久化房间。
• 支持通过方向键移动图形。
• 支持录像回放时，改变视角位置。
• 支持音视频转码为通用格式后添加至白板中。
• 支持音视频、文档资源本地缓存。

优化

• 优化音视频添加后的视角位置。
• 优化录像文件生成逻辑。

变更 API

API	说明
drawPlugin.setAppConfig	新增 cacheUploadDocs、presetId、videoFitStrategy、audioFitStrategy 等参数。
toolCollection.on	docAdd、docDelete 函数新增第二个参数 allDocs。
工具栏配置	docUpload 新增 supportUploadMedia、supportTransMedia。

3.9.0 (2022-08-19)

新增特性

• 支持浮动工具栏修改元素属性。
• 支持流程图编辑。
• 支持多种文本字体。
• 支持图形内编辑文本。

新增 API

API	说明
drawPlugin.setFontFamiles	设置字体列表。
drawPlugin.getFontFamilies	获取字体列表。
drawPlugin.setStrokeColor	设置涂鸦、图形、连接的颜色。

移除 API

API	说明
drawPlugin.getStrokeWidth	该接口已废弃，请使用新接口drawPlugin.getDefStyle
drawPlugin.getOpacity	该接口已废弃，请使用新接口drawPlugin.getDefStyle
drawPlugin.getColor	该接口已废弃，请使用新接口drawPlugin.getDefStyle
drawPlugin.setFontFamily	该接口已废弃，请使用新接口drawPlugin.setFontFamiles

变更 API

API	说明
drawPlugin.addImage	移除 width，height 参数。
drawPlugin.addVideo	移除 width 参数。
drawPlugin.setStrokeWidth	增加参数，指定线段宽度是指涂鸦、图形还是连接。
工具栏配置	移除 opacity、platte、widthResize。

3.8.7 (2022-07-19)

新增特性

• 支持粘贴文本、图片到白板中。
• 预览弹窗打开时，滑动到当前页。

问题修复

• 修复视频 codec 不支持时的视频显示问题。
• 修复若干其他问题。

3.8.6 (2022-05-30)

新增 API

API	说明
drawPlugin.setElementsVisibility	设置显示或者隐藏页面中元素。

变更 API

API	说明
drawPlugin.getPageElementInfos	3.8.5 新增接口 getVisibleElementInfos 变更为 getPageElementInfos。
drawPlugin.setAppConfig	支持设置图片跨域加载策略，以及重试间隔时间。

3.8.5 (2022-05-17)

新增特性

转码文档提供多个备选域名。

新增 API

API	说明
drawPlugin.getVisibleElementInfos	返回当前页面显示元素的信息。
drawPlugin.rotateElement	旋转指定元素。

3.8.4 (2022-04-18)

• 选择功能支持交叉选择与包含选择两种模式。

3.8.3 (2022-04-11)

• 支持图形旋转。

3.8.2 (2022-03-18)

• 支持导出当前文档为 pdf

3.8.1 (2022-03-07)

• 减小 PPTRenderer.js 脚本体积。

3.8.0 (2022-03-04)

• 支持合并连续涂鸦。
• 支持添加页面插件。
• 优化网络不稳定时的连接。
• 修复若干缺陷。

3.7.7 (2022-01-21)

• 日志上传返回 promise
• 修复容器挂载顺序影响初始视角的问题。
• 修复白板快捷键和外部冲突问题。
• 优化进入房间时的连接逻辑。
• 优化日志。
• 优化曲线箭头。

3.7.6 (2022-01-13)

• 支持跳转到指定动画位置。

3.7.5 (2021-12-29)

• 转码 SDK 支持查询转码进度。
• 转码 SDK 上传结束后，返回文档下载地址。
• 修复旧版本产生的录制文件，在新版本播放时，视角跟随未生效的问题。

3.7.4 (2021-12-24)

• 修复移动端部分触屏问题。

3.7.3 (2021-12-23)

• 支持兼容安卓 5
• 支持白板与被标注物同步模式。
• 加入房间后，以内容的中点作为初始坐标原点。
• 修复背景透明无法穿透的问题。
• 修复部分浏览器中的触摸板交互问题。
• 修复部分录像回放的问题。

3.7.2 (2021-12-14)

• 修复主播离开后，未释放视角同步的缺陷。
• 修复激光笔显示问题。
• 修复部分其他已知问题。

3.7.1 (2021-12-01)

• 修复加入房间时，调整容器大小可能导致的问题。

3.7.0 (2021-11-26)

• 添加移动端手势支持。
• 支持设置自定义背景渲染函数。
• 文档初始缩放值设置为 100%
• 优化静态文档加载策略。
• 优化部分资源在网路不稳定时的上传逻辑。

3.6.2 (2021-11-17)

• 修复静态文档的协议未转换为 https 的缺陷。

3.6.1 (2021-11-16)

• 优化静态文档加载速度。
• 预览窗口提供 fitDoc 与 fitContainer 两种模式。

3.6.0 (2021-11-05)

• 支持定制 Toast 文案，类型，时间，以及是否显示。
• 支持配置是否允许抢占主播。
• 支持导出当前页面全部内容为图片。
• 支持客户端监听自定义工具栏按钮事件。
• PPT 动画优化。
• PPT 资源加载优化。

3.5.3 (2021-10-19)

• 修复导出图片时，没有设置背景色的问题。

3.5.2 (2021-09-30)

• 添加 updateStream 方法，可以在不停止当前白板推流 track 时，更新白板推流的分辨率。
• 修复推流部分已知问题。

3.5.1 (2021-09-26)

• 修复白板推流时，课件渲染的问题。

3.5.0 (2021-09-17)

• 添加白板推流方法，可以使用白板转为视频流数据。
• 激光笔，选择框和鼠标的昵称默认隐藏。
• 修复若干已知问题。

3.4.0 (2021-08-26)

• 支持动态 PPT 转码播放。
• 添加客户端文档转码接口。
• 移除工具栏中 docDeleteClick 接口。
• G1 白板的文档转码结果不再与 IM 账号关联，转码结果与账号之间的关系需要开发者自行管理。
• webview 添加房间状态变化的回调(是否连接，是否同步)
• jsGetState 被废弃，相关功能集成到了 jsDirectCall 中。

3.3.0 (2021-08-05)

• 支持用户接入自定义账号体系。
• 支持万人白板房间。

3.2.2 (2021-08-02)

• 修复音视频客户端播放的缺陷若干。
• getPageInfos 支持查询指定 board 的信息。
• 修复工具栏中 margin 设置无效的缺陷。

3.2.1 (2021-07-08)

• 录像回放支持设置开始时间和结束时间。
• 支持通过回调监听文档弹窗内文档变化。
• 支持通过函数调用添加，或者删除文档弹窗内的文档。
• 修复部分场景下，选中元素无法拖拽的缺陷。
• 修复关闭页面后，音视频继续播放的缺陷。

3.2.0 (2021-06-06)

• 支持白板中添加视频组件。
• 支持开发者自定义图形。

3.1.4 (2021-04-30)

• 修复部分安卓 9 机型无法同步的缺陷。
• 修复工具栏按钮样式重叠问题。

3.1.3 (2021-04-29)

• 修复白板 resize 时宽度计算问题。

3.1.2 (2021-04-21)

• 支持开发者配置调色盘的颜色。
• 支持开发者配置画笔粗细工具的最小，最大，以及粗细的间隔值。
• 支持开发者配置图形选择中包含哪些元素。

3.1.1 (2021-04-14)

SDK：

• 修复跨域图片不显示的问题。
• 修复容器大小变化时的一些缺陷。
• 修复关闭编辑时，文本框工具栏未隐藏的缺陷。
• 修复跳页后，文本框会跳页显示的缺陷。
• 支持图片上传 base64
• SDK 开放选择本地图片接口。
• 优化预览的性能。
• 增强了手写板的性能。
• 增加了涂鸦贝塞尔平滑处理。
• 支持配置字体。
• 工具栏支持自定义按钮。
• 工具栏支持日志上报按钮。
• 支持设置初始相机位置。
• 页面变化时，添加 activeIndex 字段。
• jsDirectCall 添加参数 funcName 和 args, arg1, arg2, ..., arg5。新参数具有更清晰的语义。旧参数 action, params, param1, ..., param5 保持兼容。
• jsGetState 添加参数 funcName、旧参数 action 保持兼容。
• 支持容器 resize 时，配置是保持缩放比例不变，还是保持容器内容不变。

3.1.0 (2021-03-31)

SDK：

• 支持画布缩放及平移。
• 支持跟随视角和自由视角切换。
• 支持 word 文档转成图片。

webview：

• 支持画布缩放及平移。
• 支持跟随视角和自由视角切换。
• 支持白板另存为图片。
• 支持绘制时标注绘制人昵称。

3.0.2 (2021-01-27)

SDK：

• 支持图片上传。
• 修改文档：SDK 信令抛出 error 时，不要断开连接，此时可能可以重连成功。

webview：

• 支持工具栏配置教具。
• 支持图片上传。
• 添加日志上报功能。

3.0.1 (2021-01-25)

SDK：

• 修复工具栏横屏时的显示缺陷。

webview：

• 修复重连时会抛出 WebError 的缺陷。
• 修复有时重新进入 webview 时，无法初始化的缺陷。
• 同步数据时添加 Toast 提示。

3.0.0 (2021-01-20)

新增功能

画布功能：

• 支持设置画笔颜色。
• 支持设置白板背景。

白板工具：

• 框选/移动/缩放：支持在白板上框选多个笔迹、移动笔迹显示位置，缩放笔迹显示大小。
• 复制/粘贴：支持将白板上的笔迹复制粘贴到其他白板上。
• 直线/箭头：支持在白板上绘制直线、箭头图形，可以设置粗细和颜色。
• 文本编辑：支持对白板上已绘制文本进行二次编辑文本大小和颜色。

白板管理：

• 多页白板：支持管理多个白板（包括添加、删除、选择）。

优化功能

• 重构绘制插件 DrawPlugin，提高白板功能扩展性。
• 修复了白板房间断网重连导致笔迹丢失的问题。