@realsee/dnalogel 2.4.0 → 2.5.0

package/libs/PanoTagPlugin/mocks/v1/mock7.js

@@ -0,0 +1,228 @@
+const e = {
+  tagList: [
+    {
+      id: "u-T161w3kyIaSQn0",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [0.22148510000109672, 1.517, 3.1481822000000177],
+        [0.22148510000109672, 1.717, 3.1481822000000177],
+        [-0.07851489999890328, 1.717, 3.1481822000000177],
+        [-0.07851489999890328, 1.517, 3.1481822000000177]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-nqPWImkYiASqk0",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [0.34248509999999804, 1.517, 3.903182200000003],
+        [0.34248509999999804, 1.717, 3.903182200000003],
+        [0.34248509999999804, 1.717, 3.603182200000003],
+        [0.34248509999999804, 1.517, 3.603182200000003]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-4ASy5KkYIaSQHX",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [-2.528514900000002, 1.517, 0.24818220000000293],
+        [-2.528514900000002, 1.717, 0.24818220000000293],
+        [-2.528514900000002, 1.717, 0.548182200000003],
+        [-2.528514900000002, 1.517, 0.548182200000003]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-fRw8wqKYIASQMy",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [0.24248509999999807, 1.517, -0.5926472999999969],
+        [0.24248509999999807, 1.717, -0.5926472999999969],
+        [0.24248509999999807, 1.717, -0.8926472999999969],
+        [0.24248509999999807, 1.517, -0.8926472999999969]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-kZ96uUkYiAsqj4",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [0.34248509999999804, 1.517, -8.495272299999996],
+        [0.34248509999999804, 1.717, -8.495272299999996],
+        [0.34248509999999804, 1.717, -8.795272299999997],
+        [0.34248509999999804, 1.517, -8.795272299999997]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-KyPQ1nkyiAsqQH",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [-3.7705148999999945, 1.517, -3.618522299999997],
+        [-3.7705148999999945, 1.717, -3.618522299999997],
+        [-4.070514899999995, 1.717, -3.618522299999997],
+        [-4.070514899999995, 1.517, -3.618522299999997]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-9A7pXvkYIasqJY",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [-2.5285148999999585, 1.517, -4.068522299999997],
+        [-2.5285148999999585, 1.517, -4.368522299999997],
+        [-2.5285148999999585, 1.717, -4.368522299999997],
+        [-2.5285148999999585, 1.717, -4.068522299999997]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>"
+    },
+    {
+      id: "u-P3SmwCkYIaSQMs",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [0.24248509999999807, 1.517, -3.1820222999999968],
+        [0.24248509999999807, 1.717, -3.1820222999999968],
+        [0.24248509999999807, 1.717, -3.482022299999997],
+        [0.24248509999999807, 1.517, -3.482022299999997]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-oksb9DKyiAsQMt",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [-0.707514900000002, 1.517, -2.292647299999997],
+        [-0.707514900000002, 1.717, -2.292647299999997],
+        [-0.40751490000000196, 1.717, -2.292647299999997],
+        [-0.40751490000000196, 1.517, -2.292647299999997]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-kBqHOJKyIAsQQd",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [-2.528514900000002, 1.517, -7.402022299999997],
+        [-2.528514900000002, 1.717, -7.402022299999997],
+        [-2.528514900000002, 1.717, -7.102022299999997],
+        [-2.528514900000002, 1.517, -7.102022299999997]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-WKW6BoKyiASqpv",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [-1.3585149000000019, 1.517, -6.8122722999999965],
+        [-1.3585149000000019, 1.717, -6.8122722999999965],
+        [-1.3585149000000019, 1.717, -7.112272299999997],
+        [-1.3585149000000019, 1.517, -7.112272299999997]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-9G3UJRkyiAsqQf",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [-5.5205148999999984, 1.517, -6.888522299999997],
+        [-5.5205148999999984, 1.717, -6.888522299999997],
+        [-5.5205148999999984, 1.717, -6.588522299999997],
+        [-5.5205148999999984, 1.517, -6.588522299999997]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-QVST2hkYiaSQPn",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [-2.7705148999999945, 1.517, -7.762272299999997],
+        [-2.7705148999999945, 1.717, -7.762272299999997],
+        [-3.0705148999999947, 1.717, -7.762272299999997],
+        [-3.0705148999999947, 1.517, -7.762272299999997]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    },
+    {
+      id: "u-gTvYY5KyIASQQd",
+      dimensionType: "3D",
+      pointType: "PlaneTag",
+      contentType: "Custom",
+      position: [
+        [-2.7285149000000017, 1.517, -6.712272299999997],
+        [-2.7285149000000017, 1.717, -6.712272299999997],
+        [-2.7285149000000017, 1.717, -7.012272299999997],
+        [-2.7285149000000017, 1.517, -7.012272299999997]
+      ],
+      element: "<div>TTT2367189372819378291378921</div>",
+      data: {
+        text: "111"
+      }
+    }
+  ]
+};
+export {
+  e as default
+};

