# Auto Shape:一笔绘制图形 (/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/appliance-plugin/extended-features/harmonyos) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 适用于 **Whiteboard HarmonyOS SDK 0.2.11**,内嵌 **Appliance Plugin 1.1.45**。本章的 `Version` 条件指插件版本。 ## Auto Shape:一笔绘制图形 [#auto-shape一笔绘制图形-1] Auto Shape(Version ≥1.1.33)在用户用铅笔完成一笔绘制后,识别并整理为对应图形。支持直线、箭头、矩形、椭圆或圆形,以及三角形、菱形和五角星。 闭合图形尽量一笔闭合。识别针对当前完成的一笔,不会批量转换历史笔迹。 ### Native HarmonyOS 开启方式 [#native-harmonyos-开启方式] 先按[教具插件介绍](/zh-CN/realtime-media/whiteboard/whiteboard-sdk/build/appliance-plugin/overview)开启 `useMultiViews` 和 `enableAppliancePlugin`,加入可写房间,在插件初始化完成后设置教具状态。 0.2.11 的 SDK `MemberState` 没有内置 `autoShape` 字段。应用可定义扩展 `MemberState` 的业务接口,声明插件接受的 `autoShape` 布尔值和 `strokeType`,通过公开的 `controller.setMemberState(...)` 提交。 将下面的业务接口与函数保存在应用的 `.ets` 文件中。`AutoShapeMemberState` 与 `enableAutoShape/disableAutoShape` 都由应用定义: ```typescript import { Appliance, MemberState, WhiteboardController } from '@shengwang/whiteboard'; interface AutoShapeMemberState extends MemberState { autoShape: boolean; strokeType?: string; } export function enableAutoShape(controller: WhiteboardController): void { const state: AutoShapeMemberState = { currentApplianceName: Appliance.PENCIL, strokeType: 'Normal', strokeColor: [32, 102, 255], strokeWidth: 4, autoShape: true }; controller.setMemberState(state); } export function disableAutoShape(controller: WhiteboardController): void { const state: AutoShapeMemberState = { autoShape: false }; controller.setMemberState(state); } ``` 入房成功、插件就绪后调用 `enableAutoShape(controller)`,再在 HarmonyOS 白板组件中使用铅笔绘制。函数将铅笔线型设为插件接受的 `Normal` 实线,并提交 `autoShape=true`。 SDK 会将整个状态对象序列化给内嵌白板运行时,业务接口的扩展字段也进入请求。使用的是公开 Native 方法,应用无需安装 Web 插件包。 ### 关闭与状态记录 [#关闭与状态记录] 调用 `disableAutoShape(controller)` 显式提交 `autoShape=false`。只提交不含该字段的普通 `MemberState` 不会自动清除此前开关。 SDK 的基础 `MemberState` 类型没有该字段,业务工具栏自行记录开关状态。扩展属性名需保持为 `autoShape` 和 `strokeType`;启用字段混淆时,保留这两个与运行时约定的名称。 这是业务模型扩展方式,使用 SDK 现有 Native 方法。开启后可在 HarmonyOS 白板组件中书写并确认识别效果。