教具插件介绍与启用

适用于 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 Shape	Auto Shape：一笔绘制图形

动态配置

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