文档中心
体验 AppSDK 中心API 中心常见问题代码市场
中文
中文 English
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录控制台
中文站 English
互动白板

旧版产品

  • 互动视频
  • 实时语音
  • 低延迟直播
  • 文件共享
  • 屏幕共享
  • 互动白板
  • iOS
  • Android : Java
  • macOS
  • Windows
  • Web
  • Electron
展开所有目录
  • 概述
  • 价格说明
  • 下载
  • 跑通示例源码
  • 接入指南
  • 快速开始
  • 场景实践
  • 客户端 API
  • 服务端 API
  • 常见错误码
  • 常见问题
  • 文档中心
  • 互动白板
  • 下载
  • 发布日志

发布日志

更新时间：2023-07-19 15:12

2.5.0 版本

发布日期：2023-07-19

问题修复

  1. 修复已知问题，提高稳定性。

2.4.0 版本

发布日期：2023-05-06

新增功能

功能项 功能描述 相关接口
光标支持自定义文字展示 支持在画笔光标上展示自定义的文字信息。 setCustomCursorAttribute

改进优化

优化项 优化描述 相关接口
更新音视频 SDK 音视频 SDK 更新为 Express Video SDK v3.4.0。 -

2.3.7 版本

发布日期：2023-04-10

新增功能

功能项 功能描述 相关接口
新增设置白板最大缩放比例的功能

新增设置白板最大缩放比例的功能，支持用户通过 setWhiteboardMaxScaleFactor 接口自行调整缩放比例的最大倍数，适应不同的教育场景。

默认放大比例的最大倍数为 300%，最大可设置为 1000%。

 setWhiteboardMaxScaleFactor

2.3.6 版本

发布日期：2023-03-28

改进优化

优化项 优化描述 相关接口
音视频 SDK 更新 音视频 SDK 更新为 Express Video SDK v3.3.0。 -

2.3.5 版本

发布日期：2022-12-31

改进优化

优化项 优化描述 相关接口
音视频 SDK 更新 音视频 SDK 更新为 Express Video SDK v3.0.3。 -

2.3.0 版本

发布日期：2022-05-26

改进优化

优化项 优化描述 相关接口
优化鉴权方式
  • 2.3.0 或以上版本的 SDK，在创建引擎（createEngine）时，不传 AppSign；并且在登录房间（loginRoom）时必须传入 Token，鉴权通过后即可使用实时音视频功能和白板功能，具体请参考 使用 Token 鉴权。
  • 2.3.0 以下版本的 SDK，在创建引擎（createEngine）时传入 AppSign，鉴权通过后即可使用实时音视频功能和白板功能。

2.2.0 版本

发布日期：2022-01-18

新增功能

优化项 优化描述 相关接口
新增自定义光标功能 新增画笔自定义光标功能。可以通过调用 setCustomCursorAttribute 接口设置画笔光标样式。

改进优化

优化项 优化描述 相关接口
新增错误码 3030011 光标设置偏移值超出光标图片大小。 -

2.1.5 版本

发布日期：2021-11-16

改进优化

优化项 优化描述 相关接口
废弃测试环境 统一环境概念，对外不再区分测试环境/正式环境，详见 测试环境废弃说明。 -

2.1.1 版本

发布日期：2021-10-27

问题修复

修复了特定场景下 SDK 会崩溃的问题。


2.1.0 版本

发布日期：2021-10-15

改进优化

优化项 优化描述 相关接口
优化笔锋效果 优化开启笔锋时，在白板上绘制的轨迹过短时会缺失的问题。 -
优化多端图元显示位置 优化多端在共享超大文件白板时，图元显示位置会偏移的问题。 -

2.0.0 版本

发布日期：2021-09-02

新增功能

功能项 功能描述 相关接口
白板切换 新增白板切换接口，调用该方法，会更新切换目标白板的Zorder值，远端会收到白板切换的回调，用于同步切换。
房间状态回调 新增监听到房间状态变更时的回调。

1.23.0 版本

发布日期：2021-07-20

改进优化

优化项 优化描述 相关接口
优化笔锋效果 为了解决开启笔锋模式在一些缓慢绘制下导致绘制点不连贯的问题,优化了笔锋效果，经过优化后线条绘制效果更加连贯。 -

1.22.0 版本

发布日期：2021-07-06

新增功能

功能项 功能描述 相关接口
新增白板笔锋 支持配置绘制时是否开启笔锋效果。

改进优化

优化项 优化描述 相关定义
校验SDK版本 当前 SDK 版本与一起使用的 Express-Video SDK 版本不匹配，在初始化时抛出错误码 3000007。 ZegoWhiteboardViewErrorVersionMismatch
校验SDK版本 当前 SDK 与不包含白板功能的 Express-Video SDK 一起使用，在初始化时抛出错误码 3000008。 ZegoWhiteboardViewErrorExpressImcompatible

1.21.0 版本

发布日期：2021-05-31

新增功能

功能项 功能描述 相关接口
新增白板同步缩放功能 可以发送和接收白板的缩放状态。

