教具插件介绍与启用

  • iOS

更新时间

适用于 Whiteboard iOS SDK 2.16.147。插件及 Worker 已内嵌,使用 Objective-C 或 Swift 原生接口配置。

初始化前开启

Objective-C
WhiteSdkConfiguration *config = [[WhiteSdkConfiguration alloc] initWithApp:appIdentifier];
config.useMultiViews = YES;
config.enableAppliancePlugin = YES;

WhiteRoomConfig *roomConfig = [[WhiteRoomConfig alloc] initWithUUID:uuid roomToken:roomToken uid:uid];
WhiteAppliancePluginOptions *options = [WhiteAppliancePluginOptions new];
options.extras = @{ @"useBackgroundThread": @YES };
roomConfig.appliancePluginOptions = options;

在创建 WhiteSDK 前设置 config,入房前设置 roomConfig。同房间各端保持启用状态一致;不要注入额外 Web 插件脚本。布尔/数字 extras 使用 NSNumber,函数回调使用本端 delegate。

教具与操作

教具用途
Selector框选、移动、缩放和旋转可编辑元素
Pencil自由书写,可设置颜色、粗细、线型与透明度
Eraser整元素擦除
Pencil Eraser局部笔迹擦除
Shape直线、箭头、矩形、椭圆、三角形、菱形、多边形与星形
Text文字输入、排版和样式设置
Hand移动视角
表格内容超出当前宽度,可横向滚动查看更多列。

同一房间各端应一致开启插件;建议先在测试房间验证已有笔迹的显示、编辑与撤销重做。操作类 API 需要可写权限,教具配置应在入房和初始化完成后使用。

扩展能力

功能本端接入
Selector/Pencil/Shape 与 extras自定义教具与样式
背景图加载、查询和恢复背景图加载与恢复
Auto ShapeAuto Shape:一笔绘制图形
表格内容超出当前宽度,可横向滚动查看更多列。

动态配置

需要远程调整教具参数时,参见动态配置。本地显式 extras 优先;未提供的字段允许继承远端 appliancePlugin.extras。SDK 内嵌绘制资源,回调继续在本端绑定。