# 教具插件介绍与启用 (/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/appliance-plugin/overview/ios) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 适用于 **Whiteboard iOS SDK 2.16.147**。插件及 Worker 已内嵌,使用 Objective-C 或 Swift 原生接口配置。 ## 初始化前开启 [#初始化前开启] ```objc 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。 ## 教具与操作 [#教具与操作-1] | 教具 | 用途 | | --- | --- | | Selector | 框选、移动、缩放和旋转可编辑元素 | | Pencil | 自由书写,可设置颜色、粗细、线型与透明度 | | Eraser | 整元素擦除 | | Pencil Eraser | 局部笔迹擦除 | | Shape | 直线、箭头、矩形、椭圆、三角形、菱形、多边形与星形 | | Text | 文字输入、排版和样式设置 | | Hand | 移动视角 | 同一房间各端应一致开启插件;建议先在测试房间验证已有笔迹的显示、编辑与撤销重做。操作类 API 需要可写权限,教具配置应在入房和初始化完成后使用。 ## 扩展能力 [#扩展能力-1] | 功能 | 本端接入 | | --- | --- | | Selector/Pencil/Shape 与 extras | [自定义教具与样式](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/appliance-plugin/custom-tools) | | 背景图加载、查询和恢复 | [背景图加载与恢复](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/appliance-plugin/background-image-recovery) | | Auto Shape | [Auto Shape:一笔绘制图形](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/appliance-plugin/extended-features) | ## 动态配置 [#动态配置-1] 需要远程调整教具参数时,参见[动态配置](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/extend-whiteboard/dynamic-config)。本地显式 extras 优先;未提供的字段允许继承远端 appliancePlugin.extras。SDK 内嵌绘制资源,回调继续在本端绑定。