model-action-younuo 1.0.0 → 1.0.1

package/README.md

@@ -1,6 +1,6 @@
 # model-action-younuo
 
-优诺轻量化三维（iframe 内嵌）与外部页面的通信封装。
+三维轻量化三维（iframe 内嵌）与外部页面的通信封装。
 
 协议依据：[轻量化API接口协议-基线版本](https://docs.qq.com/doc/DTU9zRWRZZVVRU0FZ)  
 调用方法名尽量对齐 `model-action`，**发送的 fName / 字段以文档为准**。
@@ -81,6 +81,6 @@ await PathAction.pathShowHideRemove('remove')     // → faceLine clear
 ```ts
 // UE
 import { FocusAction, InitAction } from 'model-action'
-// 优诺
+// 三维
 import { FocusAction, InitAction } from 'model-action-younuo'
 ```

package/dist/modules/Action.d.ts

@@ -1,11 +1,11 @@
 /**
- * 优诺轻量化 iframe postMessage 通信核心
+ * 三维轻量化 iframe postMessage 通信核心
  * 调用风格对齐 UE 版 model-action 的 Action.sendParam
  */
 export type RequiredSome<T, K extends keyof T> = Required<Pick<T, K>> & Omit<T, K>;
 export interface SendParam {
     cmd: string;
-    /** 优诺函数名；不传则用 cmd */
+    /** 三维函数名；不传则用 cmd */
     fName?: string;
     data?: {
         action?: string;
@@ -46,14 +46,14 @@ export declare class Action {
     private static innerMessageHandlers;
     static setOnLog(onLog?: (...args: any[]) => void): void;
     static setConfig(partial: ModelBridgeConfig): void;
-    /** 指定优诺 iframe；不传则发送时取页面第一个 iframe */
+    /** 指定三维 iframe；不传则发送时取页面第一个 iframe */
     static setIframe(iframe: HTMLIFrameElement | null): void;
     static setTargetOrigin(origin: string): void;
     static onLoadStatusChange(handler: (success: boolean) => void): () => boolean;
     static onBuildEvent(handler: (info: any) => void): () => boolean;
     static onFloorEvent(handler: (params: any) => void): () => boolean;
     static onPoiEvent(handler: (params: any) => void): () => boolean;
-    /** 订阅优诺主动推送，返回取消订阅函数 */
+    /** 订阅三维主动推送，返回取消订阅函数 */
     static onInnerMessage(handler: (params: any) => void): () => boolean;
     private static generateRequestId;
     /** 应答配对：信封 requestId 优先，否则取 params.requestId */

package/dist/modules/Action.js

@@ -1,5 +1,5 @@
 /**
- * 优诺轻量化 iframe postMessage 通信核心
+ * 三维轻量化 iframe postMessage 通信核心
  * 调用风格对齐 UE 版 model-action 的 Action.sendParam
  */
 var __rest = (this && this.__rest) || function (s, e) {
@@ -24,7 +24,7 @@ export class Action {
         if (partial.onLog)
             this.onLog = partial.onLog;
     }
-    /** 指定优诺 iframe；不传则发送时取页面第一个 iframe */
+    /** 指定三维 iframe；不传则发送时取页面第一个 iframe */
     static setIframe(iframe) {
         this.iframe = iframe;
     }
@@ -47,7 +47,7 @@ export class Action {
         this.poiEventHandlers.add(handler);
         return () => this.poiEventHandlers.delete(handler);
     }
-    /** 订阅优诺主动推送，返回取消订阅函数 */
+    /** 订阅三维主动推送，返回取消订阅函数 */
     static onInnerMessage(handler) {
         this.innerMessageHandlers.add(handler);
         return () => this.innerMessageHandlers.delete(handler);
@@ -120,7 +120,7 @@ export class Action {
                 clearTimeout(timeoutHandle);
                 this.pendingRequests.delete(requestId);
                 (_c = this.onLog) === null || _c === void 0 ? void 0 : _c.call(this, {
-                    content: `发送给优诺失败: ${error}`,
+                    content: `发送给三维失败: ${error}`,
                     operTime: Date.now(),
                 });
                 reject(error);
@@ -187,7 +187,7 @@ Action.onWindowMessage = (event) => {
     if (!info || info.from !== 'inner')
         return;
     (_b = _a.onLog) === null || _b === void 0 ? void 0 : _b.call(_a, {
-        content: `收到优诺消息: ${JSON.stringify(info)}`,
+        content: `收到三维消息: ${JSON.stringify(info)}`,
         operTime: Date.now(),
     });
     const requestId = _a.resolveRequestId(info);

package/dist/modules/Init.d.ts

@@ -3,9 +3,9 @@
  */
 import { Action } from './Action';
 export interface InitVideoOptions {
-    /** 视频/三维容器；优诺模式下从中查找 iframe */
+    /** 视频/三维容器；三维模式下从中查找 iframe */
     container?: HTMLElement | null;
-    /** 直接指定优诺 iframe */
+    /** 直接指定三维 iframe */
     iframe?: HTMLIFrameElement | null;
     /** iframe CSS 选择器（相对 document 或 container） */
     iframeSelector?: string;
@@ -17,7 +17,7 @@ export interface InitVideoOptions {
     onLoadStatus?: (success: boolean) => void;
     /** 日志回调 */
     onLog?: (data: any) => void;
-    /** Pixel Streaming 专用字段（优诺忽略，保留以便切换包时类型兼容） */
+    /** Pixel Streaming 专用字段（三维忽略，保留以便切换包时类型兼容） */
     wsUrl?: string;
     onPlaying?: () => void;
     onQueueChange?: (seq: number) => void;
@@ -25,9 +25,9 @@ export interface InitVideoOptions {
 }
 export declare class InitAction extends Action {
     /**
-     * 初始化优诺 iframe 通信。
+     * 初始化三维 iframe 通信。
      * 与 UE 版同名：业务侧只需改 import 包名即可切换。
-     * @returns 优诺模式固定返回 null（无 peer-stream video）
+     * @returns 三维模式固定返回 null（无 peer-stream video）
      */
     static initVideo(options?: InitVideoOptions): null;
     /** 卸载监听（页面销毁时调用） */

package/dist/modules/Init.js

@@ -4,9 +4,9 @@
 import { Action } from './Action';
 export class InitAction extends Action {
     /**
-     * 初始化优诺 iframe 通信。
+     * 初始化三维 iframe 通信。
      * 与 UE 版同名：业务侧只需改 import 包名即可切换。
-     * @returns 优诺模式固定返回 null（无 peer-stream video）
+     * @returns 三维模式固定返回 null（无 peer-stream video）
      */
     static initVideo(options = {}) {
         var _a;

package/dist/modules/Path.d.ts

@@ -1,9 +1,9 @@
 /**
  * 轨迹 / 路径
- * 发送命令：优诺文档 faceLine（draw / clear / start）
+ * 发送命令：三维文档 faceLine（draw / clear / start）
  */
 import { Action } from './Action';
-/** 优诺轨迹点：[channelCode, similarity, time, imageUrl] */
+/** 三维轨迹点：[channelCode, similarity, time, imageUrl] */
 export type FaceLinePoint = [string, string, string, string] | string[];
 /** 路径点至少含 id（会映射为轨迹点 channelCode） */
 export interface PathPoint {
@@ -15,7 +15,7 @@ export declare class PathAction extends Action {
     /**
      * 绘制轨迹 → faceLine action=draw
      *
-     * @param points 优诺 FaceLinePoint[]，或 { id }[] / string[]
+     * @param points 三维 FaceLinePoint[]，或 { id }[] / string[]
      * @param pathPublicUsedType Person/Car（或 person/car）→ 文档 type
      */
     static pathAdd(points: Array<FaceLinePoint | PathPoint | string>, pathPublicUsedType?: PathPublicUsedType): Promise<any>;
@@ -31,11 +31,11 @@ export declare class PathAction extends Action {
      * pause / stop：文档无对应命令，不发送
      */
     static pathMove(action: 'start' | 'pause' | 'stop' | 'restart'): Promise<any>;
-    /** 优诺 faceLine 文档无此命令，保留方法名便于业务侧兼容 */
+    /** 三维 faceLine 文档无此命令，保留方法名便于业务侧兼容 */
     static pathUpdateMovingParam(): Promise<null>;
-    /** 优诺 faceLine 文档无此命令 */
+    /** 三维 faceLine 文档无此命令 */
     static pathBeginEdit(): Promise<null>;
-    /** 优诺 faceLine 文档无此命令 */
+    /** 三维 faceLine 文档无此命令 */
     static pathEndEdit(): Promise<null>;
 }
 /** @deprecated 请使用 PathAction；保留别名避免旧引用报错 */

package/dist/modules/Path.js

@@ -1,6 +1,6 @@
 /**
  * 轨迹 / 路径
- * 发送命令：优诺文档 faceLine（draw / clear / start）
+ * 发送命令：三维文档 faceLine（draw / clear / start）
  */
 import { Action } from './Action';
 function toFaceLinePoints(points) {
@@ -18,7 +18,7 @@ export class PathAction extends Action {
     /**
      * 绘制轨迹 → faceLine action=draw
      *
-     * @param points 优诺 FaceLinePoint[]，或 { id }[] / string[]
+     * @param points 三维 FaceLinePoint[]，或 { id }[] / string[]
      * @param pathPublicUsedType Person/Car（或 person/car）→ 文档 type
      */
     static pathAdd(points, pathPublicUsedType) {
@@ -41,7 +41,7 @@ export class PathAction extends Action {
                 action: 'clear',
             });
         }
-        console.warn('PathAction.pathShowHideRemove(show)：优诺文档无对应 faceLine 命令，已忽略');
+        console.warn('PathAction.pathShowHideRemove(show)：三维文档无对应 faceLine 命令，已忽略');
         return Promise.resolve(null);
     }
     /**
@@ -56,22 +56,22 @@ export class PathAction extends Action {
                 action: 'start',
             });
         }
-        console.warn(`PathAction.pathMove(${action})：优诺文档仅支持 faceLine action=start，已忽略`);
+        console.warn(`PathAction.pathMove(${action})：三维文档仅支持 faceLine action=start，已忽略`);
         return Promise.resolve(null);
     }
-    /** 优诺 faceLine 文档无此命令，保留方法名便于业务侧兼容 */
+    /** 三维 faceLine 文档无此命令，保留方法名便于业务侧兼容 */
     static pathUpdateMovingParam() {
-        console.warn('PathAction.pathUpdateMovingParam：优诺文档无对应命令，已忽略');
+        console.warn('PathAction.pathUpdateMovingParam：三维文档无对应命令，已忽略');
         return Promise.resolve(null);
     }
-    /** 优诺 faceLine 文档无此命令 */
+    /** 三维 faceLine 文档无此命令 */
     static pathBeginEdit() {
-        console.warn('PathAction.pathBeginEdit：优诺文档无对应命令，已忽略');
+        console.warn('PathAction.pathBeginEdit：三维文档无对应命令，已忽略');
         return Promise.resolve(null);
     }
-    /** 优诺 faceLine 文档无此命令 */
+    /** 三维 faceLine 文档无此命令 */
     static pathEndEdit() {
-        console.warn('PathAction.pathEndEdit：优诺文档无对应命令，已忽略');
+        console.warn('PathAction.pathEndEdit：三维文档无对应命令，已忽略');
         return Promise.resolve(null);
     }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "model-action-younuo",
-  "version": "1.0.0",
-  "description": "优诺轻量化 iframe 与外部通信 API（接口风格对齐 model-action）",
+  "version": "1.0.1",
+  "description": "三维轻量化 iframe 与外部通信 API（接口风格对齐 model-action）",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {

package/src/modules/Action.ts

@@ -1,5 +1,5 @@
 /**
- * 优诺轻量化 iframe postMessage 通信核心
+ * 三维轻量化 iframe postMessage 通信核心
  * 调用风格对齐 UE 版 model-action 的 Action.sendParam
  */
 
@@ -7,7 +7,7 @@ export type RequiredSome<T, K extends keyof T> = Required<Pick<T, K>> & Omit<T,
 
 export interface SendParam {
     cmd: string;
-    /** 优诺函数名；不传则用 cmd */
+    /** 三维函数名；不传则用 cmd */
     fName?: string;
     data?: {
         action?: string;
@@ -68,7 +68,7 @@ export class Action {
         if (partial.onLog) this.onLog = partial.onLog;
     }
 
-    /** 指定优诺 iframe；不传则发送时取页面第一个 iframe */
+    /** 指定三维 iframe；不传则发送时取页面第一个 iframe */
     static setIframe(iframe: HTMLIFrameElement | null) {
         this.iframe = iframe;
     }
@@ -97,7 +97,7 @@ export class Action {
         return () => this.poiEventHandlers.delete(handler);
     }
 
-    /** 订阅优诺主动推送，返回取消订阅函数 */
+    /** 订阅三维主动推送，返回取消订阅函数 */
     static onInnerMessage(handler: (params: any) => void) {
         this.innerMessageHandlers.add(handler);
         return () => this.innerMessageHandlers.delete(handler);
@@ -180,7 +180,7 @@ export class Action {
                 clearTimeout(timeoutHandle);
                 this.pendingRequests.delete(requestId);
                 this.onLog?.({
-                    content: `发送给优诺失败: ${error}`,
+                    content: `发送给三维失败: ${error}`,
                     operTime: Date.now(),
                 });
                 reject(error);
@@ -215,7 +215,7 @@ export class Action {
         if (!info || info.from !== 'inner') return;
 
         this.onLog?.({
-            content: `收到优诺消息: ${JSON.stringify(info)}`,
+            content: `收到三维消息: ${JSON.stringify(info)}`,
             operTime: Date.now(),
         });
 

package/src/modules/Init.ts

@@ -4,9 +4,9 @@
 import { Action, ModelBridgeConfig } from './Action';
 
 export interface InitVideoOptions {
-    /** 视频/三维容器；优诺模式下从中查找 iframe */
+    /** 视频/三维容器；三维模式下从中查找 iframe */
     container?: HTMLElement | null;
-    /** 直接指定优诺 iframe */
+    /** 直接指定三维 iframe */
     iframe?: HTMLIFrameElement | null;
     /** iframe CSS 选择器（相对 document 或 container） */
     iframeSelector?: string;
@@ -18,7 +18,7 @@ export interface InitVideoOptions {
     onLoadStatus?: (success: boolean) => void;
     /** 日志回调 */
     onLog?: (data: any) => void;
-    /** Pixel Streaming 专用字段（优诺忽略，保留以便切换包时类型兼容） */
+    /** Pixel Streaming 专用字段（三维忽略，保留以便切换包时类型兼容） */
     wsUrl?: string;
     onPlaying?: () => void;
     onQueueChange?: (seq: number) => void;
@@ -27,9 +27,9 @@ export interface InitVideoOptions {
 
 export class InitAction extends Action {
     /**
-     * 初始化优诺 iframe 通信。
+     * 初始化三维 iframe 通信。
      * 与 UE 版同名：业务侧只需改 import 包名即可切换。
-     * @returns 优诺模式固定返回 null（无 peer-stream video）
+     * @returns 三维模式固定返回 null（无 peer-stream video）
      */
     static initVideo(options: InitVideoOptions = {}): null {
         Action.setOnLog(options.onLog);

package/src/modules/Path.ts

@@ -1,10 +1,10 @@
 /**
  * 轨迹 / 路径
- * 发送命令：优诺文档 faceLine（draw / clear / start）
+ * 发送命令：三维文档 faceLine（draw / clear / start）
  */
 import { Action } from './Action';
 
-/** 优诺轨迹点：[channelCode, similarity, time, imageUrl] */
+/** 三维轨迹点：[channelCode, similarity, time, imageUrl] */
 export type FaceLinePoint = [string, string, string, string] | string[];
 
 /** 路径点至少含 id（会映射为轨迹点 channelCode） */
@@ -28,7 +28,7 @@ export class PathAction extends Action {
     /**
      * 绘制轨迹 → faceLine action=draw
      *
-     * @param points 优诺 FaceLinePoint[]，或 { id }[] / string[]
+     * @param points 三维 FaceLinePoint[]，或 { id }[] / string[]
      * @param pathPublicUsedType Person/Car（或 person/car）→ 文档 type
      */
     static pathAdd(
@@ -55,7 +55,7 @@ export class PathAction extends Action {
                 action: 'clear',
             });
         }
-        console.warn('PathAction.pathShowHideRemove(show)：优诺文档无对应 faceLine 命令，已忽略');
+        console.warn('PathAction.pathShowHideRemove(show)：三维文档无对应 faceLine 命令，已忽略');
         return Promise.resolve(null);
     }
 
@@ -72,26 +72,26 @@ export class PathAction extends Action {
             });
         }
         console.warn(
-            `PathAction.pathMove(${action})：优诺文档仅支持 faceLine action=start，已忽略`
+            `PathAction.pathMove(${action})：三维文档仅支持 faceLine action=start，已忽略`
         );
         return Promise.resolve(null);
     }
 
-    /** 优诺 faceLine 文档无此命令，保留方法名便于业务侧兼容 */
+    /** 三维 faceLine 文档无此命令，保留方法名便于业务侧兼容 */
     static pathUpdateMovingParam() {
-        console.warn('PathAction.pathUpdateMovingParam：优诺文档无对应命令，已忽略');
+        console.warn('PathAction.pathUpdateMovingParam：三维文档无对应命令，已忽略');
         return Promise.resolve(null);
     }
 
-    /** 优诺 faceLine 文档无此命令 */
+    /** 三维 faceLine 文档无此命令 */
     static pathBeginEdit() {
-        console.warn('PathAction.pathBeginEdit：优诺文档无对应命令，已忽略');
+        console.warn('PathAction.pathBeginEdit：三维文档无对应命令，已忽略');
         return Promise.resolve(null);
     }
 
-    /** 优诺 faceLine 文档无此命令 */
+    /** 三维 faceLine 文档无此命令 */
     static pathEndEdit() {
-        console.warn('PathAction.pathEndEdit：优诺文档无对应命令，已忽略');
+        console.warn('PathAction.pathEndEdit：三维文档无对应命令，已忽略');
         return Promise.resolve(null);
     }
 }