# Auto Shape:一笔绘制图形 (/zh-CN/realtime-media/whiteboard/fastboard-sdk/build/appliance-plugin/extended-features/android) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 适用于 **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(); ``` 下文的 `params`、`config` 指 FastRoomOptions 返回的配置;通过 Fastboard 创建 SDK 和加入房间。 ## Auto Shape:一笔绘制图形 [#auto-shape一笔绘制图形] Auto Shape(Version ≥1.1.33)将一笔完成的铅笔笔迹识别为规则图形。用户继续使用 Pencil 绘制,抬手时完成识别;无法识别时保留普通铅笔笔迹。 ### 支持的图形 [#支持的图形] - 直线、箭头。 - 矩形、椭圆或圆形。 - 三角形、菱形、五角星。 闭合图形尽量一笔闭合。识别针对当前完成的一笔,不会批量转换历史笔迹。 ### Native Android 开启方式 [#native-android-开启方式] 先按[教具插件介绍](/zh-CN/realtime-media/whiteboard/fastboard-sdk/build/appliance-plugin/overview)开启 `useMultiViews`、`enableAppliancePlugin`,加入可写房间,在插件初始化完成后设置教具状态。 2.16.131 的 SDK `MemberState` 没有内置 `setAutoShape`。可以在应用中定义 `MemberState` 子类,增加插件已支持的 `autoShape` 布尔字段,再使用公开的 `room.setMemberState(...)` 提交。 示例使用 Gson 的 `@SerializedName` 固定 JSON 字段名。在应用模块的 `build.gradle` 中声明 Gson 依赖;已有该依赖的工程可复用: ```gradle dependencies { implementation 'com.google.code.gson:gson:2.10.1' } ``` 将下面的业务自定义类保存为独立的 `AutoShapeMemberState.java` 文件,并放入应用包中。`setAutoShape` 是这个业务类的方法。 ```java import com.google.gson.annotations.SerializedName; import com.herewhite.sdk.domain.MemberState; public class AutoShapeMemberState extends MemberState { @SerializedName("autoShape") private Boolean autoShape; public void setAutoShape(boolean enabled) { this.autoShape = enabled; } } ``` 在入房成功、插件就绪后调用: ```java import com.herewhite.sdk.domain.Appliance; import com.herewhite.sdk.domain.StrokeType; AutoShapeMemberState state = new AutoShapeMemberState(); state.setCurrentApplianceName(Appliance.PENCIL); state.setStrokeType(StrokeType.Normal); state.setStrokeColor(new int[]{32, 102, 255}); state.setStrokeWidth(4); state.setAutoShape(true); room.setMemberState(state); ``` SDK 会把子类字段和继承字段一起序列化,`autoShape` 以布尔值传给内嵌插件。用户仍然在 Android 白板视图中使用铅笔绘制。 ### 关闭 Auto Shape [#关闭-auto-shape] ```java AutoShapeMemberState state = new AutoShapeMemberState(); state.setAutoShape(false); room.setMemberState(state); ``` 关闭时显式提交 `false`;创建不含该字段的普通 `MemberState` 不会自动清除此前设置。SDK 返回的基础 `MemberState` 没有 `autoShape` getter,业务工具栏自行记录开关状态。 ### 类与字段保留 [#类与字段保留] 使用顶层类或静态嵌套类,避免匿名类或方法中的局部类被 Gson 忽略。开启 R8/ProGuard 时保留业务扩展类及字段;下面包名应替换为实际包名: ```proguard -keep class com.example.whiteboard.AutoShapeMemberState { *; } ``` 这是一种业务模型扩展方式,使用 SDK 现有 Native 方法;本版没有内置 Auto Shape 开关方法。开启后可在 Android 白板视图中书写并确认识别效果。