发版说明
本文提供声网 Whiteboard iOS SDK 的发版说明。
为了确保 Whiteboard SDK 在不同平台上提供一致的用户体验，同时允许各端以原生方式接入，Whiteboard iOS SDK 通过桥接 Whiteboard Web SDK 实现，不是完全原生的 SDK。因此，iOS SDK 的版本更新内容会默认包含指定 Web SDK 版本及以前的更新内容，你可以根据 iOS 各版本的桥接说明，前往 Web SDK 发版说明查看包含的更新内容。
2.16.95 版
该版本于 2024 年 6 月 6 日发布。
桥接的 Web SDK 已升级至 v2.16.51。
该版本新增 WhiteSDK.prepareWhiteConnectionForAppId 方法，用于提前选择最佳接入域名，用于加快用户首次加入白板方间时的连接速度。
该版本新增 WhiteWindowParams.overwriteStyles，用于使用 CSS 覆盖白板窗口样式，实现自定义 UI 细节。
该版本修复了 drawOnlyPencil 在 iOS 17 及以上版本失效的问题。
prepareWhiteConnectionForAppIdoverwriteStyles
2.16.88 版
该版本于 2024 年 3 月 13 日发布。
桥接的 Web SDK 已升级至 v2.16.48。
在多窗口模式下，SDK 支持以新建窗口的方式插入 PPT 或白板插件等，它们统称为小窗应用。该版本起，WhiteRoom 类新增以下方法用于在多窗口模式下管理小窗应用：
addApp：插入小窗应用，并返回应用 ID。closeApp：关闭指定小窗应用的窗口。focusApp：切换聚焦窗口为指定小窗应用的窗口。queryApp：查询指定小窗应用的信息。queryAllAppsWithCompletionHandler：查询当前所有小窗应用的信息。
WhiteMemberState 和 WhiteReadonlyMemberState 新增以下属性用于自定义白板工具：
textColor：修改文本工具中文字的颜色。pencilEraserSize：修改铅笔橡皮工具的尺寸。
PPT 渲染配置项 WhiteSlideAppParams 新增了以下属性：
minFPS：设置 PPT 动画的最小帧率。maxFPS：设置 PPT 动画的最大帧率。resolution：设置 PPT 渲染分辨倍率。maxResolutionLevel：设置 PPT 最大分辨率。bgColor：设置 PPT 动画的背景色。forceCanvas：是否强制使用 2D 渲染，默认不开启。enableGlobalClick：是否可以通过点击 PPT 画面执行下一步功能，默认开启。
新增 updateText 方法, 用于更新调用 insertText 插入的文本。
该版本修复了以下问题：
WKWebView在某些异常情况下可能导致无法打开indexDB。- 配置
WhiteWindowParams.fullscreen后，第二次打开 App 没有全屏。 - 配置
WhiteWindowParams.fullscreen后偶现短暂的闪烁。 - 使用淡入淡出动画时偶现闪烁。
addAppcloseAppfocusAppqueryAppqueryAllAppsWithCompletionHandlerWhiteAppParamWhiteAppSyncAttributesWhiteMemberState和WhiteReadonlyMemberState新增textColorpencilEraserSize
updateTextWhiteSlideAppParams新增minFPSmaxFPSresolutionmaxResolutionLevelbgColorforceCanvasenableGlobalClick
2.16.62 版
该版本于 2023 年 8 月 31 日发布。
桥接的 Web SDK 已升级至 v2.16.42。
该版本废弃了白板数据中心（region）原有的英国伦敦数据中心（gb-lon），并新增了欧洲法兰克福数据中心（eu），服务区覆盖欧洲。如果你在之前版本中设置了 region 为 gb-lon，请在升级到该版本后改用 eu，并在控制台-互动白板服务配置中启用该数据中心。
该版本新增 getSlideVolumeWithCompletionHandler 和 updateSlideVolume 方法用于获取和更新 PPT 内音频的音量。
该版本在 WhiteSdkConfiguration 中新增 enableSlideInterrupterAPI 配置项，用于开启 PPT 资源 URL 拦截替换功能。该功能可用于加密用户上传的 PPT 资源，保护用户隐私。
开启后，通过调用 WhiteSDK.setSlideDelegate 设置回调对象，并在 slideUrlInterrupter: url: completionHandler 回调中添加 PPT URL 的替换逻辑，从而实现 PPT URL 的拦截替换功能。
该版本在 WhiteSdkConfiguration 中新增 whiteSlideAppParams 配置项用于 @netless/app-slide 渲染相关的显示配置。你可以通过 WhiteSlideAppParams.showRenderError 配置显示/隐藏渲染错误提示。
该版本在 WhiteSdkConfiguration 中新增 apiHosts 配置项, 用于配置白板的 API 服务器域名列表，例如添加代理服务器域名。
该版本在 RoomParams 和 PlayerConfiguration 中分别新增 modulesOrigin 配置项，用于配置白板请求模块（modules）数据的地址。
该版本新增 dispatchDocsEvent 方法，用于向插入白板的 PDF/PPTX 文档发送事件，实现控制文档翻页、页面跳转和幻灯片动画播放。
该版本在 WhiteWindowParams 中新增 fullscreen, 用于控制窗口是否全屏显示。
getSlideVolumeWithCompletionHandlerupdateSlideVolumeWhiteSdkConfigurationenableSlideInterrupterAPIwhiteSlideAppParamsapiHosts
setSlideDelegateWhiteSlideDelegateslideUrlInterrupter: url: completionHandler
dispatchDocsEventWhiteWindowDocsEventOptionsWhiteWindowDocsEventKey
RoomParams新增modulesOriginPlayerConfiguration新增modulesOriginWhiteWindowParams新增fullscreen
WhiteRegionKey中的WhiteRegionGB, 改用WhiteRegionEUWhitePptParams，改用WhiteSlideAppParams
2.16.46 版
该版本于 2022 年 12 月 2 日发布。
桥接的 Web SDK 已升级至 v2.16.35。
该版本为以下白板教具添加了新特性：
- 画笔工具：支持画虚线。你需要设置
room.memberState.dottedLine为true开启该功能。 - 文字工具：支持直接选择并编辑文字。你需要设置
room.memberState.textCanSelectText为true以开启该功能。
此外，该版本还新增了铅笔橡皮工具，用于擦除局部铅笔笔迹。
该版本新增浮动条功能，选中任意白板元素即可弹出浮动条，方便用户快速编辑指定白板元素。例如，选中笔迹可以快速删除笔迹、调整位置、更变笔迹颜色等，选中文字可以快速删除文字、调整文字样式、修改字体等。你可以通过调整 WhiteRoomConfig 中的 floatBar 参数启用浮动条功能。
该版本在 WhiteDisplayer 新增 getLocalSnapShotWithCompletion 方法获取当前屏幕截图。
WhiteSDK 新增 requestSlideLogToFilePath 方法，用于将 PPT 产生的日志写入到指定文件。
该版本进行了以下改进：
- 现在因 Web 内存不足导致白板崩溃后，SDK 会自动尝试恢复。之前如果设置过
navigationDelegate，需要先取消设置才能启用该优化。此外，该版本新增startRecoveringFromMemoryIssues和endRecoveringFromMemoryIssues回调，分别用于在内存不足时，报告 SDK 即将开始恢复白板 SDK 和 白板 SDK 恢复完毕。 - 现在可以通过调用
WhiteAudioMixerBridge下新增的pauseAudioMixing和resumeAudioMixing方法，实现暂停和恢复播放动态 PPT 中的音频和混音。
该版本修复了如下问题：
- 重连后，白板 app 可能无法正确创建。
- 创建白板 app 时，偶尔无法正确同步白板初始宽度和高度。
- 加入房间时，偶现的
WhiteBroadcastState初始化错误。 - 在 iPad 上使用非 ApplePencil 的手写笔时，调用
drawOnlyPencil功能可能导致白板崩溃。 - 在用户没有读写权限的时候，调用
drawOnlyPencil可能产生错误日志。 - 切换只读/读写状态时可能导致
mainView的disableCameraTransform配置丢失。
MemberState新增属性dottedLine和textCanSelectTextpauseAudioMixingresumeAudioMixingWhiteRoomConfig新增floatBar参数WhiteApplianceNameKey新增AppliancePencilEraser类型requestSlideLogToFilePathstartRecoveringFromMemoryIssuesendRecoveringFromMemoryIssuesgetLocalSnapShotWithCompletion
2.16.24 版
该版本于 2022 年 7 月 8 日发布。
该版本在 WhiteRoom 类新增 insertText 方法，支持在指定位置插入文字。
该版本在 WhiteSdkConfiguration 类中新增 disableNewPencilStroke 属性，用于开启或关闭新铅笔的笔锋效果。disableNewPencilStroke 的默认值为 YES，当你设置 disableNewPencil(NO) 开启新铅笔后，SDK 立即开启笔锋效果。如果需要关闭新铅笔的笔锋效果，可以设置 disableNewPencilStroke(YES)。
该版本在 WhiteDisplayer 类中新增 getSceneFromScenePath 方法，支持使用场景路径获取指定场景的信息。
自该版本起，声网互动白板服务集成并支持声网全链路加速（FPA）服务。集成声网 Whiteboard iOS SDK 后，你可以按照如下步骤设置，在互动白板应用中开启全链路加速功能，提升传输质量：
-
在项目的
podfile文件中添加如下依赖：pod 'Whiteboard/fpa' -
加入频道前，将
WhiteRoomConfig中的nativeWebSocket设为YES，开启全链路加速功能。
该功能仅支持 iOS 13.0 或之后的系统。
该版本支持在 iPad 上设置是否只允许用户使用 Apple Pencil 在白板上绘制和书写。加入白板房间前，你可以通过 WhiteRoomConfig 类中 drawOnlyApplePencil 属性来设置；加入房间后，你可以调用 WhiteRoom 类中的 setDrawOnlyApplePencil 方法来修改设置。
声网 Whiteboard iOS SDK 默认使用 YYModel 进行数据类型转换。自该版本起，SDK 新增支持 YYKit。如果要使用 YYKit，你需要在 Podfile 文件中添加如下行，来添加依赖：
-
不使用全链路加速功能：
Shellpod 'Whiteboard/Whiteboard-YYKit' -
使用全链路加速功能：
Shellpod 'Whiteboard/fpa-YYKit'
该版本进行了如下改进：
- 铅笔工具添加补间动画，使远端用户看到的笔迹绘制过程更加流畅。
- 优化了弱网环境下的重连机制，减少不必要的重连。
该版本修复了如下问题：
- 放缩、移动视角后，偶现画面出现偏移、重影。
- 偶现动态 PPT 在断线重连后无法翻页。
- 刚加入房间时，如果白板上已经有内容，可能显示不全。
- SDK 断线重连后可能会发生内存泄漏。
- 反复调用
setWritable时可能会发生错误。 - 点击 text 时无法弹出虚拟键盘。
- 用户切换为只读模式，再切换回读写模式并写写画画时，远端用户看到该用户的光标是固定的。
insertTextgetSceneFromScenePathsetDrawOnlyApplePencildrawOnlyApplePencildisableNewPencilStrokenativeWebSocket
2.15.23 版
该版本于 2022 年 1 月 21 日发布。
该版本进行了如下改进：
- 更新封装的
white-web-sdk至 2.15.16 版。 - 优化
getSceneSnapshotImage和getScenePreviewImage方法，确保确保在截图中正常显示场景中插入的图片。
2.15.0 版
该版本于 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:roomTokeninitWithUuid:roomToken:userPayload
initWithUuid:roomToken:memberInfojoinRoomWithUuidjoinRoomWithRoomUuid
2.14.1 版
该版本于 2021 年 10 月 21 日发布。
自该版本起，互动白板 iOS SDK 支持的最低平台要求由 iOS 9 变更为 iOS 10。
该版本进行了如下优化：
- 更新封装的
white-web-sdk至 2.14.4 版。 - 持续优化书写性能。
- 优化书写笔迹的形态。
- 提高
firePhaseChanged回调的准确性。 - 隐藏动态 PPT 母版中不应该显示的元素。
该版本修复了如下问题：
- 切换到抓手工具后，无法切换回光标。
- 书写过程中偶现的笔迹突然消失。
- 书写时偶现的笔迹带有不自然的水滴状笔锋。
- 手动缩放文本框后再编辑文字，文本框和文字复原到原来的大小。
- 在部分设备上窗口尺寸发生变化后，视角出现异常。
- 快速拖动橡皮擦时，橡皮擦的图标放大效果和快速删除功能失效。
- 偶现的动态 PPT 中多个音频文件同时播放。
- 动态 PPT 返回上一页后动画显示异常。
- 动态 PPT 中带动画的文本框偶现镜像翻转。
2.13.19 版
该版本于 2021 年 8 月 20 日发布。
该版本新增如下特性：
- 在
WhiteCommonCallbackDelegate中新增logger回调，用于获取 SDK 输出的本地调试日志。 - 为完善动态文档转换功能，该版本新增支持转换和展示如下 PowerPoint (PPT) 特性：
- 对文本按段落添加动画。
- 对文本添加的动画可逐字或逐词显示。
- 所有的表格预设样式。
- 小于 9 pt (12 px) 的文字。
该版本进行了如下优化：
- 更新封装的
white-web-sdk至 2.13.17 版。 - 为提高安全性，关闭白板内部的
allowUniversalAccessFromFileURLs功能。关闭该功能后，调用getSceneSnapshotImage时，在生成的截图中跨域图片可能无法显示。
该版本修复了如下问题：
- 偶现的加入房间时，房间一直卡在
connecting状态。 - 断线重连后，部分用户的光标消失。
- 断线重连后，部分插件的状态出现混乱。
- 抓手工具不受设置的视角边界的限制。
- 在高分辨率的设备上，当用户处于跟随视角模式时，视角的中心点出现轻微偏移。
- 在白板中展示动态 PPT 时遇到的如下问题：
- 段间距显示不正确
- 文本分栏无效
- 使用幻灯片背景填充形状时显示不正确
- 悬挂缩进异常
- 动画回退后显示异常
- 文字编号错误
- 转换后公式显示不全
- 部分换行不正确
- 从右往左书写的文字（如阿拉伯文）显示异常
2.13.15 版
该版本于 2021 年 7 月 23 日发布。
为完善动态文档转换功能，该版本新增支持转换和展示如下 PowerPoint（PPT）特性：
- 反转路径方向动画效果
- 纵向文本框
- Microsoft 公式编辑器 3.0
- 母版隐藏背景图形
- 编辑图片颜色
- 部分图片效果：
- 金属框架
- 柔化边缘矩形
- 双框架，黑色
- 厚重哑光，黑色
- 简单框架，黑色
- 中等复杂框架，黑色
- 居中矩形阴影
- 柔化边缘椭圆
- 金属圆角矩形
- 金属椭圆
该版本进行了如下优化：
- 更新封装的
white-web-sdk至 2.13.11 版。 - 更新封装的
@netless/video-js-plugin至 0.3.3 版本。 - 降低了播放动态 PPT 动画时占用的 CPU。
- 提升了在白板上书写绘画的流畅度。
- 优化时间戳同步算法，缩小时间同步误差。
- 打印的日志中包含场景变更信息。
- 在
WhitePptPage类中新增previewURL属性，支持在白板场景中展示动态 PPT 预览图。 - 废弃
WhiteDisplayer中backgroundColor属性，同时优化WhiteboardView类的实现逻辑，支持在WhiteboardView对象中直接调用UIView类的backgroundColor属性修改白板的背景色。
该版本修复了如下问题：
- 调整视角时偶现的白板清晰度异常。
- 偶现的用户进入房间后无法画出第一笔线。
- 偶现的
refreshViewSize调用不生效。 - 在白板中展示动态 PPT 时遇到的如下问题：
- 动画未按设置的顺序播放。
- 动画播放后未按设置隐藏。
- 表格高度显示异常。
- 无法显示占位符中插入图片。
- 部分形状绘制错误。
- 文字缩进错误。
- 无法点击动画触发器。
- 图片透明度过大。
2.13.4 版
该版本于 2021 年 6 月 15 日发布。
该版本更新 white-web-sdk 至 2.13.4。
2.13.2 版
该版本于 2021 年 6 月 11 日发布。
该版本更新 white-web-sdk 至 2.13.3。
2.13.1 版
该版本于 2021 年 6 月 11 日发布。
该版本更新 white-web-sdk 至 2.13.2。
该版本修复了 disableDeviceInputs 设为 true 时，用户可能仍然可以操作 iframe 插件的问题。
2.12.33 版
该版本于 2021 年 6 月 8 日发布。
该版本修复的问题如下：
主播模式的用户在使用点选工具（Clicker）时，如果对 HTML5 课件进行缩放，会导致跟随模式的用户看到的课件内容不完整。
2.12.32 版
该版本于 2021 年 6 月 7 日发布。
该版本更新 @netless/cursor-tool 至 0.1.0，并且更新 @netless/iframe-bridge 至 2.1.2。
2.12.31 版
该版本于 2021 年 6 月 4 日发布。
该版本更新 white-web-sdk 至 2.12.21，并且更新 @netless/video-js-plugin 至 0.1.5。
2.12.30 版
该版本于 2021 年 6 月 2 日发布。
该版本修复了 video-js-plugin 插件在白板上无法显示的问题。
2.12.29 版
该版本于 2021 年 6 月 1 日发布。
该版本更新 @netless/video-js-plugin至 0.1.3，修复了 video-js-plugin 和低版本 iOS 系统的 WebView 不兼容的问题。
2.12.28 版
该版本于 2021 年 5 月 25 日发布。
该版本更新 @netless/cursor-tool 至 0.0.9。
2.12.27 版
该版本于 2021 年 5 月 24 日发布。
该版本支持 @netless/video-js-plugin 插件，并更新 white-web-sdk 至 2.12.20。
2.12.26 版
该版本于 2021 年 5 月 20 日发布。
该版本新增以下特性：
WhiteApplianceNameKey中新增ApplianceClicker，支持设置点选工具，用于 H5 课件的操作和交互。- 更新
white-web-sdk至 2.12.18。
2.12.25 版
该版本于 2021 年 5 月 17 日发布。
该版本有以下改进：
- 更新
white-web-sdk至 2.12.18。 - 服务端排版（
useServerWrap）由默认关闭改为默认开启，并返回裁剪后的字体。
2.12.24 版
该版本于 2021 年 5 月 13 日发布。
该版本新增以下特性：
WhiteApplianceNameKey中新增ApplianceShape，支持设置图形工具。目前支持的图形包括三角形、菱形、五角星、对话气泡。- 新增
syncBlockTimestamp方法，用于设置发送白板内容的延时，保证白板内容与音视频同步。 - 更新
white-web-sdk至 2.12.17。
2.12.23 版
该版本于 2021 年 5 月 11 日发布。
该版本新增 RegionKey 枚举，用于设置数据中心。
2.12.22 版
该版本于 2021 年 4 月 28 日发布。
该版本更新 @netless/white-audio-plugin2 和 @netless/white-video-plugin2 插件，修复了部分显示问题。
2.12.21 版
该版本于 2021 年 4 月 28 日发布。
该版本支持 @netless/white-audio-plugin2 和 @netless/white-video-plugin2，用于在 iOS 端观看 Web 端白板上播放的音频或视频。
该版本更新 @netless/white-audio-plugin 至 1.2.23，修复了白板回放中音频文件的显示问题。
2.12.20 版
该版本于 2021 年 4 月 22 日发布。
该版本更新 white-web-sdk 至 2.12.14。
2.12.19 版
该版本于 2021 年 4 月 22 日发布。
该版本有以下改动：
- 更新
white-web-sdk至 2.12.13，优化了动态 PPT 的播放。 - 更新
@netless/iframe-bridge至 2.0.17，优化了白板回放的 iframe 插件逻辑。
2.12.18 版
该版本于 2021 年 4 月 20 日发布。
该版本更新 @netless/iframe-bridge 至 2.0.16，优化了白板回放的 iframe 插件逻辑。
2.12.17 版
该版本于 2021 年 4 月 17 日发布。
该版本更新 white-web-sdk 至 2.12.12。
2.12.16 版
该版本于 2021 年 4 月 14 日发布。
该版本更新 @netless/iframe-bridge 至 2.0.14，优化了 iframe 插件。
2.12.15 版
该版本于 2021 年 4 月 13 日发布。
该版本更新 @netless/iframe-bridge 至 2.0.13，优化了 H5 课件的消息发送逻辑。
2.12.14 版
该版本于 2021 年 4 月 13 日发布。
该版本更新 @netless/iframe-bridge 至 2.0.11，修复了 H5 课件的显示问题。
2.12.13 版
该版本于 2021 年 4 月 10 日发布。
该版本更新 white-web-sdk 至 2.12.9。
2.12.12 版
该版本于 2021 年 4 月 9 日发布。
该版本更新 @netless/iframe-bridge 至 2.0.9，修复了 H5 课件的显示问题。
2.12.11 版
该版本于 2021 年 4 月 9 日发布。
该版本更新 @netless/iframe-bridge 至 2.0.8，修复了 H5 课件的显示问题。
2.12.10 版
该版本于 2021 年 4 月 6 日发布。
该版本更新 white-web-sdk 至 2.12.8，修复了设置跟随者模式无法立即生效的问题。
2.12.9 版
该版本于 2021 年 4 月 2 日发布。
该版本更新 white-web-sdk 至 2.12.7，优化了动态 PPT 的显示。
2.12.8 版
该版本于 2021 年 3 月 30 日发布。
该版本更新 @netless/iframe-bridge 至 2.0.7。
2.12.7 版
该版本于 2021 年 3 月 30 日发布。
该版本更新 white-web-sdk 至 2.12.6。
2.12.6 版
该版本于 2021 年 3 月 25 日发布。
该版本更新 @netless/iframe-bridge 至 2.0.5，优化了白板回放时 H5 课件的展示。
2.12.5 版
该版本于 2021 年 3 月 25 日发布。
该版本在 Displayer 类中新增 scaleIframeToFit 方法，支持等比例缩放视角，以保证完整显示 H5 课件的内容。
2.12.4 版
该版本于 2021 年 3 月 24 日发布。
该版本更新 @netless/cursor-tool 至 0.0.7。
2.12.3 版
该版本于 2021 年 3 月 20 日发布。
为解决笔锋效果与 2.2.12 之前版本 SDK 不兼容的问题，该版本将 WhiteRoomConfig 接口中的 disableNewPencil 属性设为 YES，以默认关闭笔锋效果。
为正常显示笔迹，在开启笔峰效果前，请确保该房间内的所有用户使用如下 SDK：
- Android SDK 2.12.3 版或之后
- iOS SDK 2.12.3 版或之后
- Web SDK 2.12.5 版或之后
2.12.2 版
该版本于 2021 年 3 月 16 日发布。
为优化笔迹显示，该版本新增笔锋效果。你可以通过 WhiteRoomConfig 接口中的 disableNewPencil 属性关闭或开启笔锋功能。
为正常显示笔迹，在开启笔峰效果前，请确保该房间内的所有用户使用如下 SDK： 为正常显示笔迹，在开启笔峰效果前，请确保该房间内的所有用户使用如下 SDK：
- Android SDK 2.12.2 版或之后
- iOS SDK 2.12.3 版或之后
- Web SDK 2.12.5 版或之后
- 更新
white-web-sdk至 2.12.4 版本，优化 PPT 显示逻辑。 - 优化音视频插件在白板回放时的按钮显示。
2.12.2 版之前
关于更多版本的发版说明，详见版本历史。
2.6.4 及之前版本已经停止维护，建议升级到最新版本。