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

3.9.13 (2024-07-10)

变更 API

序号	API	API 说明
1	drawPlugin.exportAsImage	content 新增 region 模式，支持导出白板中任意区域。
2	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	API 说明
1	drawPlugin.setAppConfig	新增 deleteBoardBehavior 属性，控制删除 board 后的跳转逻辑。

问题修复

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

3.9.8 (2023-08-09)

新增特性

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

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

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

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

问题修复

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

新增 API

序号	API	API 说明
1	drawPlugin.exportBoards	导出白板内容。
2	drawPlugin.importBoards	导入白板内容。

变更 API

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

3.9.7 (2023-08-01)

新增特性

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

问题修复

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

优化

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

变更 API

序号	API	API 说明
1	WhiteBoardSDK.getStream	新增 frameRate 属性。
2	drawPlugin.setAppConfig	新增 cameraMaxZoom, cameraMinZoom, defaultBoardName 等属性。

3.9.6 (2023-06-12)

问题修复

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

3.9.5 (2023-06-02)

新增特性

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

问题修复

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

变更 API

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

3.9.4 (2022-12-02)

新增特性

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

问题修复

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

变更 API

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

3.9.3 (2022-11-04)

新增特性

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

优化

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

问题修复

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

变更 API

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

3.9.2 (2022-10-20)

新增特性

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

优化

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

问题修复

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

变更 API

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

3.9.1 (2022-09-16)

新增特性

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

优化

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

变更 API

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

3.9.0 (2022-08-19)

新增特性

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

新增 API

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

移除 API

序号	API	API 说明
1	drawPlugin.getStrokeWidth	该接口已废弃，请使用新接口drawPlugin.getDefStyle
2	drawPlugin.getOpacity	该接口已废弃，请使用新接口drawPlugin.getDefStyle
3	drawPlugin.getColor	该接口已废弃，请使用新接口drawPlugin.getDefStyle
4	drawPlugin.setFontFamily	该接口已废弃，请使用新接口drawPlugin.setFontFamiles

变更 API

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

3.8.7 (2022-07-19)

新增特性

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

问题修复

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

3.8.6 (2022-05-30)

新增 API

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

变更 API

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

3.8.5 (2022-05-17)

新增特性

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

新增 API

序号	API	API 说明。
1	drawPlugin.getVisibleElementInfos	返回当前页面显示元素的信息。
2	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，提高白板功能扩展性。

• 修复了白板房间断网重连导致笔迹丢失的问题