2026/10/27 17:43:29
教具插件介绍与启用
适用于 Fastboard Android 1.8.2。本页通过 Fastboard 公开的原生 SDK 对象配置教具插件。
在创建 FastRoom 前通过 FastRoomOptions.getSdkConfiguration() 与 getRoomParams() 设置配置。下面的 fastRoomOptions 为业务创建的房间选项。
Java
import com.herewhite.sdk.WhiteSdkConfiguration;
import com.herewhite.sdk.RoomParams;
WhiteSdkConfiguration config = fastRoomOptions.getSdkConfiguration();
config.setUseMultiViews(true);
config.setEnableAppliancePlugin(true);
RoomParams params = fastRoomOptions.getRoomParams();
入房成功后,通过 Fastboard 的公开 getter 获取下文使用的 Native 对象:
Java
import com.herewhite.sdk.Room;
import com.herewhite.sdk.WhiteSdk;
Room room = fastRoom.getRoom();
WhiteSdk whiteSdk = fastRoom.getWhiteSdk();
教具与操作
| 教具 | 用途 |
|---|---|
| Selector | 框选、移动、缩放和旋转可编辑元素 |
| Pencil | 自由书写,可设置颜色、粗细、线型与透明度 |
| Eraser | 整元素擦除 |
| Pencil Eraser | 局部笔迹擦除 |
| Shape | 直线、箭头、矩形、椭圆、三角形、菱形、多边形与星形 |
| Text | 文字输入、排版和样式设置 |
| Hand | 移动视角 |
同一房间各端应一致开启插件;建议先在测试房间验证已有笔迹的显示、编辑与撤销重做。操作类 API 需要可写权限,教具配置应在入房和初始化完成后使用。
配置
Fastboard 的 RoomParams 保留业务传入的插件 extras。
Java
import com.herewhite.sdk.domain.AppliancePluginOptions;
AppliancePluginOptions options = new AppliancePluginOptions();
java.util.Map<String, Object> extras = new java.util.HashMap<>();
extras.put("useBackgroundThread", true);
options.setExtras(extras);
params.setAppliancePluginOptions(options);
扩展能力
| 功能 | 本端接入 |
|---|---|
| 教具和样式 | 自定义教具与样式 |
| 背景图 | 背景图加载与恢复 |
| Auto Shape | Auto Shape |