改进优化

优化项 优化描述 相关接口
白板名称长度限制 白板名称长度限制统一为 128 字节，超出会抛出错误码 3020004。 ZegoWhiteboardViewErrorViewNameLimit
白板初始化目录检查

初始化的时候，会检查设置的日志或缓存目录是否可用。

  • 如果日志目录不可用，会抛出错误码 3040010。
  • 如果缓存目录不可用，会抛出错误码 3040011。
校验登录状态 创建白板，销毁白板，获取白板列表增加是否登录的校验，如果未登录返回相关错误码。 ZegoWhiteboardViewErrorNoLoginRoom
SDK 日志上传优化 开发者未设置日志路径时，会使用互动白板的默认路径记录日志，在上传日志时，会把相关日志上传到此默认路径。建议开发者不必设置日志路径，使用 SDK 内部默认路径即可。 -

1.20.0 版本

发布日期：2021-04-29

新增功能

功能项 功能描述 相关接口
新增 H5 文件白板 新增 H5 文件白板，支持 H5 文件类型。 -

改进优化

优化项 优化描述 相关接口
图片尺寸自适应 添加图片时，根据白板的宽高对图片进行自适应的大小调整。 -
白板尺寸自适应 添加白板时，根据父容器的宽高对白板进行自适应的大小调整。 -
新增错误码 3020007 当动画信息过长时，会报此错误码。 -

问题修复

该版本修复了如下问题：

  1. 修复横竖屏切换的时候偶现的一些问题。
  2. 修复其他已知问题。

1.19.0 版本

发布日期：2021-03-25

新增功能

功能项 功能描述 相关接口
新增白板权限控制功能 白板的滚动、缩放，图元创建、编辑、移动、删除和清空等操作权限可以通过 服务端 API 进行控制。 -
新增设置白板背景图功能 可通过调用 setBackgroundImage 接口设置对应的图片当做白板背景，可以传入相应的枚举值，来设置对应的图片填充模式，可收到对应回调。
新增清除白板背景图片功能 当开发者需要清除白板背景图时，可以调用 clearBackgroundImage 接口来清除，可收到对应回调。 clearBackgroundImage
新增权限变更回调

通过 onWhiteboardAuthChanged 方法，可收到白板滚动和缩放权限变更的回调。

通过 onWhiteboardGraphicAuthChanged 方法，可收到白板图元创建、编辑、删除、移动、清空权限变更的回调。

改进优化

优化项 优化描述 相关接口
新增错误码

新增如下错误码：

  • 3050001：无白板缩放权限时缩放白板。
  • 3050002：无白板滚动权限时调用 API 滚动白板。
  • 3050003：无创建图元权限时通过手势创建图元。
  • 3050004：无编辑图元权限时编辑他人创建的图元。
  • 3050005：无移动权限时移动他人创建的图元。
  • 3050006：无删除图元权限时删除他人创建的图元。
  • 3050007：无清空图元权限时清空图元。
 -
优化图元框选状态 批量框选图元的时候，针对每个被框选的图元，显示单独的选中框，便于更加清楚直观的看出哪些图元已被选中。 -

接口变更

  • 废弃接口
废弃接口 变更说明 预计删除版本

废弃接口：addTextEdit(Context context)

替代接口：addTextEdit(IZegoWhiteboardExecuteListener listener)

 新接口在原接口的功能基础上，新增图元创建权限回调。创建图元时，接口内部进行同步鉴权，如果用户无图元创建权限则会返回 3050003 错误码。 1.22.0

废弃接口：[addText(String text, int positionX, int positionY)]

替代接口：addText(String text, int positionX, int positionY, IZegoWhiteboardExecuteListener listener)

 新接口在原接口的功能基础上，新增图元创建权限回调。创建图元时，接口内部进行同步鉴权，如果用户无图元创建权限则会返回 3050003 错误码。 1.22.0

废弃接口：[clear()]

替代接口：clear(IZegoWhiteboardExecuteListener listener)

 新接口在原接口的功能基础上，新增图元删除权限回调。删除图元时，接口内部进行同步鉴权，如果用户无图元删除权限则会返回 3050006 错误码。 1.22.0

废弃接口：[clear(RectF rect)]

替代接口：clear(RectF rect,IZegoWhiteboardExecuteListener listener)

 新接口在原接口的功能基础上，新增图元清空权限回调。清空图元时，接口内部进行同步鉴权，如果用户无图元清空权限则会返回 3050007 错误码。 1.22.0

废弃接口：[deleteSelectedGraphics()]

替代接口：deleteSelectedGraphics(IZegoWhiteboardExecuteListener listener)

 新接口在原接口的功能基础上，新增图元删除权限回调。删除图元时，接口内部进行同步鉴权，如果用户无图元删除权限则会返回 3050006 错误码。 1.22.0
  • 删除接口
删除接口 变更说明

删除接口：[setCanDraw]

替代接口：setWhiteboardOperationMode

 -

删除接口：[enableUserOperation]

替代接口：setWhiteboardOperationMode

 -

