@realsee/dnalogel 2.0.0-alpha.4 → 2.0.0-alpha.40

package/libs/floorplan/TopviewFloorplanPlugin/typing.d.ts

@@ -0,0 +1,86 @@
+import type { FLOOR_PLAN_ATTACHED_TO } from '../constant';
+import type * as BasePlugin from '../../base/BasePluginWithData';
+import type { FloorplanServerData } from '../typings/floorplanServerData';
+import type { FloorplanData, FloorplanRoomItem } from '../typings/floorplanData';
+export interface Config {
+    /** 指北针的显示文案，默认为 '北' */
+    northDesc: string;
+    /** 户型图展示时，模型的透明度，默认为 1 */
+    modelOpacity: number;
+    /** 鼠标放置在分间上时，是否要自动高亮分间，默认为 true */
+    hoverEnable: boolean;
+    /** 是否开启放大缩小和拖动功能，默认为 false */
+    gestureEnable: boolean;
+    /** 是否要启用指北针功能，默认为 true */
+    compassEnable: boolean;
+    /** Five 切换到 Topview Mode 时，是否自动展示户型图，默认为 true */
+    autoShowEnable: boolean;
+    /** 是否要启用户型图分间标尺功能，默认为 true */
+    ruleLabelsEnable: boolean;
+    /** 是否要启用户型图分间标签功能，默认为 true */
+    roomLabelsEnable: boolean;
+    /** 自定义「雷达」图标 */
+    cameraImageUrl: string;
+    /** 点击房间时，是否需要跳转到被点房间的全景态点位上，默认为 true */
+    preventRoomClick?: boolean;
+    /** 计算户型图大小时，以模型的哪个高度为依据，默认为 BOUNDING_CENTER
+     * - FLOOR_PLAN_ATTACHED_TO.FLOOR: 户型图大小与模型的地板进行贴合
+     * - FLOOR_PLAN_ATTACHED_TO.CEILING: 户型图大小与模型的天花板进行贴合
+     * - FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER: 户型图大小与模型的中心进行贴合
+     */
+    attachedTo: FLOOR_PLAN_ATTACHED_TO;
+    /** 分间标签的自定义函数，通过返回自定义 DOM 替换对应分间的标签 */
+    getLabelElement: undefined | ((room: FloorplanRoomItem) => Element | null);
+    /** 是否支持房屋标签自适应展示，默认为 true
+     * @description
+     * * 标签边框超过房间边框时，自动隐藏；不超过时自动展示。
+     * * 鼠标 hover 时，自动展示。
+     * */
+    adaptiveRoomLabelVisibleEnable: boolean;
+}
+export interface State extends BasePlugin.State {
+    visible: boolean;
+    config: Config;
+}
+export interface EventMap extends BasePlugin.EventMap<State, FloorplanData> {
+    /** 展示结束的回调
+     * @param event.userAction 是否是用户操作
+     */
+    showAnimationEnded: (event: {
+        userAction: boolean;
+    }) => void;
+    /** visible 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    show: (event: {
+        userAction: boolean;
+    }) => void;
+    /** visible 从 true 到 false 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    hide: (event: {
+        userAction: boolean;
+    }) => void;
+    /** enabled 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    enable: (event: {
+        userAction: boolean;
+    }) => void;
+    /** enabled 从 true 到 false 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    disable: (event: {
+        userAction: boolean;
+    }) => void;
+}
+/** 插件初始化参数 */
+export interface Parameters extends Partial<Config> {
+    selector?: string | Element;
+    scale?: number;
+}
+export interface PluginServerData extends BasePlugin.ServerData {
+    version: number;
+    data: FloorplanServerData;
+}
+export { FloorplanData as PluginData };

package/libs/floorplan/TopviewFloorplanPlugin/typing.js

@@ -0,0 +1 @@
+export {};

package/libs/floorplan/constant.d.ts

@@ -0,0 +1,5 @@
+export declare enum FLOOR_PLAN_ATTACHED_TO {
+    FLOOR = 1,
+    CEILING = 2,
+    BOUNDING_CENTER = 3
+}

package/libs/floorplan/constant.js

@@ -0,0 +1,6 @@
+export var FLOOR_PLAN_ATTACHED_TO;
+(function (FLOOR_PLAN_ATTACHED_TO) {
+    FLOOR_PLAN_ATTACHED_TO[FLOOR_PLAN_ATTACHED_TO["FLOOR"] = 1] = "FLOOR";
+    FLOOR_PLAN_ATTACHED_TO[FLOOR_PLAN_ATTACHED_TO["CEILING"] = 2] = "CEILING";
+    FLOOR_PLAN_ATTACHED_TO[FLOOR_PLAN_ATTACHED_TO["BOUNDING_CENTER"] = 3] = "BOUNDING_CENTER";
+})(FLOOR_PLAN_ATTACHED_TO || (FLOOR_PLAN_ATTACHED_TO = {}));

package/libs/floorplan/index.d.ts

@@ -0,0 +1,6 @@
+export * from './constant';
+export * from './TopviewFloorplanPlugin';
+export * from './PanoFloorplanRadarPlugin';
+export * from './ModelFloorplanPlugin';
+export * from './typings/floorplanServerData';
+export * from './typings/floorplanData';

package/libs/floorplan/index.js

@@ -0,0 +1,7 @@
+// floorplan
+export * from './constant';
+export * from './TopviewFloorplanPlugin';
+export * from './PanoFloorplanRadarPlugin';
+export * from './ModelFloorplanPlugin';
+export * from './typings/floorplanServerData';
+export * from './typings/floorplanData';

package/libs/floorplan/typings/floorplanServerData.d.ts

@@ -79,6 +79,10 @@ export interface FloorplanServerRoomItem {
      * @description 单位是平方毫米
      */
     size: number;
+    /** 房屋类型
+     * @description 对应关系参考上方 ROOM_DETAILS_TYPE_MAP
+     */
+    type: number;
     name: string;
     /** 围成房间区域的坐标路径
      * @description 坐标类型是户型图坐标

package/libs/floorplan/utils/constant.d.ts

@@ -0,0 +1,22 @@
+export declare const enum FloorplanErrorType {
+    /** 意料之外的错误 */
+    UnknownError = "UnknownError",
+    /** 数据未加载 */
+    DataNotLoaded = "DataNotLoaded",
+    /** 展示过程被隐藏打断 */
+    BreakOffByHide = "BreakOffByHide",
+    /** 展示过程中插件被禁用 */
+    BreakOffByDisable = "BreakOffByDisable",
+    /** 模型未加载完成 */
+    ModelNotLoaded = "ModelNotLoaded",
+    /** Five changeMode 行为不符合预期 */
+    ChangeModeError = "ChangeModeError",
+    /** Five updateCamera 行为不符合预期 */
+    UpdateCameraError = "UpdateCameraError"
+}
+/** 户型图展示 & 模型消失的默认时间 */
+export declare const SHOW_ANIME_DURATION = 500;
+/** Five camera 默认 fov */
+export declare const FIVE_CAMERA_DEFAULT_FOV = 80;
+/** 展示户型图时，默认模型的透明度 */
+export declare const DEFAULT_SHOW_MODEL_OPACITY = 0.01;

package/libs/floorplan/{ModelFloorplanPlugin/utils → utils}/constant.js

@@ -1,12 +1,19 @@
 export var FloorplanErrorType;
 (function (FloorplanErrorType) {
-    FloorplanErrorType["UnknownError"] = "UnknowError";
+    /** 意料之外的错误 */
+    FloorplanErrorType["UnknownError"] = "UnknownError";
+    /** 数据未加载 */
     FloorplanErrorType["DataNotLoaded"] = "DataNotLoaded";
+    /** 展示过程被隐藏打断 */
     FloorplanErrorType["BreakOffByHide"] = "BreakOffByHide";
+    /** 展示过程中插件被禁用 */
+    FloorplanErrorType["BreakOffByDisable"] = "BreakOffByDisable";
+    /** 模型未加载完成 */
     FloorplanErrorType["ModelNotLoaded"] = "ModelNotLoaded";
+    /** Five changeMode 行为不符合预期 */
     FloorplanErrorType["ChangeModeError"] = "ChangeModeError";
+    /** Five updateCamera 行为不符合预期 */
     FloorplanErrorType["UpdateCameraError"] = "UpdateCameraError";
-    FloorplanErrorType["DifferentShowParams"] = "DifferentShowParams";
 })(FloorplanErrorType || (FloorplanErrorType = {}));
 /** 户型图展示 & 模型消失的默认时间 */
 export const SHOW_ANIME_DURATION = 500;

package/libs/floorplan/utils/correctFiveState.d.ts

@@ -0,0 +1,15 @@
+import type { Five, Mode } from '@realsee/five';
+export interface ShowState {
+    latitude: number;
+    longitude: number;
+    fov: number;
+    mode: Mode;
+}
+/** 判断当前状态是否可以展示户型图 */
+export declare function checkShowState(five: Five, showState: ShowState): boolean;
+/** 更改 Five 状态到展示户型图的状态
+ * 1. 判断状态不符合时，会纠正到正确的状态
+ * 2. 内置了相应的动画时间计算
+ * 3. 纠正成功会返回 true，失败「可能会被用户行为中断」会返回 false
+ */
+export default function correctFiveState(five: Five, showState: ShowState, userAction?: boolean): Promise<void>;

package/libs/floorplan/{ModelFloorplanPlugin/utils → utils}/correctFiveState.js

@@ -1,18 +1,21 @@
-import { Five } from '@realsee/five';
-import changeMode from '../../../shared-utils/five/changeMode';
-import { FloorplanErrorType } from './constant';
-import to from '../../../shared-utils/to';
-import nearlyEqual from '../../../shared-utils/nearlyEqual';
+import to from '../../shared-utils/to';
+import { FloorplanErrorType } from '../utils/constant';
+import nearlyEqual from '../../shared-utils/nearlyEqual';
+import changeMode from '../../shared-utils/five/changeMode';
 /** 判断当前状态是否可以展示户型图 */
 export function checkShowState(five, showState) {
-    if (five.currentMode !== Five.Mode.Floorplan)
+    if (five.currentMode !== showState.mode)
         return false;
     const { latitude, longitude, fov } = showState;
     const { latitude: _latitude, longitude: _longitude } = five.getCurrentState();
     const _fov = five.camera.fov;
-    if (nearlyEqual(latitude, _latitude, 1) && nearlyEqual(longitude, _longitude, 1) && fov === _fov)
-        return true;
-    return false;
+    if (!nearlyEqual(latitude, _latitude, 2))
+        return false;
+    if (!nearlyEqual(longitude, _longitude, 2))
+        return false;
+    if (fov !== _fov)
+        return false;
+    return true;
 }
 /** 更改 Five 状态到展示户型图的状态
  * 1. 判断状态不符合时，会纠正到正确的状态
@@ -24,20 +27,17 @@ export default async function correctFiveState(five, showState, userAction = tru
     const result = checkShowState(five, showState);
     if (result === true)
         return;
+    const currentFiveState = five.getCurrentState();
     // 纠正 mode
-    if (five.currentMode !== Five.Mode.Floorplan) {
-        const [changeModeError] = await to(changeMode(five, Five.Mode.Floorplan, showState, undefined, userAction));
+    if (currentFiveState.mode !== showState.mode) {
+        const [changeModeError] = await to(changeMode(five, [showState.mode, showState, undefined, userAction]));
         if (changeModeError)
-            throw changeModeError;
-        // changeMode 是异步行为，可能会被打断，需要在结束后加一次判断
-        const result = checkShowState(five, showState);
-        if (result === false)
             throw new Error(FloorplanErrorType.ChangeModeError);
         return;
     }
     // 纠正相机状态
     // 根据 latitude、longitude、fov 计算动画时间，最多 1s
-    const { latitude, longitude, fov } = five.getCurrentState();
+    const { latitude, longitude, fov } = currentFiveState;
     const time = Math.min(1000, Math.max(200, Math.abs(latitude - Math.PI / 2) * 1000, (longitude > Math.PI ? 2 * Math.PI - longitude : longitude) * 500, Math.abs(fov - showState.fov) * 10));
     const [updateCameraError] = await to(five.updateCamera(showState, time, userAction));
     if (updateCameraError)

package/libs/floorplan/utils/formatPosition.d.ts

@@ -7,7 +7,7 @@ export declare function pathD(points: Vector2Position[], options?: {
     format?: (vector: Vector2Position) => Vector2Position;
 }): string;
 /** 把户型图上点点位转换到 SVG 上的点位 */
-export default function formatFloorplanPoint({ x, y }: Vector2Position, pxmm: number, bounding: FloorplanBounding): {
+export default function formatFloorplanPoint({ x, y }: Vector2Position, bounding: FloorplanBounding): {
     x: number;
     y: number;
 };

package/libs/floorplan/utils/formatPosition.js

@@ -9,7 +9,7 @@ export function pathD(points, options = {}) {
             d += 'M' + point;
             return d;
         }
-        if (needA?.[index]) {
+        if (needA === null || needA === void 0 ? void 0 : needA[index]) {
             d += 'A' + needA[index] + ',' + point;
             return d;
         }
@@ -19,9 +19,9 @@ export function pathD(points, options = {}) {
     return d + (needZ ? 'Z' : '');
 }
 /** 把户型图上点点位转换到 SVG 上的点位 */
-export default function formatFloorplanPoint({ x, y }, pxmm, bounding) {
+export default function formatFloorplanPoint({ x, y }, bounding) {
     const { max, min } = bounding;
-    return { x: (x - min.x) * pxmm, y: (max.y - y) * pxmm };
+    return { x: x - min.x, y: max.y - y };
 }
 /** 模型坐标转户型图坐标 */
 export function modelPosition2FloorplanPosition(position, floorplanData) {

package/libs/index.d.ts

@@ -1,21 +1,17 @@
-export { default as ModelViewPlugin } from './ModelViewPlugin';
-export { default as CSS3DRenderPlugin } from './CSS3DRenderPlugin';
-export type { PanoCursorRaycasterPluginExportType } from './PanoCursorRaycasterPlugin';
-export { default as PanoCursorRaycasterPlugin } from './PanoCursorRaycasterPlugin';
-export type { ModelRoomLabelController, ModelRoomLabelPluginData, RoomLabel, ModelRoomLabelPluginReturnType, ModelRoomLabelPluginParameters, } from './ModelRoomLabelPlugin';
-export { default as ModelRoomLabelPlugin } from './ModelRoomLabelPlugin';
-export type { TopviewFloorplanPluginReturnType, TopviewFloorplanPluginParameterType, } from './floorplan/TopviewFloorplanPlugin';
-export { default as TopviewFloorplanPlugin } from './floorplan/TopviewFloorplanPlugin';
-export type { PanoFloorplanRadarPluginReturnType, PanoFloorplanRadarPluginParameterType, } from './floorplan/PanoFloorplanRadarPlugin';
-export { default as PanoFloorplanRadarPlugin } from './floorplan/PanoFloorplanRadarPlugin';
-export type { ModelFloorplanParameterType, ModelFloorplanPluginReturnType, ModelFloorplanErrorType, ModelFloorplanPluginsConfigs, ModelFloorplanEventHandlers, ModelFloorplanViewEvent, } from './floorplan/ModelFloorplanPlugin';
-export { default as ModelFloorplanPlugin } from './floorplan/ModelFloorplanPlugin';
-export type { ModelChassisCompassPluginParameterType, ModelChassisCompassPluginData, ModelChassisCompassPluginExportType, } from './ModelChassisCompassPlugin';
-export { default as ModelChassisCompassPlugin } from './ModelChassisCompassPlugin';
-export type { ModelEntryDoorGuidePluginParameterType, ModelEntryDoorGuidePluginData, ModelEntryDoorGuidePluginExportType, } from './ModelEntryDoorGuidePlugin';
-export { default as ModelEntryDoorGuidePlugin } from './ModelEntryDoorGuidePlugin';
-export { default as CameraMovementPlugin } from './CameraMovementPlugin';
-export type { PanoRulerPluginParameterType, PanoRulerPluginExportType, PanoRulerPluginOptions, } from './PanoRulerPlugin';
-export { default as PanoRulerPlugin } from './PanoRulerPlugin';
-export type { PanoCompassPluginParameterType, PanoCompassPluginExportType, PanoCompassPluginData, } from './PanoCompassPlugin';
-export { default as PanoCompassPluginPlugin } from './PanoCompassPlugin';
+export * from './ModelViewPlugin';
+export * from './CSS3DRenderPlugin';
+export * from './PanoCursorRaycasterPlugin';
+export * from './ModelRoomLabelPlugin';
+export * from './floorplan';
+export * from './ModelChassisCompassPlugin';
+export * from './ModelEntryDoorGuidePlugin';
+export * from './CameraMovementPlugin';
+export * from './PanoRulerPlugin';
+export * from './PanoRulerProPlugin';
+export * from './PanoCompassPlugin';
+export * from './PanoMeasurePlugin';
+export * from './PanoSpatialTagPlugin';
+export * from './ModelItemLabelPlugin';
+export * from './ModelTVVideoPlugin';
+export * from './ItemLabelPlugin';
+export declare const DnalogelVersion = "2.0.0-alpha.38";

package/libs/index.js

@@ -1,12 +1,29 @@
-export { default as ModelViewPlugin } from './ModelViewPlugin';
-export { default as CSS3DRenderPlugin } from './CSS3DRenderPlugin';
-export { default as PanoCursorRaycasterPlugin } from './PanoCursorRaycasterPlugin';
-export { default as ModelRoomLabelPlugin } from './ModelRoomLabelPlugin';
-export { default as TopviewFloorplanPlugin } from './floorplan/TopviewFloorplanPlugin';
-export { default as PanoFloorplanRadarPlugin } from './floorplan/PanoFloorplanRadarPlugin';
-export { default as ModelFloorplanPlugin } from './floorplan/ModelFloorplanPlugin';
-export { default as ModelChassisCompassPlugin } from './ModelChassisCompassPlugin';
-export { default as ModelEntryDoorGuidePlugin } from './ModelEntryDoorGuidePlugin';
-export { default as CameraMovementPlugin } from './CameraMovementPlugin';
-export { default as PanoRulerPlugin } from './PanoRulerPlugin';
-export { default as PanoCompassPluginPlugin } from './PanoCompassPlugin';
+export * from './ModelViewPlugin';
+export * from './CSS3DRenderPlugin';
+export * from './PanoCursorRaycasterPlugin';
+// 模型房屋标签
+export * from './ModelRoomLabelPlugin';
+// floorplan
+export * from './floorplan';
+// 模型底盘
+export * from './ModelChassisCompassPlugin';
+// 模型入户门
+export * from './ModelEntryDoorGuidePlugin';
+export * from './CameraMovementPlugin';
+// 全景标尺
+export * from './PanoRulerPlugin';
+// 全景标尺Pro版
+export * from './PanoRulerProPlugin';
+// 全景指南针
+export * from './PanoCompassPlugin';
+// pc 全景测量工具
+export * from './PanoMeasurePlugin';
+// 空间三维标签
+export * from './PanoSpatialTagPlugin';
+// 模型物品标签插件
+export * from './ModelItemLabelPlugin';
+// 模型电视插件
+export * from './ModelTVVideoPlugin';
+// 物品标签
+export * from './ItemLabelPlugin';
+export const DnalogelVersion = '2.0.0-alpha.38';

package/libs/shared-utils/Subscribe.js

@@ -1,3 +1,4 @@
+var _a;
 /* eslint-disable  @typescript-eslint/no-explicit-any */
 const __EVENT__ = '__events__';
 /**
@@ -5,8 +6,13 @@ const __EVENT__ = '__events__';
  * 观察者模式（供前端使用），Node端推荐<a href="https://nodejs.org/api/events.html#events_class_eventemitter">EventEmitter</a>。
  */
 export default class Subscribe {
-    [__EVENT__];
     constructor() {
+        Object.defineProperty(this, _a, {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this[__EVENT__] = {};
     }
     /**
@@ -99,3 +105,4 @@ export default class Subscribe {
         return canceled;
     }
 }
+_a = __EVENT__;

package/libs/shared-utils/animationFrame/BetterTween.js

@@ -1,24 +1,53 @@
 import TWEEN from '@tweenjs/tween.js';
 import { requestAnimationFrameInterval } from './index';
 export class BetterTween extends TWEEN.Tween {
-    disposeMethods = [];
-    animationFrameDisposer;
-    onDispose = (callback) => {
-        this.disposeMethods.push(callback);
-        return this;
-    };
-    play = () => {
-        this.start(0);
-        this.animationFrameDisposer = requestAnimationFrameInterval((time) => this.update(time));
-        return this;
-    };
-    dispose = () => {
-        this.stop();
-        this.animationFrameDisposer?.();
-        this.disposeMethods.forEach((fn) => fn());
-        this.disposeMethods = [];
-        TWEEN.remove(this);
-    };
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "disposeMethods", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "animationFrameDisposer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "onDispose", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (callback) => {
+                this.disposeMethods.push(callback);
+                return this;
+            }
+        });
+        Object.defineProperty(this, "play", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                this.start(0);
+                this.animationFrameDisposer = requestAnimationFrameInterval((time) => this.update(time));
+                return this;
+            }
+        });
+        Object.defineProperty(this, "dispose", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: () => {
+                var _a;
+                this.stop();
+                (_a = this.animationFrameDisposer) === null || _a === void 0 ? void 0 : _a.call(this);
+                this.disposeMethods.forEach((fn) => fn());
+                this.disposeMethods = [];
+                TWEEN.remove(this);
+            }
+        });
+    }
 }
 export function tweenProgress(duration, easing = TWEEN.Easing.Linear.None) {
     const tween = new BetterTween({ progress: 0 }).to({ progress: 1 });

package/libs/shared-utils/createCanvasTextTexture.js

@@ -1,10 +1,11 @@
 import { CanvasTexture } from 'three';
 export default function createCanvasTextTexture(text, config) {
-    const size = config?.size ?? 512;
-    const fontSize = config?.fontSize ?? size * (35 / 256) * 1.2;
-    const backgroundColor = config?.backgroundColor ?? 'rgba(0,0,0,0)';
-    const fontColor = config?.fontColor ?? '#fff';
-    const textAlign = config?.textAlign ?? 'center';
+    var _a, _b, _c, _d, _e;
+    const size = (_a = config === null || config === void 0 ? void 0 : config.size) !== null && _a !== void 0 ? _a : 512;
+    const fontSize = (_b = config === null || config === void 0 ? void 0 : config.fontSize) !== null && _b !== void 0 ? _b : size * (35 / 256) * 1.2;
+    const backgroundColor = (_c = config === null || config === void 0 ? void 0 : config.backgroundColor) !== null && _c !== void 0 ? _c : 'rgba(0,0,0,0)';
+    const fontColor = (_d = config === null || config === void 0 ? void 0 : config.fontColor) !== null && _d !== void 0 ? _d : '#fff';
+    const textAlign = (_e = config === null || config === void 0 ? void 0 : config.textAlign) !== null && _e !== void 0 ? _e : 'center';
     const canvas = document.createElement('canvas');
     canvas.setAttribute('width', size + '');
     canvas.setAttribute('height', size + '');

package/libs/shared-utils/five/changeMode.d.ts

@@ -1,2 +1,5 @@
 import type { Five } from '@realsee/five';
-export default function changeMode(five: Five, ...changeModeParams: Parameters<Five['changeMode']>): Promise<void>;
+/** 等待 five changeMode 结束
+ * @description Promise 的状态只代表 mode 与预期是否一致，不保证参数的一致性
+ */
+export default function changeMode(five: Five, changeModeParams: Parameters<Five['changeMode']>): Promise<void>;

package/libs/shared-utils/five/changeMode.js

@@ -1,15 +1,36 @@
-import to from '../to';
-export default async function changeMode(five, ...changeModeParams) {
-    const [changeModeError] = await to(five.changeMode(...changeModeParams));
-    if (changeModeError)
-        throw changeModeError;
-    await new Promise((reslove, reject) => {
-        five.once('initAnimationEnded', reslove);
-        const handleModeChange = (mode) => {
-            if (mode !== changeModeParams[0])
-                reject('changeMode 被中断');
-            five.off('modeChange', handleModeChange);
-        };
-        five.on('modeChange', handleModeChange);
+import nearlyEqual from '../nearlyEqual';
+/** 等待 five changeMode 结束
+ * @description Promise 的状态只代表 mode 与预期是否一致，不保证参数的一致性
+ */
+export default async function changeMode(five, changeModeParams) {
+    await new Promise((resolve, reject) => {
+        // 虽然 changeMode 是异步函数，但不代表异步流程结束代表切换 Mode 动画结束
+        five.changeMode(...changeModeParams).catch((error) => reject(error));
+        five.once('initAnimationEnded', () => {
+            const fiveCurrentState = five.getCurrentState();
+            const correctMode = changeModeParams[0];
+            if (fiveCurrentState.mode !== correctMode)
+                reject(new Error('mode 与预期不符'));
+            /** 检测当前的 current pose 和传入的 pose 是否一致 */
+            const checkPose = () => {
+                const correctPose = changeModeParams[1];
+                if (!correctPose)
+                    return true;
+                return Object.keys(correctPose).every((key) => {
+                    const fivePoseItem = fiveCurrentState[key];
+                    if (fivePoseItem === undefined)
+                        return true;
+                    const correctPoseItem = correctPose[key];
+                    if (typeof fivePoseItem === 'number' && typeof correctPoseItem === 'number') {
+                        return nearlyEqual(fivePoseItem, correctPoseItem, 2);
+                    }
+                    return fivePoseItem === correctPoseItem;
+                });
+            };
+            const checkPoseResult = checkPose();
+            if (!checkPoseResult)
+                reject(new Error('five pose 与预期不符'));
+            resolve();
+        });
     });
 }

package/libs/shared-utils/getPxmm.d.ts

@@ -1,6 +1,19 @@
 import type { Five } from '@realsee/five';
+import { FLOOR_PLAN_ATTACHED_TO } from '../floorplan/constant';
+interface GetPxmmOption {
+    attachedTo: FLOOR_PLAN_ATTACHED_TO;
+}
+/** 获取当前楼层地面的 Y 值 */
+export declare function getFloorY(five: Five, floorIndex: number): number;
+/** 获取当前吸附类型的 Y 值
+ * * FLOOR_PLAN_ATTACHED_TO.FLOOR：当前楼层地板的 Y
+ * * FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER：当前模型中心的 Y
+ * * FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER：当前楼层天花板的 Y
+*/
+export declare function getAttachedY(five: Five, floorIndex: number, attachedTo?: FLOOR_PLAN_ATTACHED_TO): number;
 /**
  * 获取「在俯视图」状态下，模型 mm 与屏幕像素 px 的对应关系，即每 mm 对应多少 px
  * @param five five
  */
-export default function getPxmm(five: Five, container: Element): number;
+export default function getPxmm(five: Five, container: Element, floorIndex: number, options?: GetPxmmOption): number;
+export {};

package/libs/shared-utils/getPxmm.js

@@ -1,20 +1,39 @@
+import { FLOOR_PLAN_ATTACHED_TO } from '../floorplan/constant';
 import * as THREE from 'three';
+/** 获取当前楼层地面的 Y 值 */
+export function getFloorY(five, floorIndex) {
+    const maxFloorIndex = Math.max(...five.work.observers.map((ob) => ob.floorIndex));
+    return floorIndex > maxFloorIndex
+        ? five.model.bounding.max.y
+        : Math.max(...five.work.observers
+            .filter((ob) => ob.floorIndex === floorIndex)
+            .map((ob) => ob.standingPosition.y));
+}
+/** 获取当前吸附类型的 Y 值
+ * * FLOOR_PLAN_ATTACHED_TO.FLOOR：当前楼层地板的 Y
+ * * FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER：当前模型中心的 Y
+ * * FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER：当前楼层天花板的 Y
+*/
+export function getAttachedY(five, floorIndex, attachedTo = FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER) {
+    const currentFloorY = getFloorY(five, floorIndex);
+    const nextFloorY = getFloorY(five, floorIndex + 1);
+    if (attachedTo === FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER)
+        return (five.model.bounding.max.y + five.model.bounding.min.y) / 2;
+    else if (attachedTo === FLOOR_PLAN_ATTACHED_TO.CEILING)
+        return nextFloorY;
+    else
+        return currentFloorY;
+}
 /**
  * 获取「在俯视图」状态下，模型 mm 与屏幕像素 px 的对应关系，即每 mm 对应多少 px
  * @param five five
  */
-export default function getPxmm(five, container) {
-    const boundingCenter = new THREE.Vector3(0, 0, 0);
-    five.model.bounding.getCenter(boundingCenter);
-    const { y: boundingCenterY } = boundingCenter;
-    const { longitude } = five.getCurrentState();
-    // 因为模型可能经过旋转，所以屏幕水平方向上的 1m 对应 X 轴距离需要转换
-    const X = 1 / Math.abs(Math.cos(longitude));
-    // 模型绕 (boundingCenterX, boundingCenterY, boundingCenterZ) 旋转
-    const originPosition = new THREE.Vector3(0, boundingCenterY, 0);
-    const originPositionXUnit = new THREE.Vector3(X, boundingCenterY, 0);
-    const mouse = originPosition.project(five.camera);
-    const xUnitMouse = originPositionXUnit.project(five.camera);
+export default function getPxmm(five, container, floorIndex, options) {
+    const y = getAttachedY(five, floorIndex, options === null || options === void 0 ? void 0 : options.attachedTo);
+    const originPosition = new THREE.Vector3(0, y, 0);
+    const originPositionXUnit = new THREE.Vector3(1, y, 0);
+    const mouse = originPosition.clone().project(five.camera);
+    const xUnitMouse = originPositionXUnit.clone().project(five.camera);
     const pxmm = Math.abs((xUnitMouse.x - mouse.x) / 1000) * (container.getBoundingClientRect().width / 2);
     return pxmm;
 }

package/libs/shared-utils/index.d.ts

@@ -0,0 +1 @@
+export * from './math';

package/libs/shared-utils/index.js

@@ -0,0 +1 @@
+export * from './math';