@netless/appliance-plugin 1.1.34-beta.3 → 1.1.35-beta.0

package/READMA.zh-CN.md

@@ -342,6 +342,36 @@ room.setMemberState({currentApplianceName: ApplianceNames.laserPen, strokeType:
 ```
 ![Image](https://github.com/user-attachments/assets/3cd10c3a-b17b-4c01-b9d4-868c69116d96)
 
+##### Auto Shape: 一笔快速绘制成图形 (Version >=1.1.33)
+开启后，用户仍使用 `Pencil` 教具，抬笔时会尝试把这一笔手势识别成规则图形，并直接生成对应的 shape，而不是普通铅笔路径。
+
+```js
+import { ApplianceNames, EStrokeType } from '@netless/appliance-plugin';
+
+room.setMemberState({
+  currentApplianceName: ApplianceNames.pencil,
+  autoShape: true,
+  strokeType: EStrokeType.Normal,
+});
+```
+
+当前版本支持单笔识别以下图形：
+
+- `Straight`
+- `Arrow`
+- `Rectangle`
+- `Ellipse / Circle`
+- `Triangle`
+- `Rhombus`
+- `Five-point Star`
+
+建议：
+
+- 使用 `Pencil` 教具
+- 尽量一笔完成
+- 闭合绘制矩形、圆/椭圆、三角形、五角星
+- 箭头和直线保持单笔非闭合
+
 ##### 扩展教具 (Version >=1.1.1)
 在原来的[白板教具](https://doc.shengwang.cn/api-ref/whiteboard/javascript/globals.html#memberstate)类型上,增加了一些扩展功能属性,如下:
 
@@ -367,6 +397,8 @@ export type ExtendMemberState = {
     strokeOpacity?: number;
     /** 是否开启激光笔 */
     useLaserPen?: boolean;
+    /** 是否开启单笔自动识别图形 */
+    autoShape?: boolean;
     /** 激光笔保持时间, second */
     duration?: number;
     /** 填充样式 */
@@ -958,4 +990,4 @@ MIT License
 - [官方文档](https://doc.shengwang.cn/)
 
 
-## [changelog](https://github.com/duty-os/appliance-plugin/blob/master/CHANGELOG.md)
+## [changelog](https://github.com/duty-os/appliance-plugin/blob/master/CHANGELOG.md)

package/README.md

@@ -335,6 +335,36 @@ room.setMemberState({currentApplianceName: ApplianceNames.laserPen, strokeType:
 ```
 ![Image](https://github.com/user-attachments/assets/3cd10c3a-b17b-4c01-b9d4-868c69116d96)
 
+##### Auto Shape: One-stroke Quick Shape Drawing (Version >=1.1.33)
+When enabled, users still draw with the `Pencil` tool. On pointer up, the plugin tries to recognize the completed stroke as a regular shape and outputs the corresponding shape instead of a normal pencil path.
+
+```js
+import { ApplianceNames, EStrokeType } from '@netless/appliance-plugin';
+
+room.setMemberState({
+  currentApplianceName: ApplianceNames.pencil,
+  autoShape: true,
+  strokeType: EStrokeType.Normal,
+});
+```
+
+The current version supports single-stroke recognition for:
+
+- `Straight`
+- `Arrow`
+- `Rectangle`
+- `Ellipse / Circle`
+- `Triangle`
+- `Rhombus`
+- `Five-point Star`
+
+Recommendations:
+
+- Use the `Pencil` tool
+- Complete the gesture in one stroke
+- Draw `Rectangle`, `Ellipse / Circle`, `Triangle`, and `Five-point Star` as closed strokes
+- Draw `Arrow` and `Straight` as open single strokes
+
 ##### Extended Tools (Version >=1.1.1)
 On the original [whiteboard tools](https://api-ref.agora.io/en/interactive-whiteboard-sdk/web/2.x/globals.html#memberstate) type, some extended function attributes have been added, as follows:
 
@@ -360,6 +390,8 @@ export type ExtendMemberState = {
     strokeOpacity?: number;
     /** Whether to enable laser pointer */
     useLaserPen?: boolean;
+    /** Whether to enable one-stroke auto shape recognition */
+    autoShape?: boolean;
     /** Laser pointer holding time, second */
     duration?: number;
     /** Fill style */

package/cdn/cdn.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r="/fullWorker-cY8Uuj.js",e="/subWorker-BleGf3.js";exports.fullWorkerUrl=r;exports.subWorkerUrl=e;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r="/fullWorker-BShzOf.js",e="/subWorker-DofGU2.js";exports.fullWorkerUrl=r;exports.subWorkerUrl=e;