发版说明
本文提供声网 Fastboard SDK for Android 的发版说明。
声网 Fastboard SDK 是为帮助开发人员快速构建白板应用推出的新一代白板 SDK。Fastboard SDK 基于互动白板 SDK 开发,对复杂的 API 进行封装,简化了接口调用逻辑,并提供核心功能的实现和默认 UI;此外,Fastboard SDK 还集成窗口管理器(Window Manager)和常用插件,帮助开发者轻松扩展白板应用的功能。使用 Fastboard SDK,你无需深入学习互动白板复杂的概念,只需几行代码即可加入白板房间,并立即使用丰富的工具体验实时互动协作。
1.6.2 版
该版本于 2024 年 9 月 14 日发布。
该版本新增 preloadWhiteboardView
方法,用于手动执行一次白板视图预加载,提升下次加入房间的速度。使用该功能前需要确保 FastboardConfig
中的 autoPreload
为 false
。
preloadWhiteboardView
FastboardConfig
新增autoPreload
1.6.0 版
该版本于 2024 年 2 月 4 日发布。
FastRoom
类新增 insertStaticDoc
和 insertPptx
方法,分别用于插入转换后的 PDF 等静态文档和的 PPTX 动态文档。
新增 FastboardConfig
类用于 Fastboard
对象的辅助配置,可通过调用 setConfig
方法修改配置。其中,FastboardConfig.enablePreload
和 FastboardConfig.preloadCount
分别用于开关白板预加载功能和指定预加载的 WebView 数量,配置后可提升白板加载速度。
该版本新增了以下白板教具:
- 新增铅笔橡皮工具
FastAppliance.PENCIL_ERASER
,用于擦除局部铅笔笔迹。 - 新增抓手工具
FastAppliance.HAND
,用于移动视图。
该版本新增 FastLogger
类,提供了一个灵活的白板运行日志记录工具,可以方便地记录 debug
、info
、warn
、error
共四种不同级别的日志信息。你既可以调用 setLogger
方法自定义日志记录器,以适应不同的日志记录需求,也可以使用系统的 Log
类进行日志记录。
- 调用
Fastroom.insertImage
方法插入图片,默认将图片置于当前视图的中心。 - 禁用了房间加入成功后的全量房间状态回调
roomState
, 客户端需要通过Room.getRoomState()
来获取完整的RoomState
。
insertStaticDoc
insertPptx
DocPage
setConfig
FastboardConfig
FastAppliance
下新增:PENCIL_ERASER
HAND
FastLogger
setLogger
Logger
warn
debug
info
error
insertDocs
1.3.4 版
该版本于 2023 年 4 月 25 日发布。
该版本在 FastRoom
类下新增 setResource
方法,用于修改白板的相关颜色资源。你可以通过重写 FastResource
类中的方法来自定义颜色。
该版本在 FastRoomOptions
类中新增 containerSizeRatio
属性,用于修改本地显示窗口中内容的高宽比。
该版本在 FastRoomOptions
类中新增 userPayload
属性,用于在白板房间中同步其他用户的光标位置并显示对应昵称和头像。
该版本在 FastRoom
类下新增了以下方法:
setWritable [1/2]
和setWritable [2/2]
:设置用户在房间中为具有读写权限的互动模式或只有只读权限的订阅模式,其中,setWritable [2/2]
支持通过回调函数异步处理调用结果。isWritable
:获取本地用户在当前互动白板实时房间是否为互动模式。
在用户数量较多的房间中,限制房间中处于互动模式的用户数量可以有效提高白板房间连接的稳定性和房间可承载人数上限。
该版本在 FastUiSettings
类下新增 setToolboxEdgeMargin
方法,用于设置工具条和白板侧边的边距。
该版本优化了用户界面,并调整了白板工具图标样式和白板工具条的默认边距。
该版本修复了以下问题:
- 使用文字工具时偶现失焦。
FastUiSettings
类下的hideRoomController
在启动阶段偶现失效。
1.2.3 版
该版本于 2022 年 10 月 28 日发布。
FastRoom
类下的 setStokeWidth
更名为 setStrokeWidth
,详见 setStrokeWidth
。
该版本在 FastInsertDocParams
类中新增以下属性以支持新版文档转换服务:
-
dynamicDoc
: Boolean。文档转换任务类型是否为动态转换。 -
converterType
:枚举。文档转换服务版本,取值如下:Projector
:新版。详见新版文档转换服务。WhiteboardConverter
:旧版(默认值)。旧版文档转换服务当前已不再维护。
该版本修复了 FastInsertDocParams
中的参数顺序错误。
1.2.0 版
该版本于 2022 年 5 月 27 日发布。
为支持自定义白板用户界面,该版本在 FastUiSettings
类中新增如下方法,用于设置白板用户界面上的控件:
showRoomController
:展示白板用户界面上的控件。hideRoomController
:隐藏白板用户界面上的控件。setToolsExpandAppliances
:设置展开模式下工具条包含的工具集setToolsCollapseAppliances
:设置折叠模式下工具条包含的工具集。setToolsColors
:设置白板工具的颜色。setToolboxGravity
:设置工具条在白板上的位置。
该版本在 FastRoom
类中新增 setFastStyle
方法,用于设置白板用户界面的样式。通过该方法,你可以修改白板用户界面的主题色彩和主题模式。
1.0.0 版
该版本于 2022 年 3 月 16 日发布,是 Fastboard SDK 首个版本。
该版本直接实现了互动白板的核心基础功能,并提供默认的 UI。集成 Fastboard SDK 并调用 join
方法加入白板房间后,即可使用这些功能。该版本实现的核心功能如下:
- 白板工具栏,包括铅笔、文本编辑、图形工具等所有白板基础编辑工具,并支持设置线条粗细、字体大小和颜色。
- 页面管理,包括新增页面、页面跳转、页面缩放。
- 撤销、重做
尽管 Fastboard SDK 提供了上述功能的默认实现,但也提供了如下 API,方便你根据需要自行开发:
setAppliance
setStrokeWidth
setStrokeColor
undo
redo
Fastboard SDK 支持在白板中插入和展示多种形式的文件,例如,PNG、JPG 格式的图片,MP3、MP4 格式的音视频,以及 PPT、PPTX、DOC、DOCX、PDF 等格式的文档。具体实现步骤参考展示文件。