1.18.0 版本

发布日期：2021-03-04

新增功能

功能项 功能描述 相关接口
新增实时轨迹同步功能 本端在进行涂鸦、矩形、椭圆、直线等图元绘制时，远端可以实时同步显示绘制轨迹。 -

改进优化

优化项 优化描述 相关接口
涂鸦优化 涂鸦图元绘制平滑度优化。 -
初始化流程优化 增加默认的日志和缓存文件目录，简化初始化流程。 -

1.16.0 版本

发布日期：2021-01-21

问题修复

该版本修复了已知问题。


1.15.0 版本

发布日期：2021-01-07

新增功能

功能项 功能描述 相关接口
新增白板插入图片功能 该功能可以实现通过调用插入图片 addImage 接口，在白板上同步显示图片。并且可对图片的大小、位置进行同步的缩放和移动，可与普通图元一样通过清除工具清除。 addImage
新增上传自定义图形功能 上传 url 网络图片，添加自定义图形、选择自定义图形工具后，可以通过手势拖动将已上传的自定义图形绘制在白板上，并对图形大小、位置可以进行同步的缩放和移动。自定义图形可与普通图元一样通过清除工具清除。
新增自定义图形工具 选择自定义图形工具后，可以通过手势拖动将已上传的自定义图形绘制在白板上。 setToolType
新增白板 SDK 缓存路径设置 通过 ZegoWhiteboardConfig 类 cacheFolder 属性，可设置文件缓存路径。 cacheFolder
新增白板 SDK 缓存清除功能 通过 ZegoWhiteboardManager 类 clearCacheFolder 方法，可以清除白板 SDK 缓存。 clearCacheFolder
新增错误码 - ZegoWhiteboardViewError

1.14.0 版本

发布日期：2020-12-24

新增功能

功能项 功能描述 相关接口
新增设置白板操作模式功能 该功能可以设置当前白板的操作模式。白板视图 ZegoWhiteboardView 有四种基本操作模式，且每种模式可以组合使用，相对于 canDraw 和 enableUserOperation，该功能对于白板的操作权限划分的更加具体，更加灵活，更加清晰。 setWhiteboardOperationMode

接口变更

  • 废弃接口
废弃接口 变更说明 预计删除版本

废弃接口canDraw 和 enableUserOperation

替代接口：setWhiteboardOperationMode

 新老接口不可以混合使用。 -

1.13.0 版本

发布日期：2020-12-07

新增功能

功能项 功能描述 相关接口
新增清空白板指定区域图元的功能 - clear(RectF rect)

问题修复

该版本修复了如下问题：

  1. 修复偶现白板当前页下标显示不一致的问题。
  2. 修复白板添加文本时，文本的位置显示错误的问题。

1.12.0 版本

发布日期：2020-11-19

新增功能

功能项 功能描述 相关接口
新增动态 PPT 相关功能
  • 设置点击文本工具的时候弹出输入框的默认文本。
  • 获取点击文本工具的时候弹出输入框的默认文本。
  • 在白板中添加文本。
  • 允许/禁止对白板做涂鸦、缩放、滚动等操作。
  • 删除选中图元。

问题修复

该版本修复了部分机型解锁屏后图元消失的问题。


1.11.0 版本

发布日期：2020-11-02

新增功能

功能项 功能描述 相关接口
新增动态 PPT 相关功能 支持动态 PPT 播放动画的功能（该功能需要配合 ZegoDocsView SDK 使用）。
  • ZegoWhiteboardView playAnimation
  • ZegoWhiteboardView setAnimationListener
  • ZegoDocsView playAnimation
  • ZegoDocsView setAnimationListener
新增画笔工具类型 ZegoWhiteboardConstants 新增点击工具 ZegoWhiteboardViewToolClick = 0x100 。可通过该“点击”操作与动态 PPT 进行交互，执行动态 PPT 的播放动画、下一步和下一页操作。 ZegoWhiteboardConstants
ZegoWhiteboardViewModel 新增 h5Extra 该参数表示动态 PPT 携带的动画同步信息。 h5Extra

改进优化

优化项 优化描述 相关接口
优化画笔 修改了画笔属性的默认值。 -

问题修复

该版本修复了如下问题：

  1. 修复了网络中断重连后房间不显示图画的问题。
  2. 修复了音画不同步的问题。
  3. 修复了激光笔显示异常的问题。
  4. 修复打开文档时报错误码：60010 的问题。

1.10.0 版本

发布日期：2020-09-28

问题修复

该版本增加了关键日志。


1.9.0 版本

发布日期：2020-09-07

新增功能

功能项 功能描述 相关接口
新增白板配置接口 白板配置接口可配置日志保存路径。 setConfig

1.8.0 版本

发布日期：2020-08-18

新增功能

功能项 功能描述 相关接口
新增将文本字体设置功能 可将文本设置成粗体或斜体。 setFontBold、setFontItalic

问题修复

该版本修复了激光笔的已知问题。

本篇目录
  • 免费试用

  • 联系我们