本文提供声网互动白板 SDK 的发版说明。
该版本于 2022 年 12 月 2 日发布。
1. 教具新特性
该版本为以下白板教具添加了新特性:
room.memberState.dottedLine
为 true
开启该功能。room.memberState.textCanSelectText
为 true
以开启该功能。此外,该版本还新增了铅笔橡皮工具,用于擦除局部铅笔笔迹。
2. 浮动条
该版本新增浮动条功能,选中任意白板元素即可弹出浮动条,方便用户快速编辑指定白板元素。例如,选中笔迹可以快速删除笔迹、调整位置、更变笔迹颜色等,选中文字可以快速删除文字、调整文字样式、修改字体等。你可以通过调用 setUsingFloatBar
方法启用浮动条功能。
3. 删除白板页
该版本新增了 removePage
方法用于删除指定白板页。
4. 获取 PPT 日志
WhiteSdk
类新增 requestSlideLog
方法,用于客户端获取 PPT 日志,方便排查 PPT 相关问题。
5. 回放回调
为方便监听 Player
的状态变化,该版本在 Player
类中新增 addPlayerListener
和 removePlayerListener
方法,用于添加和删除白板回放回调。
该版本优化了 PPT 音频播放控制,现在可以通过调用 AudioMixerBridge
接口下新增的 pauseAudioMixing
和 resumeAudioMixing
方法,实现暂停和恢复播放动态 PPT 中的音频和混音。
该版本修复了如下问题:
sceneState
变化时收不到回调。mainView
的 disableCameraTransform
配置丢失。新增
MemberState
类新增属性 dottedLine
和 textCanSelectText
Appliance
类新增属性 PENCIL_ERASER
removePage
pauseAudioMixing
resumeAudioMixing
addPlayerListener
removePlayerListener
setUsingFloatBar
requestSlideLog
该版本于 2022 年 7 月 8 日发布。
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:<version>'
}
详见获取 SDK。
1. 插入文字
该版本新增 insertText
方法,支持在指定位置插入文字。
2. 设置笔锋效果
该版本在 WhiteSdkConfiguration
类中新增 setDisableNewPencilStroke
方法,用于开启或关闭新铅笔的笔锋效果。该方法中 disableNewPencilStrokeSDK
参数的默认值为 true
,当你调用 setDisableNewPencil(false)
开启新铅笔后,SDK 立即开启笔锋效果。如果需要关闭新铅笔的笔锋效果,可以设置 setDisableNewPencilStroke(true)
。
同时,该版本在 WhiteSdkConfiguration
类中新增 isDisableNewPencilStroke
方法,用于查询笔锋效果的开启状态。
3. 获取场景信息
该版本在 Displayer
类中新增 getScene
方法,支持使用场景路径获取指定场景的信息。
4. 全链路加速
自该版本起,声网互动白板服务集成并支持声网全链路加速(FPA)服务。集成声网 Whiteboard SDK 后,你只需调用 setUseNativeWebSocket(true)
,即可在互动白板应用中开启全链路加速服务,提升传输质量。
该版本进行了如下改进:
setDisableNewPencil(false)
开启新铅笔工具。该版本修复了如下问题:
setWritable
时可能会发生错误。新增
insertText
setDisableNewPencilStroke
isDisableNewPencilStroke
getScene
该版本于 2022 年 1 月 21 日发布。
该版本进行了如下改进:
white-web-sdk
至 2.15.16 版。getSceneSnapshotImage
和 getScenePreviewImage
方法,确保在截图中正常显示场景中插入的图片。该版本于 2021 年 11 月 16 日发布。
为方便管理房间内的用户,该版本在 RoomParams
中新增 uid
参数,用于设置用户的唯一标识符(UID)。
如果你将 SDK 升级到 v2.15.0 或之后版本,为保证你的业务功能不受影响,调用 joinRoom
时必须在 RoomParams
传入字符串格式的 uid
,长度不超过 1024 字节,并确保同一房间内每个用户的 uid
唯一。详见《加入实时房间》。
该版本新增支持转换和展示如下 PowerPoint(PPT)特性:
该版本进行了如下改进:
white-web-sdk
至 2.15.1 版。该版本修复了在白板中展示动态 PPT 时遇到的如下问题:
修改
该版本于 2021 年 10 月 21 日发布。
自该版本起,互动白板 Android SDK 支持的最低平台要求变更如下:
该版本进行了如下优化:
white-web-sdk
至 2.14.5 版。onPhaseChanged
回调的准确性。该版本修复了如下问题:
该版本于 2021 年 8 月 20 日发布。
该版本新增如下特性:
CommonCallback
接口中新增 onLogger
回调,用于获取 SDK 输出的本地调试日志。该版本更新封装的 white-web-sdk
至 2.13.17 版。
该版本修复了如下问题:
onLogger
和 onMessage
回调不生效。connecting
状态。该版本于 2021 年 7 月 23 日发布。
为完善动态文档转换功能,该版本新增支持转换和展示如下 PowerPoint(PPT)特性:
该版本进行了如下优化:
white-web-sdk
至 2.13.11 版。@netless/video-js-plugin
至 0.3.3 版本。setTimeDelay
方法中 delaySec
参数的数据类型由 Integer 改为 Double。PptPage
中新增 preview
参数,支持在白板场景中展示动态 PPT 预览图。详见 API 参考。该版本修复了如下问题:
refreshViewSize
调用不生效。该版本于 2021 年 6 月 15 日发布。
该版本更新 white-web-sdk
至 2.13.4。
该版本于 2021 年 6 月 11 日发布。
该版本更新 white-web-sdk
至 2.13.3。
该版本于 2021 年 6 月 11 日发布。
改进
该版本更新 white-web-sdk
至 2.13.2。
问题修复
该版本修复了 disableDeviceInputs
设为 true
时,用户可能仍然可以操作 iframe 插件的问题。
该版本于 2021 年 6 月 8 日发布。
该版本修复的问题如下:
主播模式的用户在使用点选工具(Clicker
)时,如果对 HTML5 课件进行缩放,会导致跟随模式的用户看到的课件内容不完整。
该版本于 2021 年 6 月 7 日发布。
该版本更新 @netless/cursor-tool
至 0.1.0,并且更新 @netless/iframe-bridge
至 2.1.2。
该版本于 2021 年 6 月 4 日发布。
该版本更新 white-web-sdk
至 2.12.21。
该版本于 2021 年 6 月 3 日发布。
该版本更新 @netless/video-js-plugin
至 0.1.5。
该版本于 2021 年 6 月 2 日发布。
该版本修复了 video-js-plugin
插件在白板上无法显示的问题。
该版本于 2021 年 6 月 1 日发布。
该版本更新 @netless/video-js-plugin
至 0.1.3,修复了 video-js-plugin 和低版本 Android 系统的 WebView 不兼容的问题。
该版本于 2021 年 5 月 25 日发布。
该版本更新 @netless/cursor-tool
至 0.0.9。
该版本于 2021 年 5 月 24 日发布。
该版本集成 @netless/video-js-plugin
插件,用于在 Android 端观看 Web 端白板上播放的视频。支持的视频格式包括 M3U8 等。
该版本更新 white-web-sdk
至 2.12.20。
该版本于 2021 年 5 月 20 日发布。
该版本更新 white-web-sdk
至 2.12.19。
该版本于 2021 年 5 月 17 日发布。
该版本有以下改进:
white-web-sdk
至 2.12.18。useServerWrap
)由默认关闭改为默认开启。开启服务端排版后,服务端会裁剪字体包的体积,提高渲染速度。该版本于 2021 年 5 月 13 日发布。
该版本新增以下特性:
Appliance
新增点选工具 (Clicker
),用于 H5 课件的操作和交互。MemberState
新增 ShapeType
,支持设置图形工具。目前支持的图形包括三角形、菱形、五角星、对话气泡。Room
类新增 syncBlockTimestamp
方法,用于设置发送白板内容的延时,保证白板内容与音视频同步。white-web-sdk
至 2.12.17。该版本于 2021 年 4 月 28 日发布。
该版本更新 @netless/white-audio-plugin2
和 @netless/white-video-plugin2
插件,修复了部分显示问题。
该版本于 2021 年 4 月 27 日发布。
该版本支持 @netless/white-audio-plugin2
和 @netless/white-video-plugin2
,用于在 Android 端观看 Web 端白板上播放的音频或视频。
@netless/white-audio-plugin
至 1.2.23,修复了白板回放中音频文件的显示问题。getRoomState
异步方法没有回调的问题。该版本于 2021 年 4 月 22 日发布。
该版本更新 white-web-sdk
至 2.12.14。
该版本于 2021 年 4 月 22 日发布。
该版本有以下改进:
RoomListener
和 PlayerListener
为主线程回调。white-web-sdk
至 2.12.13。@netless/iframe-bridge
至 2.12.17,优化了白板回放的 iframe 插件逻辑。该版本于 2021 年 4 月 17 日发布。
该版本更新 white-web-sdk
至 2.12.12。
该版本于 2021 年 4 月 14 日发布。
该版本有以下改进:
PptParams
的构造方法,无需配置 scheme
参数。@netless/iframe-bridge
至 2.0.14,优化了 iframe 插件。该版本于 2021 年 4 月 12 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.13,优化了消息通知。
该版本于 2021 年 4 月 12 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.11,优化了 Android 端的显示问题。
该版本于 2021 年 4 月 9 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.10,优化了 Android 端的显示问题。
该版本于 2021 年 4 月 10 日发布。
该版本更新 white-web-sdk
至 2.12.9。
该版本于 2021 年 4 月 9 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.9,修复了 H5 课件的显示问题。
该版本于 2021 年 4 月 9 日发布。
该版本恢复了 Displayer
接口的 scaleIframeToFit
方法。
该版本于 2021 年 4 月 9 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.8,修复了 H5 课件的显示问题。
该版本于 2021 年 4 月 6 日发布。
该版本更新 white-web-sdk
至 2.12.8,修复了设置跟随者模式无法立即生效的问题。
该版本于 2021 年 4 月 2 日发布。
该版本更新 white-web-sdk
至 2.12.7,优化了动态 PPT 的显示。
该版本于 2021 年 3 月 30 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.7。
该版本于 2021 年 3 月 30 日发布。
该版本更新 white-web-sdk
至 2.12.6。
该版本于 2021 年 3 月 25 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.5,优化白板回放时的 H5 课件展示。
该版本于 2021 年 3 月 25 日发布。
该版本在 Displayer
类中新增 scaleIframeToFit
方法,支持等比例缩放视角,以保证完整显示 H5 课件的内容。
该版本于 2021 年 3 月 25 日发布。
该版本更新 @netless/cursor-tool
至 0.0.7。
该版本于 2021 年 3 月 20 日发布。
为解决笔锋效果与 2.2.12 之前版本 SDK 不兼容的问题,该版本将 setDisableNewPencil
方法的 disableNewPencil
参数默认值由 false
改为 true
,以默认关闭笔锋效果。
该版本于 2021 年 3 月 16 日发布。
为优化笔迹显示,该版本新增笔锋效果。你可以调用 setDisableNewPencil
关闭或开启笔锋效果;调用 isDisableNewPencil
获取是否开启笔锋效果。
white-web-sdk
至 2.12.4 版本,优化 PPT 显示逻辑。修复 debug
模式下,实时房间异常回调导致的崩溃问题。
关于更多版本的发版说明,详见版本历史。