package/libs/PanoTagPlugin/tag.config.js

@@ -1,13 +1,9 @@
-const n = {
+const e = {
   globalConfig: {
-    initialState: {},
-    visibleConfig: {
-      visibleDistance: { max: 5 },
-      angleRange: { min: -45, max: 45 }
-    },
     unfoldedConfig: {
       autoUnfold: {
-        strategy: "MinimumDistance"
+        strategy: "MinimumDistance",
+        distance: { max: 5 }
       }
     },
     tag3DConfig: {
@@ -15,7 +11,7 @@ const n = {
     }
   },
   contentTypeConfig: {
-    "Any-Link-Any": {
+    "Any-Audio-plane": {
       unfoldedConfig: {
         keep: "unfolded"
       },
@@ -23,22 +19,41 @@ const n = {
         unfolded: !0
       }
     },
-    "Any-Marketing-Any": {
-      unfoldedConfig: void 0
+    Link: {
+      unfoldedConfig: {
+        keep: "unfolded"
+      },
+      initialState: {
+        unfolded: !0
+      }
+    },
+    VRLink: {
+      unfoldedConfig: {
+        keep: "unfolded"
+      },
+      initialState: {
+        unfolded: !0
+      }
+    },
+    PanoLink: {
+      unfoldedConfig: {
+        keep: "unfolded"
+      },
+      initialState: {
+        unfolded: !0
+      }
     },
-    "3D-MediaPlane-PlaneTag": {
+    MediaPlane: {
       unfoldedConfig: {
         keep: "unfolded"
       },
       visibleConfig: {
-        alwaysShowWhenMovePano: !0,
-        angleRange: void 0,
-        visibleDistance: void 0
+        alwaysShowWhenMovePano: !0
       }
     }
   }
 };
 export {
-  n as DefaultConfig,
-  n as default
+  e as DefaultConfig,
+  e as default
 };

package/libs/PanoTagPlugin/typings/controller.d.ts

@@ -1,20 +1,21 @@
-import type { PanoTagPluginController } from '../index';
-import type { ContentType, DimensionType, TagId, PointType, Tag } from '../typings';
+import type { PanoTagPluginController, TagConfig } from '../index';
 import type * as BasePlugin from '../../base/BasePlugin';
 import type TagContentSvelte from '../Components/Tag/index.svelte';
 import type { Vector3 } from 'three';
 import type { Create3DDomContainerReturnType } from '../../CSS3DRenderPlugin';
 import type { Writable } from 'svelte/store';
 import type { Subscribe } from '@realsee/five';
-export declare type PanoIndex = number;
-export declare type WorkCode = string;
-export declare type Hooks = InstanceType<typeof PanoTagPluginController>['hooks'];
+import type { TagId, StickType } from './tag/Utils';
+import type { TagContentType } from './tag/TagData';
+import type { Tag } from './tag/Tag';
 declare type NonNullable<T> = T extends null | undefined | void ? never : T;
+export declare type TagHooks = InstanceType<typeof PanoTagPluginController>['hooks'];
 export interface State extends BasePlugin.State {
 }
 export interface AddTagConfig {
     withAnimation?: boolean;
 }
+export declare type LoadTagConfig = AddTagConfig;
 export interface TemporaryState {
     visible?: boolean;
 }
@@ -25,7 +26,7 @@ export interface EventMap extends BasePlugin.EventMap<State> {
         };
     } & ({
         target: 'TagPoint';
-        tag: PointTagElement;
+        tag: PointTagElement<any>;
     } | {
         target: 'TagContent';
         tag: TagElement;
@@ -58,6 +59,7 @@ export interface EventMap extends BasePlugin.EventMap<State> {
     disable: (options: {
         userAction: boolean;
     }) => void;
+    loadVideoFirstFrame: () => void;
 }
 export declare type TagEvents = {
     unfolded: () => void;
@@ -72,16 +74,12 @@ export interface TagCache {
     distance?: number;
     angle?: number;
 }
-export declare type TagElement<C extends ContentType = ContentType, P extends PointType = PointType, D extends DimensionType = DimensionType, CustomDataType extends Object = {}> = Tag<C, P, D, CustomDataType> & Partial<{
+export declare type TagElement<C extends TagContentType = TagContentType, S extends StickType = StickType> = Tag<C, S> & Partial<{
     pointTagStyle: {
         leftPercent: number;
         topPercent: number;
     };
     clickable: boolean;
-    state: {
-        visible?: boolean;
-        unfolded: boolean;
-    };
     temporaryState: {
         visible: boolean;
     };
@@ -91,13 +89,21 @@ export declare type TagElement<C extends ContentType = ContentType, P extends Po
         initialNormal: Vector3;
         currentNormal: Vector3;
     };
+    play: () => void;
+    pause: () => void;
+}> & {
+    state: {
+        visible?: boolean;
+        unfolded: boolean;
+    };
     hooks: Subscribe<TagEvents>;
-}>;
+    mergedConfig: TagConfig<C, S>;
+};
 export declare type MediaStore = Writable<{
-    currentMediaUrl: string;
+    currentMediaElement: HTMLMediaElement | null;
 }>;
-export declare type PointTagElement<C extends ContentType = ContentType> = TagElement<C, PointType.PointTag, DimensionType>;
-export declare type PlaneTagElement<C extends ContentType = ContentType> = TagElement<C, PointType.PlaneTag, DimensionType.Three>;
-export declare type Tag2DElement<C extends ContentType = ContentType> = TagElement<C, PointType.PointTag, DimensionType.Two>;
-export declare type Tag3DElement<C extends ContentType = ContentType> = TagElement<C, PointType.PointTag, DimensionType.Three>;
+export declare type PointTagElement<C extends TagContentType = TagContentType> = TagElement<C, '3DPoint' | '2DPoint'>;
+export declare type PlaneTagElement<C extends TagContentType = TagContentType> = TagElement<C, 'Plane'>;
+export declare type Point2DElement<C extends TagContentType = TagContentType> = TagElement<C, '2DPoint'>;
+export declare type Point3DElement<C extends TagContentType = TagContentType> = TagElement<C, '3DPoint'>;
 export {};

package/libs/PanoTagPlugin/typings/index.d.ts

@@ -1,2 +1,6 @@
-export * from './tag';
 export * from './controller';
+export * from './tag/Tag';
+export * from './tag/Utils';
+export * from './tag/TagData';
+export * from './tag/TagConfig';
+export type { PartialDeep } from 'type-fest';

package/libs/PanoTagPlugin/typings/index.js

@@ -1 +1,7 @@
-
+import { ContentType as n } from "./tag/TagData.js";
+import { DimensionType as t, PointType as r } from "./tag/Utils.js";
+export {
+  n as ContentType,
+  t as DimensionType,
+  r as PointType
+};

package/libs/PanoTagPlugin/typings/tag/Tag.d.ts

@@ -0,0 +1,53 @@
+import type { State as FiveState } from '@realsee/five';
+import type { TagConfig } from './TagConfig';
+import { ContentTypeMap, ContentType, TagContentType } from './TagData';
+import type { ContentTypeConfigKey, Position, TagId, TagIconUrl, TagIconSize, StickType } from './Utils';
+export type { ContentTypeMap, TagContentType };
+export { ContentType };
+/** 返回一个销毁函数 */
+declare type ElementRenderer = (container: HTMLElement) => () => void;
+export interface Tags {
+    version?: string;
+    /** tag配置 > 按type配置 > 全局配置 */
+    /** 全局配置 */
+    globalConfig?: TagConfig;
+    /** 按type配置 */
+    contentTypeConfig?: Partial<Record<ContentTypeConfigKey, TagConfig>>;
+    /** 标签列表配置 */
+    tagList: Tag<any, any>[];
+}
+export declare type Tag<C extends TagContentType = TagContentType, S extends StickType = StickType> = {
+    /** 开启/禁用 */
+    enabled?: boolean;
+    /** 唯一标识 */
+    id: TagId;
+    /** @deprecated 一个点的标签/4个点的标签，已废弃，使用 stickType 代替 */
+    pointType?: 'PlaneTag' | 'PointTag';
+    /** @type {StickType} 附着方式 */
+    stickType: S;
+    /**  @deprecated 2维/3维类型，已废弃，使用 stickType 代替 */
+    dimensionType?: '2D' | '3D';
+    /** @type {TagContentType} 内容类型，根据内容类型展示对应UI */
+    contentType: C;
+    /** 点 */
+    position: S extends 'Plane' ? [Position, Position, Position, Position] : S extends '2DPoint' | '3DPoint' ? Position : any;
+    /** 法向量 */
+    normal?: Position;
+    /** 自定义标签内容 */
+    element?: string | Element | ElementRenderer;
+    /** 标签数据 */
+    data: ContentTypeMap[C];
+    /** 「展开/收起」 「可见/不可见」 的策略配置 */
+    config?: TagConfig<C, S>;
+    /** 打标签时的 five state */
+    fiveState?: FiveState;
+    /** 样式 */
+    style?: {
+        /** 小圆点样式 */
+        point?: {
+            size?: TagIconSize;
+        } & TagIconUrl;
+    };
+} & (S extends '3DPoint' ? {
+    normal: Position;
+} : unknown); /** 三维标签需要法向量 */

package/libs/PanoTagPlugin/typings/tag/Tag.js

@@ -0,0 +1,4 @@
+import { ContentType as t } from "./TagData.js";
+export {
+  t as ContentType
+};

package/libs/PanoTagPlugin/typings/tag/TagConfig.d.ts

@@ -0,0 +1,88 @@
+import type { Create3DDomContainerParamsType } from '../../../CSS3DRenderPlugin/Controller';
+import type { Five } from '@realsee/five';
+import type { TagContentType } from './TagData';
+import type { Tag } from './Tag';
+import type { MinMax, StickType } from './Utils';
+export interface TagConfig<C extends TagContentType = TagContentType, S extends StickType = StickType> {
+    /** 显示/隐藏配置 */
+    visibleConfig?: {
+        /** 保持可见/不可见, 设置后visibleConfig下所有其他配置都不生效 */
+        keep?: 'visible' | 'hidden';
+        /** 走点时不隐藏 */
+        alwaysShowWhenMovePano?: true;
+        /** min-max米内显示 | 无距离限制 */
+        visibleDistance?: MinMax | 'unLimited';
+        /**
+         * @description: 限制xx点位上可见，默认为all
+         * @param all: 不限制
+         * @param current: 仅当前点位可见
+         * @param: number[] 仅指定点位可见
+         */
+        visiblePanoIndex?: 'all' | 'current' | number[];
+        /** 碰撞检测配置，默认开启 */
+        intersectRaycaster?: boolean /** 是否开启碰撞检测，默认true */ | {
+            /** 是否开启碰撞检测，默认true */
+            enabled?: boolean;
+            /** 碰撞检测的允许误差, 默认值为0.01 */
+            distanceAccuracy?: number;
+        };
+        /** 3D标签中 「标签所在平面或垂直于标签法线的平面」 与 「摄像机到标签点或中心点的向量」 的夹角，范围内自动展开，范围外自动收起 */
+        angleRange?: MinMax;
+    } | ((five: Five, tagState: {
+        tag: Tag<C, S>;
+        /** 标签点或中心点的到摄像机的距离 */
+        distance: number;
+        /** 3D标签中 「标签所在平面或垂直于标签法线的平面」 与 「摄像机到标签点或中心点的向量」 的夹角 */
+        angleRange?: number;
+    }) => boolean);
+    /** 展开/收起配置 */
+    unfoldedConfig?: {
+        /** 保持展开/收起，设置后unfoldedConfig下所有其他配置都不生效 */
+        keep?: 'unfolded' | 'folded';
+        /** 划动到不可见状态时，自动收起，disableFold: true 的标签不受此参数影响 */
+        autoUnfoldWhenHide?: false;
+        /**
+         * @deprecated replace by { keep: 'folded' }
+         * @deprecated 部分标签是无法打开的
+         */
+        disableUnfold?: true;
+        /**
+         * @deprecated replace by { keep: 'unfolded' }
+         * @deprecated 部分标签是无法收起的
+         */
+        disableFold?: true;
+        /** min-max米内自动展开,否则收起 */
+        unfoldDistance?: MinMax;
+        /** 自动展开策略,  false 时不自动展开 */
+        autoUnfold?: false | {
+            enable?: boolean;
+            /** 自动展开 策略 */
+            strategy?: 'ScreenPostion';
+            /** 自动展开策略，{min,max}为project(camera)后的x值 */
+            autoUnfoldProjectX?: MinMax;
+        } | {
+            enable?: boolean;
+            /** 自动展开：最近标签自动展开 */
+            strategy?: 'MinimumDistance';
+            /** 展开的最大数量, 默认为1 */
+            maxNumber?: number;
+            /** 展开的最大距离, 默认为无限制 */
+            distance?: MinMax;
+        };
+    } | ((five: Five, tagState: {
+        tag: Tag<C, S>;
+        /** 标签点或中心点的到摄像机的距离 */
+        distance: number;
+        /** 3D标签中 「标签所在平面或垂直于标签法线的平面」 与 「摄像机到标签点或中心点的向量」 的夹角 */
+        angleRange?: number;
+    }) => boolean);
+    /** 初始状态 */
+    initialState?: {
+        /** 显示/隐藏 */
+        visible?: boolean;
+        /** 展开/收起 */
+        unfolded?: boolean;
+    };
+    tag3DConfig?: Create3DDomContainerParamsType['config'];
+    clickable?: false;
+}

package/libs/PanoTagPlugin/typings/tag/TagConfig.js

@@ -0,0 +1 @@
+