Auto Shape：一笔绘制图形

适用于 Whiteboard Android SDK 2.16.134，内嵌 Appliance Plugin 1.1.45。本章的 Version 条件指插件版本。

Auto Shape：一笔绘制图形Copy Anchor Link

Auto Shape（Version ≥1.1.33）将一笔完成的铅笔笔迹识别为规则图形。用户继续使用 Pencil 绘制，抬手时完成识别；无法识别时保留普通铅笔笔迹。

支持的图形Copy Anchor Link

• 直线、箭头。
• 矩形、椭圆或圆形。
• 三角形、菱形、五角星。

闭合图形尽量一笔闭合。识别针对当前完成的一笔，不会批量转换历史笔迹。

Native Android 开启方式Copy Anchor Link

先按教具插件介绍开启 useMultiViews、enableAppliancePlugin，加入可写房间，在插件初始化完成后设置教具状态。

2.16.134 的 SDK MemberState 没有内置 setAutoShape。可以在应用中定义 MemberState 子类，增加插件已支持的 autoShape 布尔字段，再使用公开的 room.setMemberState(...) 提交。

示例使用 Gson 的 @SerializedName 固定 JSON 字段名。在应用模块的 build.gradle 中声明 Gson 依赖；已有该依赖的工程可复用：

dependencies {
    implementation 'com.google.code.gson:gson:2.10.1'
}

将下面的业务自定义类保存为独立的 AutoShapeMemberState.java 文件，并放入应用包中。setAutoShape 是这个业务类的方法。

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;
    }
}

在入房成功、插件就绪后调用：

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 ShapeCopy Anchor Link

AutoShapeMemberState state = new AutoShapeMemberState();
state.setAutoShape(false);
room.setMemberState(state);

关闭时显式提交 false；创建不含该字段的普通 MemberState 不会自动清除此前设置。SDK 返回的基础 MemberState 没有 autoShape getter，业务工具栏自行记录开关状态。

类与字段保留Copy Anchor Link

使用顶层类或静态嵌套类，避免匿名类或方法中的局部类被 Gson 忽略。开启 R8/ProGuard 时保留业务扩展类及字段；下面包名应替换为实际包名：

-keep class com.example.whiteboard.AutoShapeMemberState { *; }

这是一种业务模型扩展方式，使用 SDK 现有 Native 方法；本版没有内置 Auto Shape 开关方法。开启后可在 Android 白板视图中书写并确认识别效果。

适用于 Whiteboard iOS SDK 2.16.147。Auto Shape（插件 Version ≥1.1.33）在 Pencil 抬笔时尝试将单笔识别为规则图形。

定义业务扩展模型Copy Anchor Link

基础 WhiteMemberState 未声明 autoShape。在应用中定义命名子类，通过现有 setMemberState: 序列化提交该字段；它是业务扩展属性。

@interface AutoShapeMemberState : WhiteMemberState
@property (nonatomic, strong) NSNumber *autoShape;
@end

@implementation AutoShapeMemberState
@end

开启和关闭Copy Anchor Link

在入房成功且插件就绪后调用：

AutoShapeMemberState *state = [AutoShapeMemberState new];
state.currentApplianceName = AppliancePencil;
state.strokeType = @"Normal";
state.autoShape = @YES;
[room setMemberState:state];

AutoShapeMemberState *disabled = [AutoShapeMemberState new];
disabled.autoShape = @NO;
[room setMemberState:disabled];

应用必须保留 autoShape 与 strokeType 的序列化字段名。通过 YYModel 的公开模型序列化路径提交子类属性；关闭时显式提交 NO。

可识别直线、箭头、矩形、椭圆或圆、三角形、菱形和五角星。闭合图形尽量一笔闭合；无法识别时保留普通笔迹，不转换历史数据。

适用于 Appliance Plugin 1.1.45。先完成启用插件，plugin 为已初始化的插件实例。以下版本门槛指插件版本。

小地图（Version ≥1.1.6）Copy Anchor Link

createMiniMap 不支持 simple 模式。在初始化插件时将 extras.useSimple 显式设为 false；默认值为 true。如果插件已按 simple 模式初始化，应先销毁并按新配置重新创建。

// Whiteboard：ApplianceMultiPlugin.getInstance(manager, { options: { extras: ... } })
const extras = { useSimple: false, useBackgroundThread: true };

await plugin.createMiniMap('mainView', minimapContainer);
// 组件卸载或窗口关闭时等待清理。
await plugin.destroyMiniMap('mainView');

容器应有明确宽高。主白板的 viewId 为 mainView；App View 使用添加 App 返回的 ID。destroyMiniMap 当前返回 Promise<void>。

Auto Shape：一笔绘制图形（Version ≥1.1.33）Copy Anchor Link

import { ApplianceNames, EStrokeType } from '@netless/appliance-plugin';
plugin.setMemberState({
  currentApplianceName: ApplianceNames.pencil,
  strokeType: EStrokeType.Normal, autoShape: true
});
// 关闭时显式提交 false。
plugin.setMemberState({ autoShape: false });

保持 Pencil 教具，一笔完成并抬笔后尝试识别直线、箭头、矩形、椭圆/圆、三角形、菱形和五角星。识别失败保留普通笔迹；不会转换历史笔迹。

过滤笔记（Version ≥1.1.6）Copy Anchor Link

plugin.filterRenderByUid('mainView', {
  render: ['teacher-uid'], hide: ['student-uid']
}, false);
// 与设置时保持相同的 isSync 值。
plugin.cancelFilterRender('mainView', false);

render、hide 和 clear 的 UID 指笔迹所有者。各字段可为 UID 数组或 true；clear 配置哪些用户的笔迹可被清除，不能将它当作操作者身份授权。

isSync 默认 true，会同步给房间其他用户；只过滤本端时显式传 false。过滤用于呈现和操作配置，业务访问控制仍由服务端权限保证。

适用于 Whiteboard HarmonyOS SDK 0.2.11，内嵌 Appliance Plugin 1.1.45。本章的 Version 条件指插件版本。

Auto Shape：一笔绘制图形Copy Anchor Link

Auto Shape（Version ≥1.1.33）在用户用铅笔完成一笔绘制后，识别并整理为对应图形。支持直线、箭头、矩形、椭圆或圆形，以及三角形、菱形和五角星。

闭合图形尽量一笔闭合。识别针对当前完成的一笔，不会批量转换历史笔迹。

Native HarmonyOS 开启方式Copy Anchor Link

先按教具插件介绍开启 useMultiViews 和 enableAppliancePlugin，加入可写房间，在插件初始化完成后设置教具状态。

0.2.11 的 SDK MemberState 没有内置 autoShape 字段。应用可定义扩展 MemberState 的业务接口，声明插件接受的 autoShape 布尔值和 strokeType，通过公开的 controller.setMemberState(...) 提交。

将下面的业务接口与函数保存在应用的 .ets 文件中。AutoShapeMemberState 与 enableAutoShape/disableAutoShape 都由应用定义：

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 插件包。

关闭与状态记录Copy Anchor Link

调用 disableAutoShape(controller) 显式提交 autoShape=false。只提交不含该字段的普通 MemberState 不会自动清除此前开关。

SDK 的基础 MemberState 类型没有该字段，业务工具栏自行记录开关状态。扩展属性名需保持为 autoShape 和 strokeType；启用字段混淆时，保留这两个与运行时约定的名称。

这是业务模型扩展方式，使用 SDK 现有 Native 方法。开启后可在 HarmonyOS 白板组件中书写并确认识别效果。