本文提供声网互动白板 SDK 的发版说明。
该版本于 2022 年 12 月 2 日发布。
1. 教具新特性
该版本为以下白板教具添加了新特性:
room.memberState.dottedLine
为 true
开启该功能。room.memberState.textCanSelectText
为 true
以开启该功能。此外,该版本还新增了铅笔橡皮工具,用于擦除局部铅笔笔迹。
2. 浮动条
该版本新增浮动条功能,选中任意白板元素即可弹出浮动条,方便用户快速编辑指定白板元素。例如,选中笔迹可以快速删除笔迹、调整位置、更变笔迹颜色等,选中文字可以快速删除文字、调整文字样式、修改字体等。你可以通过调整 WhiteRoomConfig
中的 floatBar
参数启用浮动条功能。
3. 白板截图
该版本在 WhiteDisplayer
新增 getLocalSnapShotWithCompletion
方法获取当前屏幕截图。
4. 获取 PPT 日志
WhiteSDK
新增 requestSlideLogToFilePath
方法,用于将 PPT 产生的日志写入到指定文件。
该版本进行了以下改进:
navigationDelegate
,需要先取消设置才能启用该优化。此外,该版本新增 startRecoveringFromMemoryIssues
和 endRecoveringFromMemoryIssues
回调,分别用于在内存不足时,报告 SDK 即将开始恢复白板 SDK 和 白板 SDK 恢复完毕。WhiteAudioMixerBridge
下新增的 pauseAudioMixing
和 resumeAudioMixing
方法,实现暂停和恢复播放动态 PPT 中的音频和混音。该版本修复了如下问题:
WhiteBroadcastState
初始化错误。drawOnlyPencil
功能可能导致白板崩溃。drawOnlyPencil
可能产生错误日志。mainView
的 disableCameraTransform
配置丢失。新增
MemberState
新增属性 dottedLine
和 textCanSelectText
pauseAudioMixing
resumeAudioMixing
WhiteRoomConfig
新增 floatBar
参数WhiteApplianceNameKey
新增 AppliancePencilEraser
类型requestSlideLogToFilePath
startRecoveringFromMemoryIssues
endRecoveringFromMemoryIssues
getLocalSnapShotWithCompletion
该版本于 2022 年 7 月 8 日发布。
1. 插入文字
该版本在 WhiteRoom
类新增 insertText
方法,支持在指定位置插入文字。
2. 设置笔锋效果
该版本在 WhiteSdkConfiguration
类中新增 disableNewPencilStroke
属性,用于开启或关闭新铅笔的笔锋效果。disableNewPencilStroke
的默认值为 YES
,当你设置 disableNewPencil(NO)
开启新铅笔后,SDK 立即开启笔锋效果。如果需要关闭新铅笔的笔锋效果,可以设置 disableNewPencilStroke(YES)
。
3. 获取场景信息
该版本在 WhiteDisplayer
类中新增 getSceneFromScenePath
方法,支持使用场景路径获取指定场景的信息。
4. 全链路加速
自该版本起,声网互动白板服务集成并支持声网全链路加速(FPA)服务。集成声网 Whiteboard iOS SDK 后,你可以按照如下步骤设置,在互动白板应用中开启全链路加速功能,提升传输质量:
在项目的 podfile
文件中添加如下依赖:
pod 'Whiteboard/fpa'
加入频道前,将 WhiteRoomConfig
中的 nativeWebSocket
设为 YES
,开启全链路加速功能。
5. 设置是否只允许使用 Apple Pencil 绘制和书写
该版本支持在 iPad 上设置是否只允许用户使用 Apple Pencil 在白板上绘制和书写。加入白板房间前,你可以通过 WhiteRoomConfig
类中 drawOnlyApplePencil
属性来设置;加入房间后,你可以调用 WhiteRoom
类中的 setDrawOnlyApplePencil
方法来修改设置。
6. 支持 YYKit
声网 Whiteboard iOS SDK 默认使用 YYModel 进行数据类型转换。自该版本起,SDK 新增支持 YYKit。如果要使用 YYKit,你需要在 Podfile
文件中添加如下行,来添加依赖:
不使用全链路加速功能:
pod 'Whiteboard/Whiteboard-YYKit'
使用全链路加速功能:
pod 'Whiteboard/fpa-YYKit'
该版本进行了如下改进:
该版本修复了如下问题:
setWritable
时可能会发生错误。新增
insertText
getSceneFromScenePath
setDrawOnlyApplePencil
drawOnlyApplePencil
disableNewPencilStroke
nativeWebSocket
该版本于 2022 年 1 月 21 日发布。
该版本进行了如下改进:
white-web-sdk
至 2.15.16 版。getSceneSnapshotImage
和 getScenePreviewImage
方法,确保确保在截图中正常显示场景中插入的图片。该版本于 2021 年 11 月 16 日发布。
为简化接口,该版本删除 joinRoomWithUuid
和 joinRoomWithRoomUuid
方法,仅保留 joinRoomWithConfig
方法。
同时,为方便管理房间内的用户,该版本在 WhiteRoomConfig
类的 initWithUuid
中新增 uid
参数,用于设置用户的唯一标识符(UID)。
如果你将 SDK 升级到 v2.15.0 或之后版本,要加入房间,你必须调用 joinRoomWithConfig
,并确保初始化 WhiteRoomConfig
对象时在 initWithUuid
中传入字符串格式的 uid
。每个用户的 uid
长度不能超过 1024 字节,且在同一房间内必须唯一。详见《加入实时房间》。
该版本新增支持转换和展示如下 PowerPoint(PPT)特性:
该版本进行了如下改进:
white-web-sdk
至 2.15.1 版。该版本修复了在白板中展示动态 PPT 时遇到的如下问题:
修改
删除
initWithUuid:roomToken:memberInfo
joinRoomWithUuid
joinRoomWithRoomUuid
该版本于 2021 年 10 月 21 日发布。
自该版本起,互动白板 iOS SDK 支持的最低平台要求由 iOS 9 变更为 iOS 10。
该版本进行了如下优化:
white-web-sdk
至 2.14.4 版。firePhaseChanged
回调的准确性。该版本修复了如下问题:
该版本于 2021 年 8 月 20 日发布。
该版本新增如下特性:
WhiteCommonCallbackDelegate
中新增 logger
回调,用于获取 SDK 输出的本地调试日志。该版本进行了如下优化:
white-web-sdk
至 2.13.17 版。allowUniversalAccessFromFileURLs
功能。关闭该功能后,调用 getSceneSnapshotImage
时,在生成的截图中跨域图片可能无法显示。该版本修复了如下问题:
connecting
状态。该版本于 2021 年 7 月 23 日发布。
为完善动态文档转换功能,该版本新增支持转换和展示如下 PowerPoint(PPT)特性:
该版本进行了如下优化:
white-web-sdk
至 2.13.11 版。@netless/video-js-plugin
至 0.3.3 版本。WhitePptPage
类中新增 previewURL
属性,支持在白板场景中展示动态 PPT 预览图。详见 API 参考。WhiteDisplayer
中 backgroundColor
属性,同时优化 WhiteboardView
类的实现逻辑,支持在 WhiteboardView
对象中直接调用 UIView
类的 backgroundColor
属性修改白板的背景色。详见 backgroundcolor。该版本修复了如下问题:
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,并且更新 @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 和低版本 iOS 系统的 WebView 不兼容的问题。
该版本于 2021 年 5 月 25 日发布。
该版本更新 @netless/cursor-tool
至 0.0.9。
该版本于 2021 年 5 月 24 日发布。
该版本支持 @netless/video-js-plugin
插件,并更新 white-web-sdk
至 2.12.20。
该版本于 2021 年 5 月 20 日发布。
该版本新增以下特性:
WhiteApplianceNameKey
中新增 ApplianceClicker
,支持设置点选工具,用于 H5 课件的操作和交互。white-web-sdk
至 2.12.18。该版本于 2021 年 5 月 17 日发布。
该版本有以下改进:
white-web-sdk
至 2.12.18。useServerWrap
)由默认关闭改为默认开启,并返回裁剪后的字体。该版本于 2021 年 5 月 13 日发布。
该版本新增以下特性:
WhiteApplianceNameKey
中新增 ApplianceShape
,支持设置图形工具。目前支持的图形包括三角形、菱形、五角星、对话气泡。syncBlockTimestamp
方法,用于设置发送白板内容的延时,保证白板内容与音视频同步。white-web-sdk
至 2.12.17。该版本于 2021 年 5 月 11 日发布。
该版本新增 RegionKey
枚举,用于设置数据中心。
该版本于 2021 年 4 月 28 日发布。
该版本更新 @netless/white-audio-plugin2
和 @netless/white-video-plugin2
插件,修复了部分显示问题。
该版本于 2021 年 4 月 28 日发布。
该版本支持 @netless/white-audio-plugin2
和 @netless/white-video-plugin2
,用于在 iOS 端观看 Web 端白板上播放的音频或视频。
该版本更新 @netless/white-audio-plugin
至 1.2.23,修复了白板回放中音频文件的显示问题。
该版本于 2021 年 4 月 22 日发布。
该版本更新 white-web-sdk
至 2.12.14。
该版本于 2021 年 4 月 22 日发布。
该版本有以下改动:
white-web-sdk
至 2.12.13,优化了动态 PPT 的播放。@netless/iframe-bridge
至 2.0.17,优化了白板回放的 iframe 插件逻辑。该版本于 2021 年 4 月 20 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.16,优化了白板回放的 iframe 插件逻辑。
该版本于 2021 年 4 月 17 日发布。
该版本更新 white-web-sdk
至 2.12.12。
该版本于 2021 年 4 月 14 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.14,优化了 iframe 插件。
该版本于 2021 年 4 月 13 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.13,优化了 H5 课件的消息发送逻辑。
该版本于 2021 年 4 月 13 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.11,修复了 H5 课件的显示问题。
该版本于 2021 年 4 月 10 日发布。
该版本更新 white-web-sdk
至 2.12.9。
该版本于 2021 年 4 月 9 日发布。
该版本更新 @netless/iframe-bridge
至 2.0.9,修复了 H5 课件的显示问题。
该版本于 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 月 24 日发布。
该版本更新 @netless/cursor-tool
至 0.0.7。
该版本于 2021 年 3 月 20 日发布。
为解决笔锋效果与 2.2.12 之前版本 SDK 不兼容的问题,该版本将 WhiteRoomConfig
接口中的 disableNewPencil
属性设为 YES
,以默认关闭笔锋效果。
该版本于 2021 年 3 月 16 日发布。
为优化笔迹显示,该版本新增笔锋效果。你可以通过 WhiteRoomConfig
接口中的 disableNewPencil
属性关闭或开启笔锋功能。
white-web-sdk
至 2.12.4 版本,优化 PPT 显示逻辑。关于更多版本的发版说明,详见版本历史。