earthsdk3 3.0.7-beta.9 → 3.0.7

package/dist/types/ESObjects/general/ESCameraViewCollection/index.d.ts

@@ -3,16 +3,57 @@ import { ESJViewInfo } from "../../../ESJTypes";
 import { ESSceneObject } from "../../base";
 import { ViewWrapper } from "./ViewWrapper";
 /**
+ * ESCameraViewCollection 类用于管理和控制一组相机视角。它继承自 ESSceneObject 类，提供了一系列方法来添加、删除、更新和切换相机视角。
+ *
+ * 核心功能包括：
+ * - 管理一组相机视角（添加、删除、更新视角信息）
+ * - 切换当前视角
+ * - 飞行到指定视角
+ * - 播放视角序列
+ * - 停止播放
+ * - 获取和设置视角集合的 JSON 表示
+ *
+ * 使用示例：
  * https://www.wolai.com/earthsdk/eV1jsaXWLWjaetTVCeSvww
  * https://c0yh9tnn0na.feishu.cn/wiki/VYnPwLAY4iUVQfkAuXWcuFKDnmh
+ * 构造函数参数：
+ * - `id`：对象的 ID，可选。
+ *
+ * 特殊使用限制或潜在的副作用：
+ * - 在设置视角信息时，如果视角信息数组与当前视角包装器数组长度相同且内容相同，则不会触发更新。
+ * - 在删除视角时，如果索引超出范围，会打印警告信息。
+ * - 在飞行到视角时，如果当前视角包装器为空，会抛出错误。
+ *
+ * 默认属性：
+ * - `loop`：是否循环播放视角序列，默认为 true。
+ * - `playing`：是否正在播放视角序列，默认为 false。
+ * - `intervalTime`：视角之间的间隔时间（秒），默认为 5。
+ * - `duration`：视角的飞行时间（秒），默认为 1。
+ * - `views`：视角信息数组，默认为空数组。
+ * - `flyMode`：飞行模式，默认为 'default'，可选值  [['默认', 'default'], ['直线飞行', 'uniform']]。
  */
 export declare class ESCameraViewCollection extends ESSceneObject {
+    /**
+     * 静态属性，用于注册该类的类型信息，包含中文名称、标签和描述。
+     */
     static readonly type: string;
+    /**
+     * 获取类的类型名称。
+     * @returns 类型名称字符串。
+     */
     get typeName(): string;
+    /**
+     * 重写方法，获取默认属性。
+     * @returns 默认属性对象。
+     */
     get defaultProps(): {
+        /**开始播放 */
         playing: boolean;
+        /**是否循环 */
         loop: boolean;
+        /**间隔时间 */
         intervalTime: number;
+        /**飞行模式 默认为相机飞行，uniform为两点直线飞行*/
         flyMode: "default" | "uniform";
         name: string;
         ref: string | undefined;
@@ -22,125 +63,183 @@ export declare class ESCameraViewCollection extends ESSceneObject {
         updateFuncStr: string | undefined;
         toDestroyFuncStr: string | undefined;
     };
+    /**
+     * 重写方法，获取对象的 JSON 表示。
+     * @returns 包含视图信息的 JSON 对象。
+     */
     get json(): JsonType;
+    /**
+     * 重写方法，设置对象的 JSON 表示。
+     * @param value 要设置的 JSON 对象。
+     */
     set json(value: JsonType);
+    /**
+     * 私有属性，当前视角的索引。
+     */
     private _currentViewIndex;
+    /**
+     * 获取当前视角的索引。
+     * @returns 当前视角的索引。
+     */
     get currentViewIndex(): number;
+    /**
+     * 获取当前视角索引变化的可观察对象。
+     * @returns 当前视角索引变化的可观察对象。
+     */
     get currentViewIndexChanged(): import("xbsj-base").Listener<[number, number]>;
+    /**
+     * 私有属性，视角包装器的可观察数组。
+     */
     private _viewWrappers;
+    /**
+     * 私有属性，当前视角的包装器。
+     */
     private _currentViewWrapper;
+    /**
+     * 触发视图包装器变化的事件。
+     */
     emitViewsWarpper(): void;
+    /**
+     * 私有属性，容器元素。
+     */
     private _container;
+    /**
+     * 获取容器元素。
+     * @returns 容器元素。
+     */
     get container(): HTMLDivElement | undefined;
+    /**
+     * 获取容器元素变化的可观察对象。
+     * @returns 容器元素变化的可观察对象。
+     */
     get containerChanged(): import("xbsj-base").Listener<[HTMLDivElement | undefined, HTMLDivElement | undefined]>;
+    /**
+     * 设置容器元素。
+     * @param value 要设置的容器元素。
+     */
     set container(value: HTMLDivElement | undefined);
+    /**
+     * 获取所有视角的信息。
+     * @returns 视角信息数组。
+     */
     get views(): ESJViewInfo[];
+    /**
+     * 获取视图信息变化的事件。
+     * @returns 视图信息变化的事件。
+     */
     get viewsChanged(): import("xbsj-base").Event<[target: ObservableArray<ViewWrapper>]>;
+    /**
+     * 设置视图信息。
+     * @param value 要设置的视图信息数组。
+     */
     set views(value: ESJViewInfo[]);
     /**
-     * 获取当前视角的index
-     * @param viewWrapper 当前选中的视角
-     * @returns 选中视角的index
+     * 获取指定视角包装器的索引。
+     * @param viewWrapper 当前选中的视角包装器。
+     * @returns 选中视角的索引。
      */
     private _getIndex;
     /**
-     * 删除所有视角
+     * 删除所有视角。
      */
     clearAllViews(): void;
     /**
-     * 添加视角
-     * @param name 视角名称 string | undefined ,默认 `视角${views.length+ 1}`
-     * @param size 截图尺寸 [number, number]  | undefined,默认[64, 64]
+     * 添加视角。
+     * @param name 视角名称，默认为 `视角${views.length+ 1}`。
+     * @param size 截图尺寸，默认为[64, 64]。
      */
     add(name?: string, size?: [number, number]): void;
     /**
-     * 更新视角
-     * @param index 更新指定位置的视角 number
-     * @param name 视角名称 string | undefined
-     * @param size 截图尺寸 [number, number]  | undefined,默认[64, 64]
+     * 更新指定位置的视角。
+     * @param index 更新指定位置的视角索引。
+     * @param name 视角名称，可选。
+     * @param size 截图尺寸，默认为[64, 64]。
+     * @returns 更新是否成功。
      */
-    update(index: number, name?: string, size?: [number, number]): false | undefined;
+    update(index: number, name?: string, size?: [number, number]): boolean;
     /**
-     * 添加视角
+     * 添加视角。
      */
     addView(): void;
     /**
-     * 插入视角
-     * @param index 当前视角的index
-     * @returns
+     * 插入视角。
+     * @param index 当前视角的索引。
      */
     insertView(index: number): void;
     /**
-     * 设置当前视角
-     * @param index 当前视角的index
-     * @returns
+     * 设置当前视角。
+     * @param index 当前视角的索引。
+     * @returns 设置是否成功。
      */
     setCurrentView(index: number): boolean;
     /**
-     * 重置视角
-     * @param index 当前视角的index
-     * @returns
+     * 重置指定位置的视角。
+     * @param index 当前视角的索引。
      */
     resetView(index: number): void;
     /**
-     * 重置视角名称
-     * @param index 当前视角的index
-     * @returns
+     * 重置指定位置视角的名称。
+     * @param index 当前视角的索引。
+     * @param value 要设置的视角名称。
      */
     resetViewName(index: number, value: string): void;
     /**
-     * 修改指定视角
-     * @param index 当前视角的index
-     * @returns
+     * 修改指定位置的视角信息。
+     * @param index 当前视角的索引。
+     * @param val 要设置的视角信息。
+     * @returns 修改是否成功。
      */
-    updateView(index: number, val: ESJViewInfo): false | undefined;
+    updateView(index: number, val: ESJViewInfo): boolean;
     /**
-     * 飞入指定视角
-     * @param index
+     * 飞入指定视角。
+     * @param index 要飞入的视角索引。
      */
     flyToView(index: number): void;
     /**
-     * 上一个视角
-     * @returns
+     * 飞入上一个视角。
+     * @returns 飞入是否成功。
      */
     flyToPrevView(): boolean;
     /**
-    * 当前视角移动到上一个视角
-    * @returns
-    */
+     * 将当前视角移动到上一个位置。
+     */
     moveToPreView(): void;
     /**
-   * 当前视角移动到下一个视角
-   * @returns
-   */
+     * 将当前视角移动到下一个位置。
+     */
     moveToNextView(): void;
     /**
-     * 下一个视角
-     * @returns
+     * 飞入下一个视角。
+     * @returns 飞入是否成功。
      */
     flyToNextView(): boolean;
     /**
-     * 停止
+     * 停止播放。
      */
     stop(): void;
     /**
-     * 删除指定视角
-     * @param index 要删除视角的index
-     * @returns
+     * 删除指定视角。
+     * @param index 要删除视角的索引。
      */
     deleteView(index: number): void;
     /**
-     * 删除当前视角
-     * @returns
+     * 删除当前视角。
      */
     deleteCurrentView(): void;
     /**
-     * 转换图片路径
-     * @param url 图片路径
-     * @returns 转化以后的图片路径
+     * 转换图片路径。
+     * @param url 图片路径。
+     * @returns 转换后的图片路径。
      */
     transitionImageUrl(url: string): string;
+    /**
+     * 构造函数。
+     * @param id 对象的 ID，可选。
+     */
     constructor(id?: string);
+    /**
+     * 静态属性，默认配置。
+     */
     static defaults: {
         loop: boolean;
         playing: boolean;
@@ -150,13 +249,26 @@ export declare class ESCameraViewCollection extends ESSceneObject {
         flyMode: "default" | "uniform";
         flyModes: [name: string, value: string][];
     };
+    /**
+     * 获取对象的属性列表。
+     * @param language 语言，可选。
+     * @returns 属性列表。
+     */
     getProperties(language?: string): import("../../../ESJTypes").Property[];
 }
 export declare namespace ESCameraViewCollection {
+    /**
+     * 创建默认属性对象。
+     * @returns 默认属性对象。
+     */
     const createDefaultProps: () => {
+        /**开始播放 */
         playing: boolean;
+        /**是否循环 */
         loop: boolean;
+        /**间隔时间 */
         intervalTime: number;
+        /**飞行模式 默认为相机飞行，uniform为两点直线飞行*/
         flyMode: "default" | "uniform";
         name: string;
         ref: string | undefined;
@@ -167,8 +279,14 @@ export declare namespace ESCameraViewCollection {
         toDestroyFuncStr: string | undefined;
     };
 }
+/**
+ * 定义 ESCameraViewCollection 类的扩展接口，包含属性变化的相关方法。
+ */
 export interface ESCameraViewCollection extends UniteChanged<ReturnType<typeof ESCameraViewCollection.createDefaultProps>> {
 }
+/**
+ * 定义 JSON 类型，包含默认属性、类型和视图信息。
+ */
 type JsonType = UniteJson<ReturnType<typeof ESCameraViewCollection.createDefaultProps> & {
     type: string;
 } & {

package/dist/types/ESObjects/general/ESCameraViewCollection/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ESObjects/general/ESCameraViewCollection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,eAAe,EAAgB,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACpI,OAAO,EAAiC,WAAW,EAAqF,MAAM,mBAAmB,CAAC;AAElK,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;IACrD,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAkJ;IACtK,IAAI,QAAQ,WAAuC;IACnD,IAAa,YAAY;;;;iBA+YC,SAAS,GAAG,SAAS;;;;;;;;MA/YoC;IACnF,IAAa,IAAI,IACQ,QAAQ,CADsE;IACvG,IAAa,IAAI,CAAC,KAAK,EAAE,QAAQ,EAA0D;IAE3F,OAAO,CAAC,iBAAiB,CAA8B;IACvD,IAAI,gBAAgB,WAA2C;IAC/D,IAAI,uBAAuB,mDAA6C;IAExE,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,mBAAmB,CAAsD;IACjF,gBAAgB;IAEhB,OAAO,CAAC,UAAU,CAAyD;IAC3E,IAAI,SAAS,IAEQ,cAAc,GAAG,SAAS,CAFE;IACjD,IAAI,gBAAgB,2FAAsC;IAC1D,IAAI,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,EAAoC;IAEnF,IAAI,KAAK,IAEQ,WAAW,EAAE,CAFkC;IAChE,IAAI,YAAY,sEAA8C;IAC9D,IAAI,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,EAa7B;IAED;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,aAAa;IAOb;;;;OAIG;IACH,GAAG,CAAC,IAAI,GAAE,MAAqC,EAAE,IAAI,GAAE,CAAC,MAAM,EAAE,MAAM,CAAY;IAGlF;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,CAAC,MAAM,EAAE,MAAM,CAAY;IAWtE;;OAEG;IACH,OAAO;IAEP;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM;IAQxB;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM;IAY5B;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM;IASvB;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAS1C;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW;IAe1C;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM;IAQvB;;;OAGG;IACH,aAAa;IAoBb;;;MAGE;IACF,aAAa;IAQb;;;KAGC;IACD,cAAc;IASd;;;OAGG;IACH,aAAa;IAoBb;;OAEG;IACH,IAAI;IAKJ;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM;IAUxB;;;OAGG;IACH,iBAAiB;IAcjB;;;;OAIG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM;gBAIlB,EAAE,CAAC,EAAE,MAAM;IAqDvB,OAAgB,QAAQ;;;;;;iBAOE,SAAS,GAAG,SAAS;kBACW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE;MACvF;IAEO,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM;CA+B3C;AAED,yBAAiB,sBAAsB,CAAC;IAC7B,MAAM,kBAAkB;;;;iBAKL,SAAS,GAAG,SAAS;;;;;;;;KAC7C,CAAC;CACN;AAED,MAAM,WAAW,sBAAuB,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,kBAAkB,CAAC,CAAC;CAAI;AAC9H,KAAK,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,kBAAkB,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ESObjects/general/ESCameraViewCollection/index.ts"],"names":[],"mappings":"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"}

package/dist/types/ESObjects/general/ESCameraVisibleRange.d.ts

@@ -2,16 +2,57 @@ import { UniteChanged } from "xbsj-base";
 import { ESJEditingBindModeType } from "../../ESJTypes";
 import { ESObjectWithLocation } from "../base";
 /**
- * https://www.wolai.com/earthsdk/uraiJ6nPZBuNTiNMsx78vP
+ * ESCameraVisibleRange 类用于表示和操作摄像头可视域。
+ * 该类继承自 ESObjectWithLocation，提供了摄像头可视域相关的属性和方法。
+ *
+ * 核心功能包括：
+ * - 管理摄像头可视域的基本属性，如横向夹角（fov）、宽高比（aspectRatio）、视野长度（far）和近面距离（near）。
+ * - 提供默认属性和属性编辑模式。
+ * - 支持属性的获取和设置。
+ *
+ * 使用示例：
+ *
+ * 构造函数参数：
+ * - `id`：实例的可选 ID，用于唯一标识该实例。
+ *
+ * 特殊使用限制或潜在的副作用：
+ * - 无特殊使用限制或潜在的副作用。
  */
 export declare class ESCameraVisibleRange extends ESObjectWithLocation {
+    /**
+     * 静态属性，用于注册类的类型信息。
+     * 包含类名、类本身、中文名称、标签和描述。
+     */
     static readonly type: string;
+    /**
+     * 获取类的类型名称。
+     * @returns 类的类型名称，固定为 'ESCameraVisibleRange'。
+     */
     get typeName(): string;
+    /**
+     * 重写默认属性方法，返回创建的默认属性。
+     * @returns 默认属性对象。
+     */
     get defaultProps(): {
+        /**
+         * 横向夹角，默认值为 90 度。
+         */
         fov: number;
+        /**
+         * 宽高比，默认值为 1.77778（16:9）。
+         */
         aspectRatio: number;
+        /**
+         * 视野长度，默认值为 100 米。
+         */
         far: number;
+        /**
+         * 近面距离，默认值为 5 米。
+         */
         near: number;
+        /**
+         * 是否启用碰撞检测，默认值为 false。
+         */
         collision: boolean;
         position: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJVector3D>;
         rotation: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJVector3D>;
@@ -30,8 +71,18 @@ export declare class ESCameraVisibleRange extends ESObjectWithLocation {
         updateFuncStr: string | undefined;
         toDestroyFuncStr: string | undefined;
     };
+    /**
+     * 构造函数，用于创建 ESCameraVisibleRange 实例。
+     * @param id - 实例的可选 ID。
+     */
     constructor(id?: string);
+    /**
+     * 重写编辑绑定模式，固定为 "doublePoints"。
+     */
     editingBindMode: ESJEditingBindModeType;
+    /**
+     * 静态重写默认值，包含父类的默认值以及摄像头可视域的相关默认值。
+     */
     static defaults: {
         fov: number;
         aspectRatio: number;
@@ -43,6 +94,10 @@ export declare class ESCameraVisibleRange extends ESObjectWithLocation {
         flyToParam: import("../../ESJTypes").ESJFlyToParam;
         flyInParam: import("../../ESJTypes").ESJFlyInParam;
     };
+    /**
+     * 重写获取 ES 属性的方法，返回包含基本属性的对象。
+     * @returns 包含 ES 属性的对象。
+     */
     getESProperties(): {
         basic: import("../../ESJTypes").Property[];
         defaultMenu: string;
@@ -52,14 +107,41 @@ export declare class ESCameraVisibleRange extends ESObjectWithLocation {
         coordinate: import("../../ESJTypes").Property[];
         style: import("../../ESJTypes").Property[];
     };
+    /**
+     * 重写获取属性的方法，返回包含特定属性的数组。
+     * @param language - 可选的语言参数。
+     * @returns 包含属性的数组。
+     */
     getProperties(language?: string): import("../../ESJTypes").Property[];
 }
+/**
+ * ESCameraVisibleRange 的命名空间，包含创建默认属性的方法。
+ */
 export declare namespace ESCameraVisibleRange {
+    /**
+     * 创建默认属性的方法，返回包含默认属性的对象。
+     * @returns 默认属性对象。
+     */
     const createDefaultProps: () => {
+        /**
+         * 横向夹角，默认值为 90 度。
+         */
         fov: number;
+        /**
+         * 宽高比，默认值为 1.77778（16:9）。
+         */
         aspectRatio: number;
+        /**
+         * 视野长度，默认值为 100 米。
+         */
         far: number;
+        /**
+         * 近面距离，默认值为 5 米。
+         */
         near: number;
+        /**
+         * 是否启用碰撞检测，默认值为 false。
+         */
         collision: boolean;
         position: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJVector3D>;
         rotation: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJVector3D>;
@@ -79,6 +161,9 @@ export declare namespace ESCameraVisibleRange {
         toDestroyFuncStr: string | undefined;
     };
 }
+/**
+ * 定义 ESCameraVisibleRange 的接口，继承自 UniteChanged，泛型参数为创建默认属性方法的返回类型。
+ */
 export interface ESCameraVisibleRange extends UniteChanged<ReturnType<typeof ESCameraVisibleRange.createDefaultProps>> {
 }
 //# sourceMappingURL=ESCameraVisibleRange.d.ts.map

package/dist/types/ESObjects/general/ESCameraVisibleRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ESCameraVisibleRange.d.ts","sourceRoot":"","sources":["../../../../src/ESObjects/general/ESCameraVisibleRange.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAkB,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,oBAAoB;IAC1D,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAoJ;IACxK,IAAI,QAAQ,WAAqC;IACjD,IAAa,YAAY;;;;;;;;;;;;;;;;;;;;;;MAAwD;gBACrE,EAAE,CAAC,EAAE,MAAM;IAGd,eAAe,EAAE,sBAAsB,CAAkB;IAClE,OAAgB,QAAQ;;;;;;;;;;MAOtB;IACO,eAAe;;;;;;;;;IAaf,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM;CAS3C;AAED,yBAAiB,oBAAoB,CAAC;IAC3B,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;KAO7B,CAAC;CACN;AAED,MAAM,WAAW,oBAAqB,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;CAAI"}
+{"version":3,"file":"ESCameraVisibleRange.d.ts","sourceRoot":"","sources":["../../../../src/ESObjects/general/ESCameraVisibleRange.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAkB,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,oBAAqB,SAAQ,oBAAoB;IAC1D;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAoJ;IAExK;;;OAGG;IACH,IAAI,QAAQ,WAAqC;IAEjD;;;OAGG;IACH,IAAa,YAAY;QAuErB;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;;;;;;;;;;;;;;;;;MAzF0E;IAEjF;;;OAGG;gBACS,EAAE,CAAC,EAAE,MAAM;IAIvB;;OAEG;IACM,eAAe,EAAE,sBAAsB,CAAkB;IAElE;;OAEG;IACH,OAAgB,QAAQ;;;;;;;;;;MAOtB;IAEF;;;OAGG;IACM,eAAe;;;;;;;;;IAcxB;;;;OAIG;IACM,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM;CAS3C;AAED;;GAEG;AACH,yBAAiB,oBAAoB,CAAC;IAClC;;;OAGG;IACI,MAAM,kBAAkB;QAE3B;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;;;;;;;;;;;;;;;;;KAEL,CAAC;CACN;AAOD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;CAAI"}

package/dist/types/ESObjects/general/ESCar.d.ts

@@ -1,13 +1,42 @@
 import { ReactivePropsToNativePropsAndChanged, SceneObjectKey } from "xbsj-base";
 import { ESObjectWithLocation } from "../base";
 /**
- * https://www.wolai.com/earthsdk/g47RywL4KaFpET1CGJVZQQ
+ * ESCar 类表示基础车辆模型，如警车等。
+ * 该类继承自 ESObjectWithLocation，并添加了车辆模式的相关属性和方法。
+ *
+ * 核心功能包括：
+ * - 注册类类型信息
+ * - 获取类类型名称
+ * - 重写默认属性，包括模式枚举和默认模式
+ * - 获取 ES 属性，包括车辆模式枚举属性
+ * - 获取属性，包括通用组属性
+ *
+ * 使用示例：
+ *
+ * 构造函数参数：
+ * - `id`：场景对象键，用于唯一标识该车辆对象，可选参数。
+ *
+ * 特殊使用限制或潜在的副作用：
+ * - 无特殊使用限制或潜在的副作用。
  */
 export declare class ESCar extends ESObjectWithLocation {
+    /**
+     * 注册类的类型信息，包含类名、类本身、中文名称、标签和描述。
+     * 这里注册的类名为 'ESCar'，中文名称为 '车辆'，标签包含 'ESObjects'、'_ES_Impl_Cesium'、'_ES_Impl_UE'，
+     * 描述为 "警车等基础车辆模型"。
+     */
     static readonly type: string;
+    /**
+     * 获取类的类型名称，返回 'ESCar'。
+     */
     get typeName(): string;
+    /**
+     * 重写默认属性，返回通过 `ESCar.createDefaultProps()` 创建的默认属性。
+     */
     get defaultProps(): {
+        /**模式 目前仅支持 policeCar */
         mode: string;
+        /**是否允许被拾取 */
         allowPicking: boolean;
         position: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJVector3D>;
         rotation: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJVector3D>;
@@ -26,6 +55,12 @@ export declare class ESCar extends ESObjectWithLocation {
         updateFuncStr: string | undefined;
         toDestroyFuncStr: string | undefined;
     };
+    /**
+     * 重写的默认值对象，继承自 `ESObjectWithLocation.defaults`，
+     * 并添加了 `modeEnum` 模式枚举和 `mode` 默认模式。
+     * `modeEnum` 是一个二维数组，包含模式的名称和对应的值，这里默认只有 "警车" 模式，值为 'policeCar'。
+     * `mode` 默认模式为 'policeCar'。
+     */
     static defaults: {
         modeEnum: [name: string, value: string][];
         mode: string;
@@ -35,7 +70,17 @@ export declare class ESCar extends ESObjectWithLocation {
         flyToParam: import("../../ESJTypes").ESJFlyToParam;
         flyInParam: import("../../ESJTypes").ESJFlyInParam;
     };
+    /**
+     * 构造函数，可传入一个可选的场景对象键 `id`。
+     * @param id - 场景对象键，用于唯一标识该车辆对象，可选参数。
+     */
     constructor(id?: SceneObjectKey);
+    /**
+     * 重写获取 ES 属性的方法。
+     * 首先获取父类的 ES 属性，然后在 `basic` 属性组中添加一个 `EnumProperty` 枚举属性，
+     * 该属性用于表示车辆的模式，默认值为 'policeCar'。
+     * @returns 包含 ES 属性的对象。
+     */
     getESProperties(): {
         basic: import("../../ESJTypes").Property[];
         defaultMenu: string;
@@ -45,11 +90,30 @@ export declare class ESCar extends ESObjectWithLocation {
         coordinate: import("../../ESJTypes").Property[];
         style: import("../../ESJTypes").Property[];
     };
+    /**
+     * 重写获取属性的方法。
+     * 首先获取父类的属性，然后添加一个 `GroupProperty` 组属性，
+     * 该组属性名为 '通用'，包含一个 `EnumProperty` 枚举属性，用于表示车辆的模式。
+     * @param language - 语言参数，可选，用于指定属性的显示语言。
+     * @returns 包含属性的数组。
+     */
     getProperties(language?: string): import("../../ESJTypes").Property[];
 }
+/**
+ * ESCar 类的命名空间，包含创建默认属性的静态方法。
+ */
 export declare namespace ESCar {
+    /**
+     * 创建默认属性的方法。
+     * 继承自 `ESObjectWithLocation.createDefaultProps()` 的属性，
+     * 并添加了 `mode` 模式属性，默认值为 'policeCar'，
+     * 以及 `allowPicking` 属性，默认值为 `true`，表示允许被选中。
+     * @returns 包含默认属性的对象。
+     */
     const createDefaultProps: () => {
+        /**模式 目前仅支持 policeCar */
         mode: string;
+        /**是否允许被拾取 */
         allowPicking: boolean;
         position: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJVector3D>;
         rotation: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJVector3D>;
@@ -69,6 +133,10 @@ export declare namespace ESCar {
         toDestroyFuncStr: string | undefined;
     };
 }
+/**
+ * 扩展 `ESCar` 类的接口，使其具有 `ReactivePropsToNativePropsAndChanged` 类型的属性，
+ * 属性类型为 `ESCar.createDefaultProps()` 返回的类型。
+ */
 export interface ESCar extends ReactivePropsToNativePropsAndChanged<ReturnType<typeof ESCar.createDefaultProps>> {
 }
 //# sourceMappingURL=ESCar.d.ts.map

package/dist/types/ESObjects/general/ESCar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ESCar.d.ts","sourceRoot":"","sources":["../../../../src/ESObjects/general/ESCar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,oCAAoC,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAG/C;;GAEG;AACH,qBAAa,KAAM,SAAQ,oBAAoB;IAC3C,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAoI;IACxJ,IAAI,QAAQ,WAAsB;IAClC,IAAa,YAAY;;;;;;;;;;;;;;;;;;;MAAyC;IAElE,OAAgB,QAAQ;kBAEe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE;;;;;;;MAErE;gBAEW,EAAE,CAAC,EAAE,cAAc;IAGtB,eAAe;;;;;;;;;IAWf,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM;CAQ3C;AAED,yBAAiB,KAAK,CAAC;IACZ,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;KAI7B,CAAC;CACN;AAED,MAAM,WAAW,KAAM,SAAQ,oCAAoC,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,kBAAkB,CAAC,CAAC;CAAI"}
+{"version":3,"file":"ESCar.d.ts","sourceRoot":"","sources":["../../../../src/ESObjects/general/ESCar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,oCAAoC,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAG/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,KAAM,SAAQ,oBAAoB;IAC3C;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAoI;IAExJ;;OAEG;IACH,IAAI,QAAQ,WAAsB;IAElC;;OAEG;IACH,IAAa,YAAY;QAqErB,wBAAwB;;QAExB,aAAa;;;;;;;;;;;;;;;;;;MAvEiD;IAElE;;;;;OAKG;IACH,OAAgB,QAAQ;kBAEe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE;;;;;;;MAErE;IAED;;;OAGG;gBACS,EAAE,CAAC,EAAE,cAAc;IAI/B;;;;;OAKG;IACM,eAAe;;;;;;;;;IAWxB;;;;;;OAMG;IACM,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM;CAQ3C;AAED;;GAEG;AACH,yBAAiB,KAAK,CAAC;IACnB;;;;;;OAMG;IACI,MAAM,kBAAkB;QAE3B,wBAAwB;;QAExB,aAAa;;;;;;;;;;;;;;;;;;KAEf,CAAC;CACN;AAOD;;;GAGG;AACH,MAAM,WAAW,KAAM,SAAQ,oCAAoC,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,kBAAkB,CAAC,CAAC;CAAI"}