Auto Shape:一笔绘制图形

  • HarmonyOS

更新时间

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

Auto Shape:一笔绘制图形

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

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

Native HarmonyOS 开启方式

先按教具插件介绍开启 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 白板组件中书写并确认识别效果。