@thingjs/xplugin-core

/** * THINGJSX二开API命名空间 */ declare namespace THINGX { /** * 事件 */ namespace Event { /** * @property target - 监听对象 * @property event - 监听事件 * @property [condition] - 物体类型选择条件 * @property [suffix] - 可变事件后缀 * @property callback - 监听回调函数 * @property [priority] - 监听优先级 * @property [tag] - 监听标签 */ type ListenConfig = { target: THING.BaseObject; event: THINGX.Event.Type; condition?: string; suffix?: string; callback: (...params: any[]) => any; priority?: number; tag?: string; }; /** * @property target - 监听对象 * @property event - 监听事件 * @property [condition] - 物体类型选择条件 * @property [suffix] - 可变事件后缀 * @property data - 事件信息，传递回调参数 * @property [compatibility = true] - 是否兼容遗产事件触发 * @property [tag] - 监听标签 */ type TriggerConfig = { target: THING.BaseObject; event: THINGX.Event.Type; condition?: string; suffix?: string; data: any; compatibility?: boolean; tag?: string; }; /** * @property target - 监听对象 * @property event - 监听事件 * @property [condition] - 物体类型选择条件 * @property [suffix] - 可变事件后缀 * @property [compatibility = true] - 是否兼容遗产事件触发 * @property [tag] - 监听标签 */ type ResumeConfig = { target: THING.BaseObject; event: THINGX.Event.Type; condition?: string; suffix?: string; compatibility?: boolean; tag?: string; }; /** * @property target - 监听对象 * @property event - 监听事件 * @property [condition] - 物体类型选择条件 * @property [suffix] - 可变事件后缀 * @property [compatibility = true] - 是否兼容遗产事件触发 * @property [tag] - 监听标签 */ type PauseConfig = { target: THING.BaseObject; event: THINGX.Event.Type; condition?: string; suffix?: string; compatibility?: boolean; tag?: string; }; /** * @property target - 监听对象 * @property event - 监听事件 * @property [condition] - 物体类型选择条件 * @property [suffix] - 可变事件后缀 * @property [tag] - 监听标签 * @property [compatibility = true] - 是否兼容遗产事件触发 * @property [callback] - 监听回调函数 */ type OffConfig = { target: THING.BaseObject; event: THINGX.Event.Type; condition?: string; suffix?: string; tag?: string; compatibility?: boolean; callback?: (...params: any[]) => any; }; /** * 监听事件 * @param config - 监听事件配置 * @returns boolean 是否监听成功 */ function on(config: THINGX.Event.ListenConfig): any; /** * 监听事件，只触发一次 * @param config - 监听事件配置 * @returns boolean 是否监听成功 */ function one(config: THINGX.Event.ListenConfig): any; /** * 触发事件 * @param config - 监听事件配置 * @returns boolean 是否触发成功 */ function trigger(config: THINGX.Event.TriggerConfig): any; /** * 取消监听事件 * @param config - 监听事件配置 */ function off(config: THINGX.Event.OffConfig): void; /** * 暂停注册事件 * @param config - 监听事件配置 */ function pause(config: THINGX.Event.PauseConfig): void; /** * 恢复注册事件 * @param config - 监听事件配置 */ function resume(config: THINGX.Event.ResumeConfig): void; /** * 新建事件 * @param val - 事件名称 * @param [legacyVal] - 遗产事件名称 * @param [withSuffix = false] - 是否有后缀 */ function create(val: string, legacyVal?: string, withSuffix?: boolean): any; namespace Tag { /** * 显示孪生体面板 */ var ShowDigitalTwinPanel: any; /** * 隐藏孪生体面板 */ var HideDigitalTwinPanel: any; /** * 创建显示孪生体提示 */ var CreateDigitalTwinTip: any; /** * 销毁孪生体提示 */ var DestroyDigitalTwinTip: any; /** * 显示孪生体默认效果 */ var ShowDigitalTwinDefaultEffect: any; /** * 隐藏孪生体默认效果 */ var HideDigitalTwinDefaultEffect: any; /** * 设置选中默认效果 */ var SetSelectDefaultEffect: any; /** * 取消设置选中默认效果 */ var SetUnselectDefaultEffect: any; /** * 停止飞行 */ var StopFly: any; /** * 设置兄弟房间透明 */ var SetBrotherRoomsTransparency: any; /** * 设置兄弟房间不透明 */ var SetBrotherRoomsNotTransparency: any; /** * 设置楼层透明 */ var SetFloorTransparency: any; /** * 设置楼层不透明 */ var SetFloorNotTransparency: any; /** * 设置兄弟孪生体透明 */ var SetBrotherTwinsTransparency: any; /** * 设置兄弟孪生体不透明 */ var SetBrotherTwinsNotTransparency: any; /** * 显示建筑告警 */ var ShowAlarmForBuilding: any; /** * 为当前层级设置告警参数 */ var SetAlarmParamsForCurrentLevel: any; /** * 创建图层 */ var CreateLayer: any; /** * 更新监控效果 */ var UpdateMonitorEffect: any; /** * 进入建筑后，只有一层楼则直接进入楼层 */ var EnterFloorDirectAfterEnterBuildingIfOneFloorInBuilding: any; /** * 退出楼层后，只有一层楼则直接进入园区 */ var EnterCampusDirectAfterLeaveFloorIfOneFloorInBuilding: any; /** * 进入楼层后，只有一间房则直接进入房间 */ var EnterRoomDirectAfterEnterFloorIfOneRoomInFloor: any; /** * 退出房间后，只有一层楼则直接进入建筑 */ var EnterBuildingDirectAfterLeaveRoomIfOneRoomInFloor: any; } /** * 事件类型 */ namespace Type { } } /** * 告警模块 */ namespace Alarm { /** * 告警查询配置 * @property [acknowledged] - 处理状态 * @property alarmLevel - 告警级别 * @property [classNames = [1, 2, 3, 4]] - 孪生体业务分类，默认为空数组代表所有 * @property dcIds - 场景的数据库ID数组（DBID） * @property [enableGlobal = false/true] - 开启全局查询，当前层级是地图的话默认true，园区默认false。当为true时，需要设置dcIds * @property fromCiId - 查询的起始层级的数据库ID（DBID） * @property keyword - 搜索关键词，会匹配孪生体的名称，告警详情 * @property orAttrs - 孪生体属性条件筛选默认空数组代表没有过滤条件 * @property [sortType = time-desc] - 告警排序方式默认按时间倒序 time-asc 告警时间正序/time-desc 告警时间倒序/level-asc 告警级别正序/level-desc 告警级别倒序 */ type QueryConfig = { acknowledged?: string; alarmLevel: number[]; classNames?: string[]; dcIds: string[]; enableGlobal?: boolean; fromCiId: string; keyword: string; orAttrs: object[]; sortType?: string; }; /** * 告警等级配置 * @property color - 告警颜色，十六进制 * @property name - 告警级别名称 * @property sound - 告警声音配置 * @property sound.name - 告警声音名称 * @property sound.url - 告警声音资源url */ type LevelItemConfig = { color: string; name: string; sound: { name: string; url: string; }; }; /** * 激活告警系统 * @param purpose - 激活目的 */ function activate(purpose: string): void; /** * 取消激活告警系统 * @param purpose - 取消激活目的 */ function deactivate(purpose: string): void; /** * 告警系统是否激活 */ function isActivated(): boolean; /** * 获取已存在的激活告警系统的目的 * @returns <ul> * <li>激活告警系统的目的</li> * </ul> */ function getPurpose(): string[]; /** * 激活3D告警效果 */ function activateEffect(): void; /** * 取消激活3D告警效果 */ function deactivateEffect(): void; /** * 3D告警效果是否被激活 */ function isEffectActivated(): boolean; /** * 激活告警声音效果 */ function activateSound(): void; /** * 取消激活告警声音效果 */ function deactivateSound(): void; /** * 告警声音效果是否被激活 */ function isSoundActivated(): boolean; /** * 告警系统是否初始化完成 */ function isInitialized(): boolean; /** * 获取告警级别配置 * @returns <ul> * <li>告警级别配置</li> * </ul> */ function getLevelConfig(): Map<number, THINGX.Alarm.LevelItemConfig>; /** * 获取告警查询配置 */ function getQueryConfig(): AlarmQueryConfig; /** * 设置告警查询配置 * @example * // 设置查询告警级别为 1,2,3 级的告警 * THINGX.Alarm.setQueryConfig({ * alarmLevel: [1,2,3] * }); * // 设置查询孪生体业务分类为 '温湿度感应器' 的告警数据 * THINGX.Alarm.setQueryConfig({ * classNames: ['温湿度感应器'] * }); * // 根据孪生体属性筛选告警 * THINGX.Alarm.setQueryConfig({ * orAttrs:[{ "key": '业务分类', "value":"空调", "optType": 1 }] * }); * @param config - 告警查询配置 * @param [isRemoteData = true] - 是否立即请求告警 */ function setQueryConfig(config: THINGX.Alarm.QueryConfig, isRemoteData?: boolean): void; /** * 获取所有告警数据 */ function getAllData(): any; /** * 获取全局告警数据最高告警级别数值约小级别越高, 默认1为最高级，对应“严重”告警级别，依次向下排 */ function getHighestLevel(): number | null; /** * 获取孪生体上最高告警级别数据 * @param digitalTwin - 孪生体对象 * @param isTraverse - 是否遍历该孪生体的孩子 */ function getHighestLevelDataWithTwin(digitalTwin: THING.BaseObject, isTraverse: boolean): any | null; /** * 开始请求后台接口更新所有告警信息，activate后会自动调用，尽量使用activate来控制告警系统 */ function startRequestData(): void; /** * 告警查询配置 * @property [acknowledged] - 处理状态 * @property alarmLevel - 告警级别 * @property [classNames = [1, 2, 3, 4]] - 孪生体业务分类，默认为空数组代表所有 * @property dcIds - 场景的数据库ID数组（DBID） * @property [enableGlobal = false/true] - 开启全局查询，当前层级是地图的话默认true，园区默认false。当为true时，需要设置dcIds * @property fromCiId - 查询的起始层级的数据库ID（DBID） * @property keyword - 搜索关键词，会匹配孪生体的名称，告警详情 * @property orAttrs - 孪生体属性条件筛选默认空数组代表没有过滤条件 * @property [sortType = time-desc] - 告警排序方式默认按时间倒序 time-asc 告警时间正序/time-desc 告警时间倒序/level-asc 告警级别正序/level-desc 告警级别倒序 */ type QueryConfig = { acknowledged?: string; alarmLevel: number[]; classNames?: string[]; dcIds: string[]; enableGlobal?: boolean; fromCiId: string; keyword: string; orAttrs: object[]; sortType?: string; }; /** * 告警等级配置 * @property color - 告警颜色，十六进制 * @property name - 告警级别名称 * @property sound - 告警声音配置 * @property sound.name - 告警声音名称 * @property sound.url - 告警声音资源url */ type LevelItemConfig = { color: string; name: string; sound: { name: string; url: string; }; }; /** * 激活告警系统 * @param purpose - 激活目的 */ function activate(purpose: string): void; /** * 取消激活告警系统 * @param purpose - 取消激活目的 */ function deactivate(purpose: string): void; /** * 告警系统是否激活 */ function isActivated(): boolean; /** * 获取已存在的激活告警系统的目的 * @returns <ul> * <li>激活告警系统的目的</li> * </ul> */ function getPurpose(): string[]; /** * 激活3D告警效果 */ function activateEffect(): void; /** * 取消激活3D告警效果 */ function deactivateEffect(): void; /** * 3D告警效果是否被激活 */ function isEffectActivated(): boolean; /** * 激活告警声音效果 */ function activateSound(): void; /** * 取消激活告警声音效果 */ function deactivateSound(): void; /** * 告警声音效果是否被激活 */ function isSoundActivated(): boolean; /** * 告警系统是否初始化完成 */ function isInitialized(): boolean; /** * 获取告警级别配置 * @returns <ul> * <li>告警级别配置</li> * </ul> */ function getLevelConfig(): Map<number, THINGX.Alarm.LevelItemConfig>; /** * 获取告警查询配置 */ function getQueryConfig(): AlarmQueryConfig; /** * 设置告警查询配置 * @example * // 设置查询告警级别为 1,2,3 级的告警 * THINGX.Alarm.setQueryConfig({ * alarmLevel: [1,2,3] * }); * // 设置查询孪生体业务分类为 '温湿度感应器' 的告警数据 * THINGX.Alarm.setQueryConfig({ * classNames: ['温湿度感应器'] * }); * // 根据孪生体属性筛选告警 * THINGX.Alarm.setQueryConfig({ * orAttrs:[{ "key": '业务分类', "value":"空调", "optType": 1 }] * }); * @param config - 告警查询配置 * @param [isRemoteData = true] - 是否立即请求告警 */ function setQueryConfig(config: THINGX.Alarm.QueryConfig, isRemoteData?: boolean): void; /** * 获取所有告警数据 */ function getAllData(): any; /** * 获取全局告警数据最高告警级别数值约小级别越高, 默认1为最高级，对应“严重”告警级别，依次向下排 */ function getHighestLevel(): number | null; /** * 获取孪生体上最高告警级别数据 * @param digitalTwin - 孪生体对象 * @param isTraverse - 是否遍历该孪生体的孩子 */ function getHighestLevelDataWithTwin(digitalTwin: THING.BaseObject, isTraverse: boolean): any | null; /** * 开始请求后台接口更新所有告警信息，activate后会自动调用，尽量使用activate来控制告警系统 */ function startRequestData(): void; } /** * App模块 */ namespace App { /** * 当前app */ var App.current: THING.App | undefined; /** * 当前层级孪生体对象 */ var App.currentLevel: THING.BaseObject | undefined; /** * 当前app */ var App.current: THING.App | undefined; /** * 当前选择的第一个孪生体对象 */ var App.currentSelected: THING.BaseObject | undefined; /** * 当前场景信息 */ var App.sceneInfo: any; /** * 当前场景CICode */ var App.sceneCICode: string; /** * 通过ThingJS语法查询当前app下孪生体集合 * @param expression - ThingJS语法表达式 * @returns <ul> * <li>查询到的孪生体</li> * </ul> */ function App.queryWithThingJSExpression(expression: string): THING.BaseObject[]; /** * 当前ThingJS-X版本号 */ var App.version: string; /** * 当前使用的标记库版本号 */ var App.vendorMarkerVersion: string; /** * 当前使用的ThingJS的版本号 */ var App.vendorThingJSVersion: string; /** * 当前使用的地图的版本号 */ var App.vendorGeoVersion: string; /** * 当前app */ var App.current: THING.App | undefined; /** * 当前层级孪生体对象 */ var App.currentLevel: THING.BaseObject | undefined; /** * 当前app */ var App.current: THING.App | undefined; /** * 当前选择的第一个孪生体对象 */ var App.currentSelected: THING.BaseObject | undefined; /** * 当前场景信息 */ var App.sceneInfo: any; /** * 当前场景CICode */ var App.sceneCICode: string; /** * 通过ThingJS语法查询当前app下孪生体集合 * @param expression - ThingJS语法表达式 * @returns <ul> * <li>查询到的孪生体</li> * </ul> */ function App.queryWithThingJSExpression(expression: string): THING.BaseObject[]; /** * 当前ThingJS-X版本号 */ var App.version: string; /** * 当前使用的标记库版本号 */ var App.vendorMarkerVersion: string; /** * 当前使用的ThingJS的版本号 */ var App.vendorThingJSVersion: string; /** * 当前使用的地图的版本号 */ var App.vendorGeoVersion: string; } /** * 业务模块 */ namespace Business { /** * 显示业务模块 */ function show(): void; /** * 隐藏业务模块 */ function hide(): void; /** * 获取指定层级下指定名称业务 * @param [level = THINGX.App.currentLevel] - 指定层级 * @param [name=] - 业务名称，为空则获取指定层级下所有业务 * @returns <ul> * <li>业务实例</li> * </ul> */ function get(level?: THING.BaseObject | THINGX.CONST.DEFAULT_DIGITAL_TWIN_CLASS, name=?: string): object[]; /** * 激活业务 * @param name - 业务名称 */ function activate(name: string): void; /** * 取消激活当前业务 */ function deactivate(): void; /** * 获取当前激活的业务信息 */ function getActivated(): any; /** * 重新读取可视化配置并根据当前层级重新创建业务 * @returns <ul> * <li>是否刷新成功</li> * </ul> */ function refresh(): Promise<boolean>; /** * 显示业务面板- 建议通过activate激活业务 * @param name - 业务名称 */ function showPanel(name: string): void; /** * 隐藏业务面板 - 建议通过deactivate取消激活业务 * @param name - 业务名称 */ function hidePanel(name: string): void; /** * 获取业务配置 * @param [level = THINGX.App.currentLevel] - 孪生体对象/孪生体分类 * @param [name=] - 业务名称，非空的话返回指定配置，否则返回所有配置 */ function getConfig(level?: THING.BaseObject | THINGX.CONST.DEFAULT_DIGITAL_TWIN_CLASS, name=?: string): any | null; /** * 获取当前业务面板配置 */ function getPanelConfig(): any | null; /** * 获取当前激活的业务名称 * @param [isFullName = false] - 是否获取业务全称 * @returns <ul> * <li>当前激活的业务名称/全称</li> * </ul> */ function getCurrentName(isFullName?: boolean): string; /** * 显示业务模块 */ function show(): void; /** * 隐藏业务模块 */ function hide(): void; /** * 获取指定层级下指定名称业务 * @param [level = THINGX.App.currentLevel] - 指定层级 * @param [name=] - 业务名称，为空则获取指定层级下所有业务 * @returns <ul> * <li>业务实例</li> * </ul> */ function get(level?: THING.BaseObject | THINGX.CONST.DEFAULT_DIGITAL_TWIN_CLASS, name=?: string): object[]; /** * 激活业务 * @param name - 业务名称 */ function activate(name: string): void; /** * 取消激活当前业务 */ function deactivate(): void; /** * 获取当前激活的业务信息 */ function getActivated(): any; /** * 重新读取可视化配置并根据当前层级重新创建业务 * @returns <ul> * <li>是否刷新成功</li> * </ul> */ function refresh(): Promise<boolean>; /** * 显示业务面板- 建议通过activate激活业务 * @param name - 业务名称 */ function showPanel(name: string): void; /** * 隐藏业务面板 - 建议通过deactivate取消激活业务 * @param name - 业务名称 */ function hidePanel(name: string): void; /** * 获取业务配置 * @param [level = THINGX.App.currentLevel] - 孪生体对象/孪生体分类 * @param [name=] - 业务名称，非空的话返回指定配置，否则返回所有配置 */ function getConfig(level?: THING.BaseObject | THINGX.CONST.DEFAULT_DIGITAL_TWIN_CLASS, name=?: string): any | null; /** * 获取当前业务面板配置 */ function getPanelConfig(): any | null; /** * 获取当前激活的业务名称 * @param [isFullName = false] - 是否获取业务全称 * @returns <ul> * <li>当前激活的业务名称/全称</li> * </ul> */ function getCurrentName(isFullName?: boolean): string; } /** * 摄像机模块 */ namespace Camera { /** * @property position - 摄相机位置 * @property target - 摄像机看点 */ type Pose = { position: number[]; target: number[]; }; /** * 飞到最佳视角查看孪生体 * @example * // 单个孪生体飞行 * const currentLevel = THINGX.App.currentLevel; * cosnt pose = THINGX.Camera.getPoseWithDigitalTwin(currentLevel, { * x: 30, y: 60, z: 1, tx: 0, ty: 0, tr: 0 * }); * THINGX.Camera.flyTo(currentLevel, { * complete: (ev) => { * console.log('飞行完毕') * }, * pose: pose, * time: 2000, * }); * * // 孪生体集合飞行 * let dir = THING.Math.scaleVector(THING.App.current.camera.direction, -1); // 默认方向向量 * dir[0] += 1; * const pose = THINGX.Camera.getPoseWithDigitalTwinSet(THINGX.CONST.DEFAULT_DIGITAL_TWIN_CLASS.BUILDING, { * useDir: dir, * radiusScale: 1.5, * }); * THINGX.Camera.flyTo(THINGX.CONST.DEFAULT_DIGITAL_TWIN_CLASS.BUILDING, { * complete: (ev) => { * console.log('飞行完毕') * }, * pose: pose, * time: 2000, * }); * @param digitalTwin - 孪生体/孪生体集合/ThingJS查询表达式 * @param [config = {}] - 飞行指定配置 * @param [config.keepLevel = false] - 是否保持当前层级 * @param [config.complete] - 摄像机飞行完成回调函数 * @param [config.time] - 摄像机飞行时间，不传的话会根据摄像机姿势和孪生体对象计算一个最佳的飞行时间 * @param [config.pose] - 摄像机姿势，不传的话会计算最佳的摄像机姿势 */ function flyTo(digitalTwin: THING.BaseObject | THING.BaseObject[] | string, config?: { keepLevel?: boolean; complete?: (...params: any[]) => any; time?: number; pose?: THINGX.Camera.Pose; }): void; /** * 通过孪生体获取摄像机姿势 * @example * const currentLevel = THINGX.App.currentLevel; * THINGX.Camera.getPoseWithDigitalTwin(currentLevel, { * x: 30, y: 60, z: 1, tx: 0, ty: 0, tr: 0 * }); * @param digitalTwin - 孪生体 * @param [config = {}] - 飞到对象的参数，当digitalTwin为单个孪生体且opts.keepDir不为true时生效 * @param [config.x = 30] - position yaw 摄像机位置沿x轴旋转角度 * @param [config.y = 45] - position pitch 摄像机位置沿y轴旋转角度 * @param [config.z = 2] - position radius factor 摄像机位置距离孪生体包围盒半径倍数，1是刚好看到飞到物体的整个包围盒 * @param [config.tx = 0] - target yaw 摄像机看点沿x轴旋转角度 * @param [config.ty = 0] - target pitch 摄像机看点沿y轴旋转角度 * @param [config.tr = 0] - target radius factor 摄像机看点距离孪生体包围中心距离 * @param opts - 计算设置 * @param [opts.isRecursive = false] - 是否遍历子对象 * @param [opts.isForceReCalc = true] - 是否强制重新计算 */ function getPoseWithDigitalTwin(digitalTwin: THING.BaseObject, config?: { x?: number; y?: number; z?: number; tx?: number; ty?: number; tr?: number; }, opts: { isRecursive?: boolean; isForceReCalc?: boolean; }): THINGX.Camera.Pose | null; /** * 通过孪生体集合获取摄像机姿势 * @example * let dir = THING.Math.scaleVector(THING.App.current.camera.direction, -1); // 默认方向向量 * dir[0] += 1; * let pose = THINGX.Camera.getPoseWithDigitalTwinSet(THINGX.CONST.DEFAULT_DIGITAL_TWIN_CLASS.BUILDING, { * useDir: dir, * radiusScale: 1.5, * }); * @param digitalTwin - 孪生体集合/ThingJS查询表达式 * @param [opts.isRecursive = false] - 是否遍历子对象 * @param [opts.radiusScale = 1] - 距离包围盒半径倍数，digitalTwin为孪生体集合时生效 * @param [opts.useDir = THING.App.current.camera.direction*-1] - 摄像机朝向，digitalTwin为孪生体集合时生效 */ function getPoseWithDigitalTwinSet(digitalTwin: THING.BaseObject[] | string, opts: { isRecursive?: boolean; radiusScale?: number; useDir?: number[]; }): THINGX.Camera.Pose | null; /** * 获取摄像机姿势建议使用getPoseWithDigitalTwin和getPoseWithDigitalTwinSet获取摄像机姿势 * @param digitalTwin - 孪生体/孪生体集合/ThingJS查询表达式 * @param [flyToConfig = {}] - 飞到对象的参数，当digitalTwin为单个孪生体且opts.keepDir不为true时生效 * @param [flyToConfig.x = 30] - position yaw 摄像机位置沿x轴旋转角度 * @param [flyToConfig.y = 45] - position pitch 摄像机位置沿y轴旋转角度 * @param [flyToConfig.z = 2] - position radius factor 摄像机位置距离孪生体包围盒半径倍数，1是刚好看到飞到物体的整个包围盒 * @param [flyToConfig.tx = 0] - target yaw 摄像机看点沿x轴旋转角度 * @param [flyToConfig.ty = 0] - target pitch 摄像机看点沿y轴旋转角度 * @param [flyToConfig.tr = 0] - target radius factor 摄像机看点距离孪生体包围盒半径倍数 * @param [opts = {}] - 飞到最佳视角计算配置 * @param [opts.isForceReCalc = false] - 是否强制重新计算，当digitalTwin为单个孪生体生效 * @param [opts.isRecursive = false] - 是否遍历子对象 * @param [opts.radiusScale = 1] - 距离包围盒半径倍数，digitalTwin为孪生体集合时生效 * @param [opts.keepDir = false] - 保持当前朝向 * @param [opts.useDir = THING.App.current.camera.direction*-1] - 朝向vector3，digitalTwin为孪生体集合时生效 */ function getPose(digitalTwin: THING.BaseObject | THING.BaseObject[] | string, flyToConfig?: { x?: number; y?: number; z?: number; tx?: number; ty?: number; tr?: number; }, opts?: { isForceReCalc?: boolean; isRecursive?: boolean; radiusScale?: number; keepDir?: boolean; useDir?: number[]; }): THINGX.Camera.Pose | null; /** * 获取视点配置 */ function getConfig(): any; /** * @property position - 摄相机位置 * @property target - 摄像机看点 */ type Pose = { position: number[]; target: number[]; }; /** * 飞到最佳视角查看孪生体 * @example * // 单个孪生体飞行 * const currentLevel = THINGX.App.currentLevel; * cosnt pose = THINGX.Camera.getPoseWithDigitalTwin(currentLevel, { * x: 30, y: 60, z: 1, tx: 0, ty: 0, tr: 0 * }); * THINGX.Camera.flyTo(currentLevel, { * complete: (ev) => { * console.log('飞行完毕') * }, * pose: pose, * time: 2000, * }); * * // 孪生体集合飞行 * let dir = THING.Math.scaleVector(THING.App.current.camera.direction, -1); // 默认方向向量 * dir[0] += 1; * const pose = THINGX.Camera.getPoseWithDigitalTwinSet(THINGX.CONST.DEFAULT_DIGITAL_TWIN_CLASS.BUILDING, { * useDir: dir, * radiusScale: 1.5, * }); * THINGX.Camera.flyTo(THINGX.CONST.DEFAULT_DIGITAL_TWIN_CLASS.BUILDING, { * complete: (ev) => { * console.log('飞行完毕') * }, * pose: pose, * time: 2000, * }); * @param digitalTwin - 孪生体/孪生体集合/ThingJS查询表达式 * @param [config = {}] - 飞行指定配置 * @param [config.keepLevel = false] - 是否保持当前层级 * @param [config.complete] - 摄像机飞行完成回调函数 * @param [config.time] - 摄像机飞行时间，不传的话会根据摄像机姿势和孪生体对象计算一个最佳的飞行时间 * @param [config.pose] - 摄像机姿势，不传的话会计算最佳的摄像机姿势 */ function flyTo(digitalTwin: THING.BaseObject | THING.BaseObject[] | string, config?: { keepLevel?: boolean; complete?: (...params: any[]) => any; time?: number; pose?: THINGX.Camera.Pose; }): void; /** * 通过孪生体获取摄像机姿势 * @example * const currentLevel = THINGX.App.currentLevel; * THINGX.Camera.getPoseWithDigitalTwin(currentLevel, { * x: 30, y: 60, z: 1, tx: 0, ty: 0, tr: 0 * }); * @param digitalTwin - 孪生体 * @param [config = {}] - 飞到对象的参数，当digitalTwin为单个孪生体且opts.keepDir不为true时生效 * @param [config.x = 30] - position yaw 摄像机位置沿x轴旋转角度 * @param [config.y = 45] - position pitch 摄像机位置沿y轴旋转角度 * @param [config.z = 2] - position radius factor 摄像机位置距离孪生体包围盒半径倍数，1是刚好看到飞到物体的整个包围盒 * @param [config.tx = 0] - target yaw 摄像机看点沿x轴旋转角度 * @param [config.ty = 0] - target pitch 摄像机看点沿y轴旋转角度 * @param [config.tr = 0] - target radius factor 摄像机看点距离孪生体包围中心距离 * @param opts - 计算设置 * @param [opts.isRecursive = false] - 是否遍历子对象 * @param [opts.isForceReCalc = true] - 是否强制重新计算 */ function getPoseWithDigitalTwin(digitalTwin: THING.BaseObject, config?: { x?: number; y?: number; z?: number; tx?: number; ty?: number; tr?: number; }, opts: { isRecursive?: boolean; isForceReCalc?: boolean; }): THINGX.Camera.Pose | null; /** * 通过孪生体集合获取摄像机姿势 * @example * let dir = THING.Math.scaleVector(THING.App.current.camera.direction, -1); // 默认方向向量 * dir[0] += 1; * let pose = THINGX.Camera.getPoseWithDigitalTwinSet(THINGX.CONST.DEFAULT_DIGITAL_TWIN_CLASS.BUILDING, { * useDir: dir, * radiusScale: 1.5, * }); * @param digitalTwin - 孪生体集合/ThingJS查询表达式 * @param [opts.isRecursive = false] - 是否遍历子对象 * @param [opts.radiusScale = 1] - 距离包围盒半径倍数，digitalTwin为孪生体集合时生效 * @param [opts.useDir = THING.App.current.camera.direction*-1] - 摄像机朝向，digitalTwin为孪生体集合时生效 */ function getPoseWithDigitalTwinSet(digitalTwin: THING.BaseObject[] | string, opts: { isRecursive?: boolean; radiusScale?: number; useDir?: number[]; }): THINGX.Camera.Pose | null; /** * 获取摄像机姿势建议使用getPoseWithDigitalTwin和getPoseWithDigitalTwinSet获取摄像机姿势 * @param digitalTwin - 孪生体/孪生体集合/ThingJS查询表达式 * @param [flyToConfig = {}] - 飞到对象的参数，当digitalTwin为单个孪生体且opts.keepDir不为true时生效 * @param [flyToConfig.x = 30] - position yaw 摄像机位置沿x轴旋转角度 * @param [flyToConfig.y = 45] - position pitch 摄像机位置沿y轴旋转角度 * @param [flyToConfig.z = 2] - position radius factor 摄像机位置距离孪生体包围盒半径倍数，1是刚好看到飞到物体的整个包围盒 * @param [flyToConfig.tx = 0] - target yaw 摄像机看点沿x轴旋转角度 * @param [flyToConfig.ty = 0] - target pitch 摄像机看点沿y轴旋转角度 * @param [flyToConfig.tr = 0] - target radius factor 摄像机看点距离孪生体包围盒半径倍数 * @param [opts = {}] - 飞到最佳视角计算配置 * @param [opts.isForceReCalc = false] - 是否强制重新计算，当digitalTwin为单个孪生体生效 * @param [opts.isRecursive = false] - 是否遍历子对象 * @param [opts.radiusScale = 1] - 距离包围盒半径倍数，digitalTwin为孪生体集合时生效 * @param [opts.keepDir = false] - 保持当前朝向 * @param [opts.useDir = THING.App.current.camera.direction*-1] - 朝向vector3，digitalTwin为孪生体集合时生效 */ function getPose(digitalTwin: THING.BaseObject | THING.BaseObject[] | string, flyToConfig?: { x?: number; y?: number; z?: number; tx?: number; ty?: number; tr?: number; }, opts?: { isForceReCalc?: boolean; isRecursive?: boolean; radiusScale?: number; keepDir?: boolean; useDir?: number[]; }): THINGX.Camera.Pose | null; /** * 获取视点配置 */ function getConfig(): any; } namespace CONST { /** * 默认孪生体分类 */ enum DEFAULT_DIGITAL_TWIN_CLASS { /** * 园区 */ CAMPUS = ".Campus", /** * 建筑 */ BUILDING = ".Building", /** * 楼层 */ FLOOR = ".Floor", /** * 房间 */ ROOM = ".Room", /** * 地图 */ GEO_CAMPUS = ".GeoCampus" } /** * 插件类型 */ enum PLUGIN_TYPE { /** * 操作原子插件 */ ACTION = "action", /** * 图表 */ CHART = "chart", /** * 核心插件 */ CORE = "core", /** * 扩展插件 */ EXPAND = "expand", /** * 效果模版 */ THEME = "theme" } /** * 加载javascript脚本类型 */ enum JS_LOAD_TYPE { /** * 通过script标签加载 */ TAG = "tag", /** * 以动态执行加载的脚本内容方式加载 */ EXEC = "exec" } /** * javascript资源类型 */ enum JS_SRC_TYPE { /** * url路径方式 */ URL = "url", /** * 源脚本方式 */ CONTENT = "content" } /** * 默认孪生体分类 */ enum DEFAULT_DIGITAL_TWIN_CLASS { /** * 园区 */ CAMPUS = ".Campus", /** * 建筑 */ BUILDING = ".Building", /** * 楼层 */ FLOOR = ".Floor", /** * 房间 */ ROOM = ".Room", /** * 地图 */ GEO_CAMPUS = ".GeoCampus" } /** * 插件类型 */ enum PLUGIN_TYPE { /** * 操作原子插件 */ ACTION = "action", /** * 图表 */ CHART = "chart", /** * 核心插件 */ CORE = "core", /** * 扩展插件 */ EXPAND = "expand", /** * 效果模版 */ THEME = "theme" } /** * 加载javascript脚本类型 */ enum JS_LOAD_TYPE { /** * 通过script标签加载 */ TAG = "tag", /** * 以动态执行加载的脚本内容方式加载 */ EXEC = "exec" } /** * javascript资源类型 */ enum JS_SRC_TYPE { /** * url路径方式 */ URL = "url", /** * 源脚本方式 */ CONTENT = "content" } } /** * 数据辅助模块 */ namespace DataHelper { /** * 数组模块 */ namespace Array { /** * 在数组末尾追加元素 * @param array - 目标数组 * @param val - 待增加的元素 * @param [isForce = false] - 是否强制增加，强制则不判断数组中是否已经存在 * @returns <ul> * <li>增加元素或已存在元素的索引</li> * </ul> */ function push(array: any[], val: any, isForce?: boolean): number; /** * 根据索引数组删除数组元素 * @param array - 数组 * @param indexArray - 序列数组 */ function removeWithIndexArray(array: any[], indexArray: number[]): any[]; /** * 在数组中去除重复项，稳定的（保留第一个） * @param array - 原始数组 * @returns <ul> * <li>删除了重复项的数组</li> * </ul> */ function unique(array: any[]): any[]; /** * 根据keys值，构造新数组只包含keys中包含的key * @param array - 源数组 * @param keys - 要取的键值数组 * @param [isAllowNull = false] - 是否允许值为空，默认不允许 * @returns [{key1:XX,key2:XX},{key1:XX,key2:XX}] */ function getWithKeys(array: any[], keys: string[], isAllowNull?: boolean): any[]; /** * 删除数组中array1中存在与数值array2中相同的元素 * @param array1 - 原始数组 * @param array2 - 校样数组 * @returns 返回新数组 */ function subtract(array1: any[], array2: any[]): any[]; /** * 在数组末尾追加元素 * @param array - 目标数组 * @param val - 待增加的元素 * @param [isForce = false] - 是否强制增加，强制则不判断数组中是否已经存在 * @returns <ul> * <li>增加元素或已存在元素的索引</li> * </ul> */ function push(array: any[], val: any, isForce?: boolean): number; /** * 根据索引数组删除数组元素 * @param array - 数组 * @param indexArray - 序列数组 */ function removeWithIndexArray(array: any[], indexArray: number[]): any[]; /** * 在数组中去除重复项，稳定的（保留第一个） * @param array - 原始数组 * @returns <ul> * <li>删除了重复项的数组</li> * </ul> */ function unique(array: any[]): any[]; /** * 根据keys值，构造新数组只包含keys中包含的key * @param array - 源数组 * @param keys - 要取的键值数组 * @param [isAllowNull = false] - 是否允许值为空，默认不允许 * @returns [{key1:XX,key2:XX},{key1:XX,key2:XX}] */ function getWithKeys(array: any[], keys: string[], isAllowNull?: boolean): any[]; /** * 删除数组中array1中存在与数值array2中相同的元素 * @param array1 - 原始数组 * @param array2 - 校样数组 * @returns 返回新数组 */ function subtract(array1: any[], array2: any[]): any[]; } /** * 对象模块 */ namespace Object { /** * 合并两个对象 * @param srcObj - 源对象 * @param destObj - 目标对象 * @param [isDeep = true] - 是否深拷贝 * @param [isNew = false] - 是否返回新对象，否则影响源对象 * @returns <ul> * <li>合并后的对象</li> * </ul> */ function merge(srcObj: any, destObj: any, isDeep?: boolean, isNew?: boolean): any; /** * 拷贝对象 * @example * const myclone = THINGX.Utils.clone(obj); * @param obj - 需要被拷贝的对象 * @param [isDeep = true] - 是否深拷贝 * @param [endCheck = () => {return false;}] - 停止拷贝的条件函数 */ function clone(obj: any, isDeep?: boolean, endCheck?: (...params: any[]) => any): any; /** * 获取对象第一个key * @param obj - 对象 */ function getFirstKey(obj: any): any; /** * 获取对象第一个值 * @param obj - 对象 */ function getFirstValue(obj: any): any; /** * 对象是否为空 * @param obj - 对象 */ function isEmpty(obj: any): boolean; /** * 从obj1中删除obj2中已有的元素 * @param obj1 - 对象1 * @param obj2 - 对象2 * @param [isCheckVal = false] - 是否对比元素值一样 * @returns <ul> * <li>新对象，obj1的子集</li> * </ul> */ function subtract(obj1: any, obj2: any, isCheckVal?: boolean): any; /** * 合并两个对象 * @param srcObj - 源对象 * @param destObj - 目标对象 * @param [isDeep = true] - 是否深拷贝 * @param [isNew = false] - 是否返回新对象，否则影响源对象 * @returns <ul> * <li>合并后的对象</li> * </ul> */ function merge(srcObj: any, destObj: any, isDeep?: boolean, isNew?: boolean): any; /** * 拷贝对象 * @example * const myclone = THINGX.Utils.clone(obj); * @param obj - 需要被拷贝的对象 * @param [isDeep = true] - 是否深拷贝 * @param [endCheck = () => {return false;}] - 停止拷贝的条件函数 */ function clone(obj: any, isDeep?: boolean, endCheck?: (...params: any[]) => any): any; /** * 获取对象第一个key * @param obj - 对象 */ function getFirstKey(obj: any): any; /** * 获取对象第一个值 * @param obj - 对象 */ function getFirstValue(obj: any): any; /** * 对象是否为空 * @param obj - 对象 */ function isEmpty(obj: any): boolean; /** * 从obj1中删除obj2中已有的元素 * @param obj1 - 对象1 * @param obj2 - 对象2 * @param [isCheckVal = false] - 是否对比元素值一样 * @returns <ul> * <li>新对象，obj1的子集</li> * </ul> */ function subtract(obj1: any, obj2: any, isCheckVal?: boolean): any; } /** * 字符串模块 */ namespace String { } /** * 字符串模块 */ namespace Time { /** * 延时某段时间，只执行最后一次 * 类似于requestAnimationFrame * @param fn - 执行函数 */ function delay(fn: any, _a: any): void; /** * 延时某段时间，只执行最后一次 * 类似于requestAnimationFrame * @param fn - 执行函数 */ function delay(fn: any, _a: any): void; } /** * vector3向量模块 */ namespace Vector { /** * 两个向量加 * @param vec1 - 向量1 * @param vec2 - 向量2 */ function add(vec1: number[], vec2: number[]): number[]; /** * 向量与数值相乘 * @param vec - 向量 * @param num - 数值 */ function multiplyNumber(vec: number[], num: number): number[]; /** * 两个向量相减, vec1 - vec2 * @param vec1 - 向量1 * @param vec2 - 向量2 */ function subtract(vec1: number[], vec2: number[]): number[]; /** * 向量标准化 * @param vec - 向量 */ function normalize(vec: number[]): number[]; /** * 获取向量长度 * @param vec - 向量 */ function length(vec: number[]): number; /** * 获取两个向量之间的距离 * @param vec1 - 向量1 * @param vec2 - 向量2 */ function distance(vec1: number[], vec2: number[]): number; /** * 两个向量加 * @param vec1 - 向量1 * @param vec2 - 向量2 */ function add(vec1: number[], vec2: number[]): number[]; /** * 向量与数值相乘 * @param vec - 向量 * @param num - 数值 */ function multiplyNumber(vec: number[], num: number): number[]; /** * 两个向量相减, vec1 - vec2 * @param vec1 - 向量1 * @param vec2 - 向量2 */ function subtract(vec1: number[], vec2: number[]): number[]; /** * 向量标准化 * @param vec - 向量 */ function normalize(vec: number[]): number[]; /** * 获取向量长度 * @param vec - 向量 */ function length(vec: number[]): number; /** * 获取两个向量之间的距离 * @param vec1 - 向量1 * @param vec2 - 向量2 */ function distance(vec1: number[], vec2: number[]): number; } /** * 数组模块 */ namespace Array { /** * 在数组末尾追加元素 * @param array - 目标数组 * @param val - 待增加的元素 * @param [isForce = false] - 是否强制增加，强制则不判断数组中是否已经存在 * @returns <ul> * <li>增加元素或已存在元素的索引</li> * </ul> */ function push(array: any[], val: any, isForce?: boolean): number; /** * 根据索引数组删除数组元素 * @param array - 数组 * @param indexArray - 序列数组 */ function removeWithIndexArray(array: any[], indexArray: number[]): any[]; /** * 在数组中去除重复项，稳定的（保留第一个） * @param array - 原始数组 * @returns <ul> * <li>删除了重复项的数组</li> * </ul> */ function unique(array: any[]): any[]; /** * 根据keys值，构造新数组只包含keys中包含的key * @param array - 源数组 * @param keys - 要取的键值数组 * @param [isAllowNull = false] - 是否允许值为空，默认不允许 * @returns [{key1:XX,key2:XX},{key1:XX,key2:XX}] */ function getWithKeys(array: any[], keys: string[], isAllowNull?: boolean): any[]; /** * 删除数组中array1中存在与数值array2中相同的元素 * @param array1 - 原始数组 * @param array2 - 校样数组 * @returns 返回新数组 */ function subtract(array1: any[], array2: any[]): any[]; /** * 在数组末尾追加元素 * @param array - 目标数组 * @param val - 待增加的元素 * @param [isForce = false] - 是否强制增加，强制则不判断数组中是否已经存在 * @returns <ul> * <li>增加元素或已存在元素的索引</li> * </ul> */ function push(array: any[], val: any, isForce?: boolean): number; /** * 根据索引数组删除数组元素 * @param array - 数组 * @param indexArray - 序列数组 */ function removeWithIndexArray(array: any[], indexArray: number[]): any[]; /** * 在数组中去除重复项，稳定的（保留第一个） * @param array - 原始数组 * @returns <ul> * <li>删除了重