@realsee/five 5.0.0-alpha.14 → 5.0.0-alpha.142

package/{index.d.ts → five/index.d.ts}

@@ -1,6 +1,126 @@
-/// <reference types="hammerjs" />
-
+import Matrix3 from '@math.gl/core/dist/esm/classes/matrix3';
+import Matrix4 from '@math.gl/core/dist/esm/classes/matrix4';
+import Quaternion from '@math.gl/core/dist/esm/classes/quaternion';
 import * as THREE_2 from 'three';
+import Vector3 from '@math.gl/core/dist/esm/classes/vector3';
+
+export declare interface AddableObject extends THREE_2.Object3D {
+    needsRender?: boolean;
+    mixer?: THREE_2.AnimationMixer;
+    setResolution?(width: number, height: number): void;
+}
+
+export declare interface AnimationFrame {
+    callback: (time: number, deltaTime: number, ...args: any[]) => void;
+    once: boolean;
+    delay: number;
+    order: number;
+}
+
+export declare class AnimationFrameLoop {
+    private frames;
+    private time;
+    private stoped;
+    private context?;
+    private requestId;
+    private static sharedInstance?;
+    static get shared(): AnimationFrameLoop;
+    static getFrameTime(): number;
+    constructor();
+    private loop;
+    setContext(context: any): void;
+    getContext(): any;
+    private requestAnimationFrame;
+    private cancelAnimationFrame;
+    private remove;
+    /**
+     * 添加到动画循环
+     * @param callback - 动画循环回调
+     * @param once - 是否只回调一次
+     * @param delay - 延迟多少个动画循环回调
+     * @param order - 优先级，数字越小越早被调用
+     * @returns 移除动画循环函数
+     */
+    add(callback: AnimationFrame["callback"], once?: boolean, delay?: number, order?: number): () => void;
+    disponse(): void;
+}
+
+export declare class BVH {
+    trianglesArray?: Float32Array;
+    offsetArray?: Uint32Array;
+    rootNode?: BVHNode;
+    create(trianglesArray: Float32Array): this;
+    splitNode(maxTrianglesPerNode: number): this;
+    /**
+     * 计算射线与三角形的碰撞
+     * @param rayOrigin - 射线的原点坐标
+     * @param rayDirection - 设想的方向向量
+     * @param backfaceCulling - 是否背面剔除
+     * @return 碰撞焦点数组
+     */
+    intersectRay(rayOrigin: BVHVector3, rayDirection: BVHVector3, backfaceCulling: boolean): BVHIntersect[];
+    dispose(): void;
+}
+
+export declare class BVHIntersect {
+    triangle: [BVHVector3, BVHVector3, BVHVector3];
+    intersectionPoint: BVHVector3;
+    constructor(triangle: [BVHVector3, BVHVector3, BVHVector3], intersectionPoint: BVHVector3);
+}
+
+/**
+ * A node in the BVH structure
+ * @param extents - the min coords of this node's bounding box
+ * @param startIndex - an index in the bbox array, where the first element of this node is located
+ * @param endIndex - an index in the bbox array, where the last of this node is located, plus 1 (meaning that its non-inclusive).
+ * @param level - distance of this node from the root for the bvh tree. root node has level=0, its children have level=1 etc.
+ */
+export declare class BVHNode {
+    extents: ArrayLike<number>;
+    startIndex: number;
+    endIndex: number;
+    node0?: BVHNode;
+    node1?: BVHNode;
+    constructor(extents: ArrayLike<number>, startIndex: number, endIndex: number);
+}
+
+export declare class BVHVector3 {
+    x: number;
+    y: number;
+    z: number;
+    constructor(x: number, y: number, z: number);
+    copy(v: BVHVector3): this;
+    set(x: number, y: number, z: number): this;
+    fromArray(array: number[], firstElementPos?: number): this;
+    add(v: BVHVector3): this;
+    multiplyScalar(scalar: number): this;
+    subVectors(a: BVHVector3, b: BVHVector3): this;
+    dot(v: BVHVector3): number;
+    cross(v: BVHVector3): this;
+    crossVectors(a: BVHVector3, b: BVHVector3): this;
+    clone(): BVHVector3;
+}
+
+/** Five 相机 */
+export declare class Camera extends THREE_2.PerspectiveCamera {
+    /** 相机姿态 */
+    pose: CameraPose;
+    constructor(fov: number);
+    /** 通过相机参数反算姿态 */
+    computePose(): this;
+    /** 设置相机姿态 */
+    setFromPose(pose: Partial<CameraPose>): this;
+    /** 拷贝相机姿态 */
+    copyPose(): CameraPose;
+}
+
+export declare interface CameraPose {
+    longitude: number;
+    latitude: number;
+    fov: number;
+    distance: number;
+    offset: THREE_2.Vector3;
+}
 
 export declare type ControllerCustomInitTypes = {
     Floorplan: FloorplanControllerCustomInitArgs;
@@ -9,6 +129,8 @@ export declare type ControllerCustomInitTypes = {
     VRPanorama: VRPanoramaControllerCustomInitArgs;
     Model: ModelControllerCustomInitArgs;
     DepthPanorama: DepthPanoramaControllerCustomInitArgs;
+    Mapview: MapviewControllerCustomInitArgs;
+    XRPanorama: XRPanoramaControllerCustomInitArgs;
 };
 
 export declare type ControllerEventTypes = {
@@ -62,7 +184,7 @@ export declare type ControllerEventTypes = {
      * 观察点位被选择
      * @param panoIndex - 选择的点位
      */
-    panoSelected(panoIndex: number): void;
+    panoSelected(panoIndex: number | null): void;
     /**
      * 意图要移动到某个点位 可以通过 `return false` 阻止
      * @param panoIndex - 图要移动到的点位下标
@@ -142,6 +264,7 @@ export declare type ControllerEventTypes = {
     wantsGesture(type: GestureTypes, pointers: {
         x: number;
         y: number;
+        delta?: number;
     }[], final: boolean): void | false;
     /**
      * 手势 触发
@@ -152,6 +275,7 @@ export declare type ControllerEventTypes = {
     gesture(type: GestureTypes, pointers: {
         x: number;
         y: number;
+        delta?: number;
     }[], final: boolean): void;
     /**
      * 意图要触发 pan 手势(滑动屏幕)， 可以通过 `return false` 阻止
@@ -183,15 +307,17 @@ export declare type ControllerEventTypes = {
      * 意图要触发 tap 手势(点击屏幕)， 可以通过 `return false` 阻止
      * @param raycaster - 点击对应的三维射线
      * @param tapPosition - 点击对应的屏幕位置
+     * @param final - 是否手势结束
      * @returns 可以通过 `return false` 阻止
      */
-    wantsTapGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2): void | false;
+    wantsTapGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, final: boolean): void | false;
     /**
      * tap 手势(点击屏幕) 被触发
      * @param raycaster - 点击对应的三维射线
      * @param tapPosition - 点击对应的屏幕位置
+     * @param final - 是否手势结束
      */
-    tapGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2): void;
+    tapGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, final: boolean): void;
     /**
      * 意图要触发 pinch 手势(双指缩放)，可以通过 `return false` 阻止
      * @param scale - 缩放数值
@@ -200,6 +326,23 @@ export declare type ControllerEventTypes = {
      * @returns 可以通过 `return false` 阻止
      */
     wantsPinchGesture(scale: number, nextFov: number, final: boolean): void | false;
+    /**
+     * 意图要触发 press 手势(长按屏幕)， 可以通过 `return false` 阻止
+     * @param raycaster - 长按对应的三维射线
+     * @param tapPosition - 长按对应的屏幕位置
+     * @param duration - 长按持续时间
+     * @param final - 是否手势结束
+     * @returns 可以通过 `return false` 阻止
+     */
+    wantsPressGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, duration: number, isFinal: boolean): void | false;
+    /**
+     * tap 手势(点击屏幕) 被触发
+     * @param raycaster - 点击对应的三维射线
+     * @param tapPosition - 点击对应的屏幕位置
+     * @param duration - 长按持续时间
+     * @param final - 是否手势结束
+     */
+    pressGesture(raycaster: THREE_2.Raycaster, tapPosition: THREE_2.Vector2, duration: number, isFinal: boolean): void;
     /**
      * pinch 手势(双指缩放) 被触发
      * @param scale - 缩放数值
@@ -269,80 +412,48 @@ export declare type ControllerEventTypes = {
      * @param panoIndex - 加载点位下标
      * @param observer - 对应的 observer 详情
      */
-    textureLoaded(panoIndex: number, observer: WorkObserver): void;
+    textureLoaded(panoIndex: number, observer: WorkObserver, meta: (NetWorkMeta | null)[]): void;
     /**
      * 抛出错误
      * @param error - 抛出错误
      */
     error(error: Error): void;
+    /**
+     * webXR模式开始，webxr session完成坐标系矫正
+     */
+    webXRSessionStart(): void;
+    /**
+     * webXR模式结束,webxr session销毁
+     */
+    webXRSessionEnd(): void;
+    /**
+     * webXR模式结束,webxr session销毁
+     */
+    webXRSelected(type: WebXRSelectType): void;
 };
 
+/**
+ * URL 地址的转换
+ * @param source - url 原地址
+ * @param options - url 转换参数
+ * @returns url 转换结果
+ */
+export declare function defaultImageURLTransform(source: string, options: ImageURLOptions): string;
+
 export declare interface DepthPanoramaControllerCustomInitArgs extends PanoramaLikeControllerCustomInitArgs {
     /** 最远可移动观察点距离 */
     maxAccessibleDistance?: number;
+    /**
+     * 点击地面观察点标识的判定范围
+     * @description
+     * 如果在判定范围内则确定去到目标点，
+     * 否则寻找点击位置方向最适合的点（可能会走到一个离相机更近的点）。
+     */
+    panoTapTriggerRadius?: number;
     /** 地面观察点标识自定义创建器 */
     panoCircleMeshCreator?: () => PanoCircleMeshInterface;
 }
 
-/**
- * 动画变化曲线
- */
-export declare const Easing: {
-    Linear: {
-        None: (amount: number) => number;
-    };
-    Quadratic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Cubic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Quartic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Quintic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Sinusoidal: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Exponential: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Circular: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Elastic: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Back: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-    Bounce: {
-        In: (amount: number) => number;
-        Out: (amount: number) => number;
-        InOut: (amount: number) => number;
-    };
-};
-
 /**
  * Five 事件列表
  * @description
@@ -363,19 +474,25 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      */
     error(error: Error): void;
     /**
-     * 开始加载 Work 数据
+     * 准备加载 Work 数据
      * @param input - 输入的 work
      * @param work - 归一化的标准 work
      * @param state - 加载时的姿态
      */
-    willLoad(input: any, work: Work, state: Omit<State, "offset">): void;
+    willLoad(input: any, work: Work, state: Omit<State, "offset" | "distance">): void;
     /**
      * 开始加载 Work 数据
      * @param input - 输入的 work
      * @param work - 归一化的标准 work
      * @param state - 加载时的姿态
      */
-    load(input: any, work: Work, state: Omit<State, "offset">): void;
+    load(input: any, work: Work, state: Omit<State, "offset" | "distance">): void;
+    /**
+     * 加载完 Work 数据
+     * @param input - 输入的 work
+     * @param work - 归一化的标准 work
+     */
+    loaded(input: any, work: Work): void;
     /**
      * 模型开始加载
      * @param workModel - 归一化的标准 work 中的 model 值
@@ -410,8 +527,16 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      * @param model - 加载完的 model 本质是一个 {@link PBMGroup}
      */
     modelLoaded(model: Model): void;
-    /** 每帧渲染完成 */
-    renderFrame(): void;
+    /**
+     * 模型楼层切换
+     * @param shownFloor - 模型楼层
+     */
+    modelShownFloorChange(shownFloor: number | null, totalFloorLength: number): void;
+    /**
+     * 渲染循环
+     * @param rendered - 是否渲染了
+     */
+    renderFrame(rendered: boolean): void;
     /**
      * 当前 fps 变化
      * @param fps - 当前刷新率
@@ -469,8 +594,21 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
      * @param prevMode - 上本质是一个模态
      * @param panoIndex - 初始化动画结束后的点位下标
      * @param toPose - 初始化动画结束后的状态
+     * @param userAction - 是否用户触发
      */
-    modeChange(mode: Mode, prevMode: Mode, panoIndex: number, toPose: Pose): void;
+    modeChange(mode: Mode, prevMode: Mode, panoIndex: number, toPose: Pose, userAction: boolean): void;
+    /**
+     * 帮助元素显应的变换
+     * @param visible - 帮助元素的是否开启
+     */
+    helpersVisibleChange(visible: boolean): void;
+    /**
+     * 网络资源分析
+     * @param source - 资源地址
+     * @param state - 状态
+     * @param detail - 详情
+     */
+    network(source: string, type: NetworkType, state: NetworkState, detail: string): void;
     /** five 被析构。 插件中请监听用于自身析构 */
     dispose(): void;
 };
@@ -489,6 +627,7 @@ export declare type EventTypes = Pick<ControllerEventTypes, typeof PROXY_CONTROL
  * ```
  */
 export declare class Five extends Subscribe<EventTypes> {
+    static get version(): string;
     /**
      * Five 的显示模式，可以通过 `five.changeMode` `five.setState` 来切换
      * @description
@@ -499,67 +638,15 @@ export declare class Five extends Subscribe<EventTypes> {
      * Topview 户型图模式
      * DepthPanorama 深度图游走模式
      * VRPanorama VR眼镜模式
+     * XRPanorama VR硬件模式
      * ```
      */
     static Mode: Mirror<Mode>;
-    /** Five 线条*/
-    static FiveLine: typeof FiveLine;
-    /** Five 的动画函数*/
-    static Easing: {
-        Linear: {
-            None: (amount: number) => number;
-        };
-        Quadratic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Cubic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Quartic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Quintic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Sinusoidal: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Exponential: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Circular: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Elastic: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Back: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-        Bounce: {
-            In: (amount: number) => number;
-            Out: (amount: number) => number;
-            InOut: (amount: number) => number;
-        };
-    };
+    /**
+     * @deprecated
+     * 请使用 `import { Line } from "@realsee/five/line"` 代替;
+     */
+    static Line: any;
     /**
      * 自动播放状态是否暂停
      * @description
@@ -571,9 +658,9 @@ export declare class Five extends Subscribe<EventTypes> {
     /** 当前展示的模式 */
     currentMode?: Mode;
     /** 内部使用的 `THREE.Scene` */
-    scene: FiveScene;
+    scene: Scene;
     /** 内部使用的 `Camera` */
-    camera: FiveCamera;
+    camera: Camera;
     /**
      * 当前设置的 `scissor`
      * @description
@@ -592,11 +679,9 @@ export declare class Five extends Subscribe<EventTypes> {
      * 如果初始化时传入了 `renderer` 则直接时该值
      * 否则会通过 `preserveDrawingBuffer` `backgroundColor` `backgroundAlpha` `antialias` 创建一个 `THREE.WebGLRenderer`
      */
-    renderer: THREE_2.WebGLRenderer;
+    renderer?: THREE_2.WebGLRenderer;
     /** 当前加载的模型 */
     model: Model;
-    /** 当前加载的 work 数据 */
-    work?: Work;
     /**
      * 是否需要渲染
      * @description
@@ -617,7 +702,7 @@ export declare class Five extends Subscribe<EventTypes> {
      * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
      * 平衡加载时间和图片质量
      */
-    textureOptions: ImageOptions;
+    textureOptions: TextureOptions;
     /**
      * 模型贴图的配置参数
      * @description
@@ -648,21 +733,35 @@ export declare class Five extends Subscribe<EventTypes> {
     plugins: {
         [key: string]: FivePluginInstance<any>;
     };
-    private ident;
+    ident: string;
+    private stopAnimationLoop?;
+    private fps;
+    private helperGroup;
     private modeChangeDuration;
     private onlyRenderIfNeeds;
-    private maxFps;
+    private poweredByRealsee;
     private controller?;
     private destroyed;
     private stateSynced;
     private controllerInits;
     private panoramaLikeSavedPose;
     private extraElements;
-    private moveToPanoQueue?;
     private getPixelsRenderTarget;
-    private tweenCoordinates?;
     private readyCallbacks;
     private modelPending;
+    private syncingState;
+    /**
+     * 是否开启 IOS EDR 模式
+     * 需要客户端配合
+     * 并且开启 five.enablepostProcessing = true
+     */
+    private _enableIOSEDR;
+    private lastLoadWorkTask;
+    private requestProxy;
+    private networkSubscribe;
+    private screenBuffer?;
+    private analysis?;
+    private renderSwitch01;
     constructor(initArgs?: FiveInitArgs);
     /**
      * 析构 five 对象。
@@ -683,6 +782,21 @@ export declare class Five extends Subscribe<EventTypes> {
      * ```
      */
     setScissor(scissor: Scissor): void;
+    /**
+     * 帮助元素显示/隐藏
+     */
+    get helperVisible(): boolean;
+    set helperVisible(visible: boolean);
+    /**
+     * 是否开启 IOS EDR 模式
+     * 需要客户端配合
+     * 并且开启 five.enablepostProcessing = true
+     */
+    get enableIOSEDR(): boolean;
+    set enableIOSEDR(enable: boolean);
+    get enablePostProcessing(): boolean;
+    set enablePostProcessing(enable: boolean);
+    updateConfiguration(args: Pick<FiveInitArgs, "panorama" | "model" | "floorplan" | "topview" | "mapview" | "depthPanorama" | "vrPanorama" | "imageOptions">): void;
     /**
      * 将显示区域加载到页面 DOM 中
      * @description
@@ -720,6 +834,8 @@ export declare class Five extends Subscribe<EventTypes> {
      * 获取当前相机姿态, 可以使用 getCurrentState 代替
      */
     getPose(): Pose;
+    getSize(target: THREE_2.Vector2): THREE_2.Vector2;
+    getDrawingBufferSize(target: THREE_2.Vector2): THREE_2.Vector2;
     /**
      * 移动相机。（不触发点位移动）
      * @description
@@ -727,9 +843,10 @@ export declare class Five extends Subscribe<EventTypes> {
      * 会 Promise.reject。运动完成则 Promise.resolve
      * @param pose - 相机目标位置
      * @param duration - 动画触发的时常
+     * @param userAction - 是否用户触发
      * @returns Promise 是否移动成功
      */
-    updateCamera(pose: Partial<Pose>, duration: number): Promise<void>;
+    updateCamera(pose: Partial<Omit<Pose, "offset">>, duration: number, userAction?: boolean): Promise<void>;
     /**
      * 获取当前相机经纬度
      * @deprecated 请使用使用 getPose
@@ -765,10 +882,12 @@ export declare class Five extends Subscribe<EventTypes> {
      *
      * // 使用指定解析器
      * // 会调用这个目录下的 basis_transcoder.js basis_transcoder.wasm 文件作为解析器
-     * five.initialBasisLoader("https://vrlab-public.ljcdn.com/release/static/image/release/five/basis/");
+     * five.initialBasisLoader("https://vr-public.realsee-cdn.cn/release/static/image/release/five/basis/");
      * ```
      */
     initBasisLoader(transcoderResourcePath?: string): void;
+    /** 当前加载的 work 数据 */
+    get work(): Work;
     /**
      * 加载 Work 数据
      * @param inputWork - Work 数据
@@ -778,15 +897,17 @@ export declare class Five extends Subscribe<EventTypes> {
      *  - State 自定义姿态
      * @param duration - 切换时间
      */
-    load(inputWork: Work | LooseWork | any, state?: "inherit" | "initial" | Partial<Omit<State, "offset">>, duration?: number): Promise<void>;
+    load(inputWork: Work | LooseWork | any | Promise<Work | LooseWork | any>, state?: "inherit" | "initial" | Partial<Omit<State, "offset">>, duration?: number, userAction?: boolean): Promise<void>;
+    private load_;
     /**
      * 切换模态
      * @param mode - 切换到的模态
      * @param state - 切换完成时的姿态
      * @param duration - 模态切换动画用时
      * @param userAction - 是否时用户动作触发 默认 true
+     * @param force - 必须重新初始化 controller
      */
-    changeMode<T extends Mode>(mode: T, state?: Partial<Omit<State, "mode">>, duration?: number, userAction?: boolean): Promise<void>;
+    changeMode<T extends Mode>(mode: T, state?: Partial<Omit<State, "mode">>, duration?: number, userAction?: boolean, force?: boolean): Promise<void>;
     /**
      * 获取画面中的像素颜色
      * @param x - 获取像素区域的起始坐标 x
@@ -800,11 +921,7 @@ export declare class Five extends Subscribe<EventTypes> {
     /**
      * 获取显示用的画布（Canvas DOM节点）
      */
-    getElement(): HTMLCanvasElement;
-    /**
-     * 但停自动播放
-     */
-    pause(): void;
+    getElement(): HTMLCanvasElement | undefined;
     /**
      * 强制渲染
      * @description
@@ -816,7 +933,12 @@ export declare class Five extends Subscribe<EventTypes> {
      *
      * @param callback - 渲染完成回调
      */
-    render(callback?: () => void): void;
+    render(callback?: () => void, updateObjectResolution?: boolean): THREE_2.WebGLRenderTarget;
+    updateTime(time: number, deltaTime: number, ...args: any[]): void;
+    /**
+     * 但停自动播放
+     */
+    pause(): void;
     play(): void;
     /**
      * 转化到 Panorama 模态，并移动到对应序号的观察点。
@@ -824,7 +946,7 @@ export declare class Five extends Subscribe<EventTypes> {
      * @param options - 移动点位参数
      * @param userAction - 是否用户触犯
      */
-    moveToPano(panoIndex: number, options?: MovePanoOptions, userAction?: boolean): void;
+    moveToPano(panoIndex: number, options?: MovePanoOptions, userAction?: boolean): Promise<void>;
     /**
      * 预加载点位图片资源
      * @param panoIndex - 观察点序号
@@ -845,7 +967,7 @@ export declare class Five extends Subscribe<EventTypes> {
      * 获取当前在屏幕视锥中的 mesh。
      * @param object - 如果传入则检查这个对象中的mesh，如果不传，则检查整个 scene
      */
-    getRenderMeshes(object?: THREE_2.Object3D): THREE_2.Object3D[];
+    getRenderObjects(object?: THREE_2.Object3D): THREE_2.Object3D[];
     getCurrentState(): State;
     /**
      * 设置 State
@@ -866,34 +988,32 @@ export declare class Five extends Subscribe<EventTypes> {
      * ```
      * @param state - 目标状态
      * @param immediately - 是否马上转换，马上转换会尽快达到目标状态，尽量减少中间状态，更少动画。
+     * @param userAction - 是否是用户触发的动作
      */
-    setState(state: Partial<State>, immediately?: boolean): void;
+    setState(state: Partial<State>, immediately?: boolean, userAction?: boolean): void;
+    aroundScissor(callback: () => void): void;
     private syncState;
-    ready(): Promise<void>;
-    private updateResolution;
+    /**
+     * 当前页面静态
+     */
+    ready(args?: {
+        tile?: boolean;
+    }): Promise<void>;
+    /**
+     * 请求全屏
+     */
+    requestFullscreen(): void;
+    /**
+     * 退出全屏
+     */
+    exitFullscreen(): void;
     private throwError;
     private loadModel;
     private commonParams;
     private saveControllerPose;
     private applyController;
-}
-
-/** Five 相机 */
-export declare class FiveCamera extends THREE_2.PerspectiveCamera {
-    /** 相机姿态 */
-    pose: Pose;
-    constructor(fov: number);
-    /** 通过相机参数反算姿态 */
-    computePose(): void;
-    /** 设置相机姿态 */
-    setFromPose(pose: Partial<Pose>): void;
-    /** 拷贝相机姿态 */
-    copyPose(): Pose;
-}
-
-export declare class FiveHashCubeTexture extends THREE_2.CubeTexture {
-    /** 识别哈希 */
-    hash: string;
+    /** 移除事件绑定 */
+    private removeEventListeners;
 }
 
 /** Five 初始化参数 */
@@ -979,7 +1099,7 @@ export declare interface FiveInitArgs {
      * 可以动态对配置在 `work` 数据中的模型贴图在 runtime 做 url 调整。
      * 平衡加载时间和图片质量
      */
-    textureOptions?: ImageOptions;
+    textureOptions?: TextureOptions;
     /**
      * 是否按需渲染
      * @description
@@ -1009,7 +1129,7 @@ export declare interface FiveInitArgs {
      *
      * // 使用指定解析器
      * // 会调用这个目录下的 basis_transcoder.js basis_transcoder.wasm 文件作为解析器
-     * initialBasisLoader: "https://vrlab-public.ljcdn.com/release/static/image/release/five/basis/"
+     * initialBasisLoader: "https://vr-public.realsee-cdn.cn/release/static/image/release/five/basis/"
      * ```
      */
     initialBasisLoader?: boolean | string;
@@ -1029,15 +1149,19 @@ export declare interface FiveInitArgs {
     floorplan?: ControllerCustomInitTypes["Floorplan"];
     /** 户型图模式下的特定参数 */
     topview?: ControllerCustomInitTypes["Topview"];
+    /** 地图模式下的特定参数 */
+    mapview?: ControllerCustomInitTypes["Mapview"];
     /** 深度图游走模式下的特定参数 */
     depthPanorama?: ControllerCustomInitTypes["DepthPanorama"];
     /** VR眼镜模式下的特定参数 */
     vrPanorama?: ControllerCustomInitTypes["VRPanorama"];
+    /** XR眼镜模式下的特定参数 */
+    xrPanorama?: ControllerCustomInitTypes["XRPanorama"];
     /**
      * 模式间切换时的过度动画时间
      * @description
      * 单位毫秒
-     * @default `1000`
+     * @default `800`
      */
     modeChangeDuration?: number;
     /**
@@ -1046,58 +1170,20 @@ export declare interface FiveInitArgs {
      * 详见插件部分。
      */
     plugins?: (FivePlugin<void> | FivePluginInit<FivePlugin<any, any>> | FivePluginInit<FivePlugin<void, any>>)[];
-}
-
-export declare class FiveLine extends THREE_2.Object3D {
-    private line;
-    private points;
-    constructor(vector0?: THREE_2.Vector3, vector1?: THREE_2.Vector3);
-    setPoints(vector0: THREE_2.Vector3, vector1: THREE_2.Vector3): void;
-    getPoints(): THREE_2.Vector3[];
-    setMaterial(map: ConstructorParameters<typeof FiveLineMaterial>[0]): void;
-    setResolution(width: number, height: number): void;
-}
-
-export declare class FiveLineGeometry extends FiveLineSegmentsGeometry {
-    constructor();
-    setPositions(array: ArrayLike<number>): this;
-    setColors(array: ArrayLike<number>): this;
-    fromLine(line: THREE_2.Line): this;
-    copy(): this;
-}
-
-export declare class FiveLineMaterial extends THREE_2.ShaderMaterial {
-    color: number | THREE_2.Vector3;
-    dashed: boolean;
-    dashScale: number;
-    dashSize: number;
-    gapSize: number;
-    resolution: THREE_2.Vector2;
-    constructor(parameters: FiveLineMaterialParameters);
-}
-
-export declare type FiveLineMaterialParameters = {
-    color?: number | THREE_2.Vector3;
-    linewidth?: number;
-    dashed?: boolean;
-    dashScale?: number;
-    dashSize?: number;
-    gapSize?: number;
-    resolution?: THREE_2.Vector2;
-};
-
-export declare class FiveLineSegmentsGeometry extends THREE_2.InstancedBufferGeometry {
-    constructor();
-    applyMatrix4(matrix: THREE_2.Matrix4): this;
-    setPositions(array: ArrayLike<number> | number[]): this;
-    setColors(array: Float32Array | number[]): this;
-    fromWireframeGeometry(geometry: THREE_2.WireframeGeometry): this;
-    fromEdgesGeometry(geometry: THREE_2.EdgesGeometry): this;
-    fromMesh(mesh: THREE_2.Mesh): this;
-    fromLineSegments(lineSegments: THREE_2.LineSegments): this;
-    computeBoundingBox(): void;
-    computeBoundingSphere(): void;
-    toJSON(): void;
+    /**
+     * 是否展示 powered by 如视
+     */
+    poweredByRealsee?: boolean;
+    /**
+     * 是否使用webgl2渲染执行环境, 默认值 false
+     */
+    webgl2?: boolean;
+    /**
+     * 请求代理
+     * @param url - 发起的请求
+     * @returns 返回的请求
+     */
+    requestProxy?(url: string): string;
 }
 
 /**
@@ -1127,10 +1213,6 @@ parameters: Parameters<T>[1]
  */
 export declare type FivePluginInstance<T extends FivePlugin<any, any>> = ReturnType<T>;
 
-/** Five 场景*/
-export declare class FiveScene extends THREE_2.Scene {
-}
-
 export declare interface FloorplanControllerCustomInitArgs {
     /** 默认偏航角 */
     defaultLongitude?: number;
@@ -1148,7 +1230,7 @@ export declare interface FloorplanControllerCustomInitArgs {
     minFov?: number;
 }
 
-export declare type GestureTypes = "pan" | "tap" | "pinch" | "mouseWheel";
+export declare type GestureTypes = "pan" | "tap" | "pinch" | "press" | "mouseWheel";
 
 export declare function getViewportScale(): number;
 
@@ -1156,33 +1238,65 @@ export declare function getViewportScale(): number;
  * 图片参数
  */
 export declare interface ImageOptions {
-    key?: string;
     /**
      * url 地址转化
      * @param url - 原始地址
      * @param options - 当前地址参数
      * @returns 转化后地址
      */
-    transform?: (url: string, options: ImageOptions) => string;
-    /** 图片尺寸参数 */
+    transform?: (url: string, options: ImageURLOptions) => string;
+    /** 图片尺寸参数 尽量使用 2 的幂次 如 512 1024 2048 */
     size?: number;
     /** 图片质量参数(0-100) */
     quality?: number;
-    /** 图片格式参数（jpg, png） */
-    format?: string;
-    /** basis loader 是否初始化完成 */
-    basisLoaderInitialized?: boolean;
-    /** 针对 textureOptions 是否自动通过模型贴图的数量计算需要的模型贴图的尺寸 默认 true */
-    autoResize?: boolean;
+    /** 图片格式参数 */
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+    /** 锐化参数 海外不支持 */
+    sharpen?: number;
+    mappings?: ImageURLMappings;
+}
+
+export declare function imageSupport(): Promise<{
+    avif: boolean;
+    webp: boolean;
+}>;
+
+export declare interface ImageURLMappings {
+    [publicDomain: string]: {
+        "pano": [string, string];
+        "tile": [string, string];
+        "texture": [string];
+        "default": [string];
+    };
+}
+
+export declare interface ImageURLOptions {
+    /** 图片类型标识 */
+    key: string;
+    /** basisLoader 是否初始化完成 */
+    basisLoaderInitialized: boolean;
+    /** 图片尺寸参数 尽量使用 2 的幂次 如 256 512 1024 */
+    size?: number;
+    /** 图片质量参数(0-100) */
+    quality?: number;
+    /** 图片格式参数 */
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+    /** 图片裁切 */
+    cut?: [x: number, y: number, width: number, height: number];
+    /** 锐化参数 海外不支持 */
+    sharpen?: number;
+    /** url匹配规则 */
+    mappings?: ImageURLMappings;
 }
 
 export declare class InternalWebGLRenderer extends THREE_2.WebGLRenderer {
-    constructor({ preserveDrawingBuffer, backgroundColor, backgroundAlpha, pixelRatio, antialias }: {
+    constructor({ preserveDrawingBuffer, backgroundColor, backgroundAlpha, pixelRatio, antialias, webgl2 }: {
         preserveDrawingBuffer?: boolean;
         backgroundColor?: number | THREE_2.Color;
         backgroundAlpha?: number;
         pixelRatio?: number;
         antialias?: boolean;
+        webgl2?: boolean;
     });
 }
 
@@ -1197,10 +1311,42 @@ export declare interface Intersection {
     distance: number;
 }
 
+export declare class IntersectMesh extends THREE_2.Object3D implements IntersectMeshInterface {
+    private ringMesh;
+    constructor();
+    dispose(): void;
+}
+
+/**
+ * 地面提示点位接口
+ */
 export declare interface IntersectMeshInterface extends THREE_2.Object3D {
     dispose(): void;
 }
 
+export declare class LegacyPanoCircleMesh extends THREE_2.Object3D implements PanoCircleMeshInterface {
+    needsRender: boolean;
+    hitTestMesh: THREE_2.Mesh<THREE_2.BufferGeometry, THREE_2.MeshBasicMaterial>;
+    current: boolean;
+    loading: boolean;
+    disabled: boolean;
+    progress: number;
+    opacity: number;
+    private centerMesh;
+    private loadingMesh;
+    private progressMotion;
+    private opacityMotion;
+    private stopInterval?;
+    constructor();
+    setLoading(shown: boolean): void;
+    setDisabled(disabled: boolean): void;
+    setProgress(progress: number): void;
+    setOpacity(opacity: number): void;
+    setCurrent(current: boolean): void;
+    updateTime(time: number, deltaTime: number): void;
+    dispose(): void;
+}
+
 export declare type LooseWork = {
     bvh?: boolean;
     modelAsync?: boolean;
@@ -1258,7 +1404,15 @@ export declare type LooseWorkPanorama = {
     front: string;
     back: string;
     video?: LooseWorkVideo;
-    tiles?: string;
+    luminance?: {
+        up: string;
+        down: string;
+        right: string;
+        left: string;
+        front: string;
+        back: string;
+    };
+    tiles?: number[];
 };
 
 export declare type LooseWorkVideo = {
@@ -1267,6 +1421,23 @@ export declare type LooseWorkVideo = {
     size: number[];
 };
 
+export declare interface MapviewControllerCustomInitArgs {
+    /** 默认偏航角 */
+    defaultLongitude?: number;
+    /** 默认俯仰角 */
+    defaultLatitude?: number;
+    /** 默认相机距离 */
+    defaultDistance?: number;
+    /** 最大俯仰角 */
+    maxLatitude?: number;
+    /** 最小俯仰角 */
+    minLatitude?: number;
+    /** 最大相机距离 */
+    maxDistance?: number;
+    /** 最小相机距离 */
+    minDistance?: number;
+}
+
 export declare type Mirror<T extends string> = Record<T, T>;
 
 /**
@@ -1275,6 +1446,7 @@ export declare type Mirror<T extends string> = Record<T, T>;
  * - **Model**: 模型游走模式
  * - **Floorplan**: 模型查看模式
  * - **Topview**: 户型图模式
+ * - **Mapview**: 地图模式
  * - **DepthPanorama**: 深度图游走模式
  * - **VRPanorama**: VR眼镜模式
  */
@@ -1283,6 +1455,8 @@ export declare type Mode =
 "Floorplan" | 
 /** 户型图模式 */
 "Topview" | 
+/** 地图模式 */
+"Mapview" | 
 /** 全景图游走模式 */
 "Panorama" | 
 /** VR眼镜模式 */
@@ -1290,7 +1464,9 @@ export declare type Mode =
 /** 模型游走模式 */
 "Model" | 
 /** 深度图游走模式 */
-"DepthPanorama";
+"DepthPanorama" | 
+/** XR眼镜模式*/
+"XRPanorama";
 
 /**
  * Five 模型
@@ -1300,7 +1476,7 @@ export declare type Mode =
  * 需要满足 your/path/filename.at3d.json_xxxxxx,
  * 通过 json_xxxxxx(<dataURL>) 方式返回。
  */
-export declare class Model extends PBMGroup implements Subscribe<ModelEventType> {
+export declare class Model extends PBMContainer implements Subscribe<ModelEventType> {
     /** 是否加载完成 */
     loaded: boolean;
     /** 是否未加载 */
@@ -1308,7 +1484,13 @@ export declare class Model extends PBMGroup implements Subscribe<ModelEventType>
     /** 外接盒子的大小 */
     bounding: THREE_2.Box3;
     /** 当前显示的楼层 */
-    shownfloor: number | null;
+    shownFloor: number | null;
+    /** 楼层的数量 */
+    floorLength: number;
+    /** 模型瓦片 */
+    originModel?: PBMContainer;
+    /** 模型瓦片 */
+    tiledModel?: Tile3DModel;
     /**
      * 判断是否注册了事件
      * 具体可查看 {@link Subscribe.hasListener}
@@ -1335,18 +1517,48 @@ export declare class Model extends PBMGroup implements Subscribe<ModelEventType>
      */
     emit: SubscribeMixinType.emit<ModelEventType>;
     /** bvh 树的计算结果 */
-    bvhs: any[] & {
-        loaded?: boolean;
+    bvhs: BVH[] & {
+        loaded: boolean;
     };
-    constructor();
+    /** 网络代理 */
+    private requestProxy?;
+    /** 网络跟踪 */
+    private networkSubscribe?;
+    /** 安全域名 */
+    private allowHosts?;
+    constructor(options?: {
+        networkSubscribe?: NetworkSubscribe;
+        requestProxy?: (url: string) => string;
+        allowHosts?: string[];
+    });
+    /**
+     * 当前显示的楼层
+     * @deprecated
+     * 请用 shwonFloor 代替
+     */
+    get shownfloor(): number | null;
+    /**
+     * 当前模型是否支持瓦片
+     */
+    get hasTiles(): boolean;
+    /**
+     * 是否开启瓦片
+     */
+    get enableTiles(): boolean;
+    set enableTiles(enable: boolean);
     /**
      * 获取模型边界线
      * @param threshold - 面片间夹角阈值
      * @returns 所有模型边界线
      */
     getEdges(threshold?: number): THREE_2.Line3[];
-    /** 获取当前楼层数 */
+    /**
+     * 获取当前楼层数
+     * @deprecated
+     * 请使用 floorLength 参数代替
+     */
     hasFloors(): number;
+    private hasFloors_;
     /**
      * 显示某楼层
      * @example
@@ -1357,7 +1569,9 @@ export declare class Model extends PBMGroup implements Subscribe<ModelEventType>
      * ```
      */
     show(): void;
-    show(floorIndex: number, hideOpacity?: number): void;
+    show(floorIndex: number, hiddenOpacity?: number): void;
+    private at3dShow;
+    private b3dmShow;
     /**
      * 计算模型射线碰撞检测
      * @param raycaster - THREE 射线对象
@@ -1365,13 +1579,14 @@ export declare class Model extends PBMGroup implements Subscribe<ModelEventType>
      * @returns 返回碰撞
      */
     intersectRaycaster(raycaster: THREE_2.Raycaster, floors?: number | number[]): Intersection[];
-    buildBVH(): Promise<void>;
+    buildBVH(): void;
     /**
      * 加载模型
      * @param workModel - work 的 model 内容
      * @param imageOptions - 图片参数
      */
-    load(workModel: WorkModel, imageOptions?: ImageOptions): void;
+    load(workModel: WorkModel, textureOptions?: TextureOptions): Promise<void>;
+    update(renderer: THREE_2.WebGLRenderer, camera: THREE_2.PerspectiveCamera): void;
     /**
      * 析构函数
      * @description
@@ -1410,6 +1625,11 @@ export declare type ModelEventType = {
     materialLoaded(): void;
     /** 模型加载完成 */
     loaded(): void;
+    /**
+     * 显示楼层改变
+     * @param shownFloor - 显示的楼层
+     */
+    shownFloorChange(shownFloor: number | null, totalFloorLength: number): void;
     /**
      * 内部错误
      * @param error - 错误对象
@@ -1428,9 +1648,10 @@ export declare interface MovePanoOptions extends Partial<Omit<Pose, "offset">> {
      * @description
      * - `fly` 通过相机移动方式变化
      * - `fade` 通过渐变方式变化
+     * - `montage` 通过渐变穿插到黑屏方式变化
      * - `instant` 通过插入黑屏方式变化
      */
-    effect?: "fly" | "fade" | "instant";
+    effect?: "fly" | "fade" | "montage" | "instant";
     /**
      * 运动耗时
      * @description
@@ -1456,15 +1677,84 @@ export declare interface MovePanoOptions extends Partial<Omit<Pose, "offset">> {
     moveCancelCallback?: () => void;
 }
 
+export declare type NetWorkMeta = {
+    source: string;
+    headers: {
+        [name: string]: string;
+    };
+    requestTime: number;
+    responseTime: number;
+    costs: number;
+    size?: number;
+};
+
+export declare type NetworkState = "ok" | "preload" | "error" | "timeout" | "forbidden";
+
+export declare class NetworkSubscribe extends Subscribe<{
+    network(source: string, type: NetworkType, state: NetworkState, detail: string): void;
+}> {
+}
+
+export declare type NetworkType = "XMLHttpRequest" | "Script" | "Image" | "Link";
+
+export declare class PanoCircleMesh extends THREE_2.Object3D implements PanoCircleMeshInterface {
+    needsRender: boolean;
+    private loadingMesh;
+    private disableMesh;
+    private centerMesh;
+    private ringMesh;
+    private progressMesh;
+    private ringRotateMotion;
+    private tapMotion;
+    private progressMotion;
+    private progressOpacityMotion;
+    private opacityMotion;
+    progress: number;
+    opacity: number;
+    current: boolean;
+    loading: boolean;
+    disabled: boolean;
+    constructor();
+    setProgress(progress: number): void;
+    setOpacity(opacity: number): void;
+    setCurrent(current: boolean): void;
+    setLoading(loading: boolean): void;
+    setDisabled(disabled: boolean): void;
+    tap(): Promise<void>;
+    updateTime(time: number, deltaTime: number): void;
+    dispose(): void;
+}
+
+/**
+ * 地面提示点位接口
+ *
+ * 点位状态
+ *  1. 默认状态: 无任何操作的情况
+ *  2. 高亮状态: 高亮，认为是合适的下一个点位，或者设备选中了某个点位
+ *  3. 进度状态: 点位加载中，存在进度的情况
+ *  4. 加载状态: 点位加载中，不存在进度的情况
+ *  5. 不可用状态：点位不可用，存在点位，但是点位是个摆设
+ *  6. 点击动画： 点位被选择，触发全景图切换
+ *  7. 透明度改变： 一般会处理为近的点位透明度高，远的点位透明度低
+ */
 export declare interface PanoCircleMeshInterface extends THREE_2.Object3D {
     needsRender: boolean;
+    hitTestMesh?: THREE_2.Mesh;
+    /** 当前高亮 */
+    current: boolean;
+    /** 是否当前高亮 */
+    setCurrent(current: boolean): void;
     loading: boolean;
+    setLoading(loading: boolean): void;
     disabled: boolean;
-    panoIndex: number;
-    setLoading(shown: boolean): void;
     setDisabled(disabled: boolean): void;
+    progress: number;
     setProgress(progress: number): void;
+    opacity: number;
     setOpacity(opacity: number): void;
+    updateTime?(time: number, deltaTime: number): void;
+    /** 点击交互 */
+    tap?(): Promise<void>;
     dispose(): void;
 }
 
@@ -1480,6 +1770,13 @@ export declare interface PanoramaControllerCustomInitArgs extends PanoramaLikeCo
     panoTapTriggerRadius?: number;
     /** 地面观察点标识自定义创建器 */
     panoCircleMeshCreator?: () => PanoCircleMeshInterface;
+    /**
+     * 全景瓦片登记
+     * @param fov - 当前 fov
+     * @param viewSize - 当前绘制区域大小
+     * @returns 返回瓦片等级
+     */
+    tileLevelForFov?: false | ((fov: number, viewSize: THREE_2.Vector2) => number);
 }
 
 export declare interface PanoramaLikeControllerCustomInitArgs {
@@ -1507,14 +1804,31 @@ export declare interface PanoramaLikeControllerCustomInitArgs {
     intersectMeshCreator?: () => IntersectMeshInterface;
 }
 
-export declare function parseWork(obj: Work | LooseWork | any): Work;
+/**
+ * 解析 Work 数据
+ * @param obj - work 数据，从如数开发者平台获取
+ * @param options - 配置参数， 可以在此二次设置 baseURL 等参数
+ * @param urlTransform - 配置参数， URL 解析规则
+ * @returns - 签署过的 Work 数据结构
+ */
+export declare function parseWork(obj: Work | LooseWork | string | any, options?: ParseWorkOptions, urlTransform?: (origin: string, absolute: string, relative: string, type: "panorama" | "texture" | "model") => void): Work;
+
+export declare type ParseWorkOptions = {
+    /** 重写 work 中的资源前缀 */
+    baseURL?: string;
+    /** work 中的资源地址使用短地址 */
+    shortPath?: boolean;
+    /** work 中的资源使用 jsonp 方式发布 */
+    jsonp?: boolean;
+    /** work 中模型是否计算bvh碰撞数，默认计算 true */
+    modelBvh?: boolean;
+};
 
 /** PBM 模型组 */
-export declare class PBMGroup extends THREE_2.Group {
-    /** 楼层序号 */
-    floorIndex: number;
+export declare class PBMContainer extends THREE_2.Group {
     /** 是否需要更新按需渲染 */
     needsRender: boolean;
+    private enableTransparent;
     /** 获取是否有透明参数 */
     getTransparent(): boolean;
     /** 设置透明参数 */
@@ -1529,39 +1843,32 @@ export declare class PBMGroup extends THREE_2.Group {
     disposeGeometry(): void;
 }
 
+/** PBM 模型组 */
+export declare class PBMGroup extends PBMContainer {
+    /** 楼层序号 */
+    floorIndex: number;
+}
+
 /** PBM 材质 */
 export declare class PBMMaterial extends THREE_2.ShaderMaterial implements PBMParameters {
-    /** 起始点位全景图 */
-    pano0Map: FiveHashCubeTexture | null;
-    /** 起始点全景图变换矩阵 4x4 */
-    pano0Matrix: THREE_2.Matrix4;
-    /** 结束点位全景图 */
-    pano1Map: FiveHashCubeTexture | null;
-    /** 结束点全景图变换矩阵 4x4 */
-    pano1Matrix: THREE_2.Matrix4;
+    /** 起始点 */
+    pano0: PBMPanoPicture | null;
+    /** 结束点 */
+    pano1: PBMPanoPicture | null;
     /** 模型贴图和全景图的混合程度 [0-1] */
     modelAlpha: number;
     /** 全景图混合程度 [0-1] */
     progress: number;
     /** 全景图通过过度黑色混合 */
     useBlackTransition: boolean;
+    /** XR模式防止申请纹理显存时的黑色过渡 */
+    useXRBlackTransition: boolean;
     perspToOrtho: number;
     /** 模型透明度 */
     opacity: number;
-    /** 起始点位深度, 需要使用深度参与计算全景图混合的话 */
-    pano0DepthMap: THREE_2.CubeTexture | null;
-    /** 全景视频贴图 */
-    panoVideoMap: THREE_2.VideoTexture | null;
-    /** 全景视频尺寸 */
-    panoVideoSize: THREE_2.Vector2;
-    /** 全景视频贴图变换矩阵 */
-    panoVideoMatrix: THREE_2.Matrix4;
-    /** 全景视频透明度 [0-1] */
-    panoVideoAlpha: number;
-    /** 瓦片材质 */
-    panoTileMap: THREE_2.Texture | null;
-    /** 瓦片寻址规则 */
-    panoTileMappings: THREE_2.Vector4[][] | null;
+    originOpacity: number;
+    /** 楼层切割参数*/
+    floorInfo: THREE_2.Vector3 | null;
     constructor(parameters?: Partial<PBMParameters>);
 }
 
@@ -1573,39 +1880,34 @@ export declare class PBMMesh extends THREE_2.Mesh<THREE_2.BufferGeometry, PBMMat
     needsRender: boolean;
 }
 
-/** PBM 材质参数 */
-export declare interface PBMParameters {
+export declare interface PBMPanoPicture {
     /** 起始点位全景图 */
-    pano0Map: FiveHashCubeTexture | null;
+    map: THREE_2.CubeTexture;
+    /** 亮度增益 */
+    luminanceMap: THREE_2.CubeTexture | null;
     /** 起始点全景图变换矩阵 4x4 */
-    pano0Matrix: THREE_2.Matrix4;
-    /** 结束点位全景图 */
-    pano1Map: FiveHashCubeTexture | null;
-    /** 结束点位全景图变换矩阵 */
-    pano1Matrix: THREE_2.Matrix4;
+    matrix: THREE_2.Matrix4;
+}
+
+/** PBM 材质参数 */
+export declare interface PBMParameters {
+    /** 起始点 */
+    pano0: PBMPanoPicture | null;
+    /** 结束点 */
+    pano1: PBMPanoPicture | null;
     /** 模型贴图和全景图的混合程度 [0-1] */
     modelAlpha: number;
     /** 全景图混合程度 [0-1] */
     progress: number;
     /** 全景图通过过度黑色混合 */
     useBlackTransition: boolean;
+    /** XR模式防止申请纹理显存时的黑色过渡 */
+    useXRBlackTransition: boolean;
     perspToOrtho: number;
     /** 模型透明度 */
     opacity: number;
-    /** 起始点位深度, 需要使用深度参与计算全景图混合的话 */
-    pano0DepthMap: THREE_2.CubeTexture | null;
-    /** 全景视频贴图 */
-    panoVideoMap: THREE_2.VideoTexture | null;
-    /** 全景视频尺寸 */
-    panoVideoSize: THREE_2.Vector2;
-    /** 全景视频贴图变换矩阵 */
-    panoVideoMatrix: THREE_2.Matrix4;
-    /** 全景视频透明度 [0-1] */
-    panoVideoAlpha: number;
-    /** 瓦片材质 */
-    panoTileMap: THREE_2.Texture | null;
-    /** 瓦片寻址规则 */
-    panoTileMappings: THREE_2.Vector4[][] | null;
+    /** 楼层切割参数*/
+    floorInfo?: THREE_2.Vector3 | null;
 }
 
 /**
@@ -1613,17 +1915,25 @@ export declare interface PBMParameters {
  * [[include: coordinate.md]]
  */
 export declare interface Pose {
-    /** 相机俯仰角 */
-    longitude: number;
     /** 相机偏航角 */
+    longitude: number;
+    /** 相机俯仰角 */
     latitude: number;
     /** 相机可视角度（垂直）*/
     fov: number;
     /** 相机位置*/
     offset: THREE_2.Vector3;
+    /** 相机距离 */
+    distance: number;
 }
 
-export declare const PROXY_CONTROLLER_EVENT_NAMES: readonly ["cameraDirectionUpdate", "cameraUpdate", "cameraPositionUpdate", "panoSelected", "moveToPano", "moveToPanoCanceled", "panoWillArrive", "movingToPano", "panoArrived", "panoWillLoad", "panoLoaded", "panoLoadError", "initAnimationEnded", "initAnimationWillStart", "wantsGesture", "gesture", "wantsTapGesture", "tapGesture", "wantsPanGesture", "wantsInteriaPan", "panGesture", "interiaPan", "wantsPinchGesture", "pinchGesture", "wantsMouseWheel", "mouseWheel", "wantsShowIntersectionOnModel", "intersectionOnModelUpdate", "intersectionHidden", "textureStartLoad", "textureLoading", "textureAbort", "textureLoaded", "textureError"];
+export declare const PROXY_CONTROLLER_EVENT_NAMES: readonly ["cameraDirectionUpdate", "cameraUpdate", "cameraPositionUpdate", "panoSelected", "moveToPano", "moveToPanoCanceled", "panoWillArrive", "movingToPano", "panoArrived", "panoWillLoad", "panoLoaded", "panoLoadError", "initAnimationEnded", "initAnimationWillStart", "wantsGesture", "gesture", "wantsTapGesture", "tapGesture", "wantsPressGesture", "pressGesture", "wantsPanGesture", "wantsInteriaPan", "panGesture", "interiaPan", "wantsPinchGesture", "pinchGesture", "wantsMouseWheel", "mouseWheel", "wantsShowIntersectionOnModel", "intersectionOnModelUpdate", "intersectionHidden", "textureStartLoad", "textureLoading", "textureAbort", "textureLoaded", "textureError", "webXRSessionStart", "webXRSessionEnd", "webXRSelected"];
+
+/** Five 场景*/
+export declare class Scene extends THREE_2.Scene {
+    add(...objects: AddableObject[]): this;
+    remove(...objects: AddableObject[]): this;
+}
 
 /**
  * 显示区域裁剪参数
@@ -1659,8 +1969,6 @@ export declare interface State extends Pose {
     panoIndex: number;
 }
 
-export declare function stringifyWork(work: Work): LooseWork;
-
 /**
  * 监听者模式
  * @template T - 预设的监听回调类型
@@ -1739,69 +2047,641 @@ export declare namespace SubscribeMixinType {
     }
 }
 
-export declare interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "defaultLongitude" | "defaultLatitude" | "maxLatitude" | "minLatitude"> {
+/**
+ * 图片参数
+ */
+export declare interface TextureOptions {
+    /**
+     * url 地址转化
+     * @param url - 原始地址
+     * @param options - 当前地址参数
+     * @returns 转化后地址
+     */
+    transform?: (url: string, options: ImageURLOptions) => string;
+    /** 图片尺寸参数 尽量使用 2 的幂次 如 256 512 1024 */
+    size?: number;
+    /** 图片质量参数(0-100) */
+    quality?: number;
+    /** 图片格式参数 */
+    format?: "jpg" | "png" | "heif" | "webp" | "avif";
+    /** 针对 textureOptions 是否自动通过模型贴图的数量计算需要的模型贴图的尺寸 默认 true */
+    autoResize?: boolean;
+    /** 锐化参数 海外不支持 */
+    sharpen?: number;
+    mappings?: ImageURLMappings;
 }
 
-export declare interface VRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+/**
+ * A Tile3DHeader represents a tile as Tileset3D. When a tile is first created, its content is not loaded;
+ * the content is loaded on-demand when needed based on the view.
+ * Do not construct this directly, instead access tiles through {@link Tileset3D#tileVisible}.
+ */
+export declare class Tile3D {
+    cacheNode?: TileCacheNode<Tile3D>;
+    tileset: Tileset3D;
+    header: TilesetJSONNode;
+    content?: TileContent;
+    parent?: Tile3D;
+    boundingVolume: TileOrientedBoundingBox;
+    contentState: "UNLOADED" | "LOADING" | "PROCESSING" | "READY" | "FAILED";
+    children: Tile3D[];
+    depth: number;
+    selectionDepth: number;
+    transform: Matrix4;
+    computedTransform: Matrix4;
+    frameNumber: number;
+    touchedFrameNumber: number;
+    requestedFrameNumber: number;
+    selectedFrameNumber: number;
+    distanceToCamera: number;
+    centerZDepth: number;
+    screenSpaceError: number;
+    visibilityPlaneMask: number;
+    visible: boolean;
+    shouldRefine: boolean;
+    /**
+     * @constructs
+     * Create a TileHeader instance
+     * @param tileset - Tileset3D instance
+     * @param header - tile header - JSON loaded from a dataset
+     * @param parentHeader - parent TileHeader instance
+     */
+    constructor(tileset: Tileset3D, header: TilesetJSONNode, parentHeader?: Tile3D);
+    get id(): string;
+    get refine(): "REPLACE" | "ADD";
+    get type(): "EMPTY" | "SCENEGRAPH" | "MESH";
+    get contentUrl(): string;
+    get lodMetricType(): "geometricError";
+    get lodMetricValue(): number;
+    get hasEmptyContent(): boolean;
+    get selected(): boolean;
+    /** Returns true if tile is not an empty tile and not an external tileset */
+    get hasRenderContent(): boolean;
+    /** Returns true if tile has children */
+    get hasChildren(): boolean;
+    /**
+     * Determines if the tile's content is ready. This is automatically `true` for
+     * tiles with empty content.
+     */
+    get contentReady(): boolean;
+    /**
+     * Determines if the tile has available content to render.  `true` if the tile's
+     * content is ready or if it has expired content this renders while new content loads; otherwise,
+     */
+    get contentAvailable(): boolean;
+    /** Returns true if tile has renderable content but it's unloaded */
+    get hasUnloadedContent(): boolean;
+    /**
+     * Determines if the tile's content has not be requested. `true` if tile's
+     * content has not be requested; otherwise, `false`.
+     */
+    get contentUnloaded(): boolean;
+    get contentFailed(): boolean;
+    /** Get the tile's screen space error. */
+    getScreenSpaceError(frameState: TileFrameState, useParentLodMetric: boolean): number;
+    private getPriority;
+    /**
+     *  Requests the tile's content.
+     * The request may not be made if the Request Scheduler can't prioritize it.
+     */
+    loadContent(): Promise<boolean>;
+    unloadContent(): void;
+    /**
+     * Update the tile's visibility
+     */
+    updateVisibility(frameState: TileFrameState): void;
+    private visibility;
+    /**
+     * Computes the (potentially approximate) distance from the closest point of the tile's bounding volume to the camera.
+     * @param frameState - The frame state.
+     * @returns The distance, in meters, or zero if the camera is inside the bounding volume.
+     */
+    private distanceToTile;
+    private updateTransform;
+}
+
+export declare class Tile3DModel extends PBMContainer {
+    tileset?: Tileset3D;
+    private options;
+    private nodeGroup;
+    private boundingGroup;
+    private nodes;
+    private boundings;
+    private unloadTileQueue;
+    private timer;
+    private clock;
+    private lastCameraTransform;
+    private lastCameraAspect;
+    private lastCameraFov;
+    private sseDenominator;
+    private lastCamera;
+    private lastRenderer;
+    private enabled;
+    constructor(loaderOptions?: Partial<Tile3DModelLoaderOptions>);
+    get enable(): boolean;
+    set enable(value: boolean);
+    load(url: WorkModelTiles): void;
+    update(renderer: THREE_2.WebGLRenderer, camera: THREE_2.PerspectiveCamera): void;
+    private tilesetUpdate;
+    reset(): void;
+}
+
+/** Advanced loader options */
+export declare interface Tile3DModelLoaderOptions {
+    updateInterval: number;
+    maxMemoryUsage: number;
+    maxScreenSpaceError: number;
+    viewDistanceScale: number;
+    throttleRequests: boolean;
+    maxRequests: number;
+    onNodeCreated: (node: PBMGroup) => void;
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string;
+    networkSubscribe?: NetworkSubscribe;
+    maxDepth?: number;
+}
+
+export declare class TileBoundingSphere {
+    center: Vector3;
+    radius: number;
+    constructor(center?: number[], radius?: number);
+    fromCenterRadius(center: number[], radius: number): this;
+    fromCornerPoints(corner: number[], oppositeCorner: number[]): this;
+    equals(right: TileBoundingSphere): boolean;
+    clone(): TileBoundingSphere;
+    union(boundingSphere: TileBoundingSphere): TileBoundingSphere;
+    expand(point: number[]): this;
+    transform(transform: Matrix4): this;
+    distanceSquaredTo(point: number[]): number;
+    distanceTo(point: number[]): number;
+    intersectPlane(plane: TilePlane): number;
+}
+
+export declare interface TileBoundingVolume {
     /**
-     * webvrPolyfill 的设置对象
-     * @description
-     * 只可被设置一次，所有的 five 实例共用这个设置
+     * Applies a 4x4 affine transformation matrix to a bounding sphere.
+     * @param sphere - The bounding sphere to apply the transformation to.
+     * @param transform - The transformation matrix to apply to the bounding sphere.
+     * @returns itself, i.e. the modified BoundingVolume.
+     */
+    transform(transform: readonly number[]): this;
+    /** Computes the estimated distance squared from the closest point on a bounding sphere to a point. */
+    distanceSquaredTo(point: readonly number[]): number;
+    /** Computes the estimated distance from the closest point on a bounding sphere to a point. */
+    distanceTo(point: readonly number[]): number;
+    /**
+     * Determines which side of a plane the oriented bounding box is located.
+     *
+     * @param plane - The plane to test against.
+     * @returns
+     *  - `INTERSECTION.INSIDE` if the entire box is on the side of the plane the normal is pointing.
+     *  - `INTERSECTION.OUTSIDE` if the entire box is on the opposite side.
+     *  - `INTERSECTION.INTERSECTING` if the box intersects the plane.
      */
-    webvrPolyfillConfig?: any;
+    intersectPlane(plane: TilePlane): number;
+}
+
+export declare class TileCacheNode<T> {
+    item: T;
+    previous: TileCacheNode<T> | null;
+    next: TileCacheNode<T> | null;
+    constructor(item: T, previous: TileCacheNode<T> | null, next: TileCacheNode<T> | null);
+}
+
+export declare interface TileContent {
+    version: 1;
+    magic: number;
+    byteLength: number;
+    header: {
+        featureTableJsonByteLength: number;
+        featureTableBinaryByteLength: number;
+        batchTableJsonByteLength: number;
+        batchTableBinaryByteLength: number;
+        batchLength: number;
+    };
+    featureTableJson: Record<string, any>;
+    featureTableBinary: Uint8Array;
+    batchTableJson: Record<string, any>;
+    batchTableBinary: Uint8Array;
+    rotateYtoZ: boolean;
+    gltfUpAxis: "X" | "Y" | "Z";
+    gltfArrayBuffer: ArrayBuffer;
+    gltfByteOffset: number;
+    gltfByteLength: number;
+    rtcCenter?: Float32Array;
+}
+
+export declare class TileCullingVolume {
+    static get MASK_OUTSIDE(): number;
+    static get MASK_INSIDE(): number;
+    static get MASK_INDETERMINATE(): number;
+    planes: TilePlane[];
+    constructor(planes?: TilePlane[]);
+    fromBoundingSphere(boundingSphere: {
+        center: Vector3;
+        radius: number;
+    }): this;
+    computeVisibilityWithPlaneMask(boundingVolume: TileBoundingVolume, parentPlaneMask: number): number;
+}
+
+export declare type TileFrameState = {
+    camera: {
+        position: number[];
+        direction: number[];
+        up: number[];
+    };
+    height: number;
+    cullingVolume: TileCullingVolume;
+    frameNumber: number;
+    sseDenominator: number;
+};
+
+export declare class TileOrientedBoundingBox {
+    center: Vector3;
+    halfAxes: Matrix3;
+    constructor(center?: number[], halfAxes?: number[]);
+    get halfSize(): number[];
+    get quaternion(): Quaternion;
+    fromCenterHalfSizeQuaternion(center: number[], halfSize: number[], quaternion: number[]): this;
+    clone(): TileOrientedBoundingBox;
+    equals(right: TileOrientedBoundingBox): boolean;
+    getBoundingSphere(result?: TileBoundingSphere): TileBoundingSphere;
+    intersectPlane(plane: TilePlane): number;
+    distanceTo(point: number[]): number;
+    distanceSquaredTo(point: number[]): number;
+    computePlaneDistances(position: Vector3, direction: Vector3, result?: number[]): number[];
+    transform(transformation: number[]): this;
+}
+
+export declare class TilePlane {
+    normal: Vector3;
+    distance: number;
+    constructor(normal?: number[], distance?: number);
+    fromNormalDistance(normal: number[], distance: number): this;
+    fromPointNormal(point: number[], normal: number[]): this;
+    fromCoefficients(a: number, b: number, c: number, d: number): this;
+    clone(): TilePlane;
+    equals(right: TilePlane): boolean;
+    getPointDistance(point: number[]): number;
+    transform(matrix4: Matrix4): this;
+    projectPointOntoPlane(point: number[], result?: number[]): Vector3;
+}
+
+/** Tracks one request */
+export declare type TileRequest<Identiy> = {
+    identiy: Identiy;
+    priority: number;
+    getPriority: (identiy: Identiy) => number;
+    resolve: (requestResult: TileRequestResult) => void;
+};
+
+export declare type TileRequestResult = null | {
+    done: () => void;
+};
+
+/**
+ * Used to issue a request, without having them "deeply queued" by the browser.
+ * @todo - Track requests globally, across multiple servers
+ */
+export declare class TileRequestScheduler<Identiy> {
+    private props;
+    private activeRequestCount;
+    /** Tracks the number of active requests and prioritizes/cancels queued requests. */
+    private requestQueue;
+    private requestMap;
+    private deferred;
+    constructor(props?: TileRequestSchedulerOptions);
+    /**
+     * Called by an application that wants to issue a request, without having it deeply queued by the browser
+     *
+     * When the returned promise resolved, it is OK for the application to issue a request.
+     * The promise resolves to an object that contains a `done` method.
+     * When the application's request has completed (or failed), the application must call the `done` function
+     *
+     * @param identiy - Identiy
+     * @param getPriority - will be called when request "slots" open up, allowing the caller to update priority or cancel the request Highest priority executes first, priority less than 0 cancels the request
+     * @returns a promise resolves to a object (with a `done` field) when the request can be issued without queueing, resolves to `null` if the request has been cancelled (by the callback return less than 0). In this case the application should not issue the request
+     */
+    scheduleRequest(identiy: Identiy, getPriority?: (identiy: Identiy) => number): Promise<TileRequestResult>;
+    private issueRequest;
+    /** We check requests asynchronously, to prevent multiple updates */
+    private issueNewRequests;
+    /** Refresh all requests  */
+    private issueNewRequestsAsync;
+    /** Ensure all requests have updated priorities, and that no longer valid requests are cancelled */
+    private updateAllRequests;
+    /** Update a single request by calling the callback */
+    private updateRequest;
+}
+
+/** RequestScheduler Options */
+export declare type TileRequestSchedulerOptions = {
+    throttleRequests?: boolean;
+    maxRequests?: number;
+};
+
+export declare class Tileset3D {
+    rawJson: any;
+    options: Tileset3dOptions;
+    root: Tile3D;
+    traverser: Tileset3DTraverser;
+    cache: TilesetCache;
+    requestScheduler: TileRequestScheduler<string>;
+    selectedTiles: Tile3D[];
+    requestedTiles: Tile3D[];
+    memoryUsageInBytes: number;
+    frameNumber: number;
+    private _tiles;
+    private pendingCount;
+    b3dmMapping: TilesetJSON['b3dmMapping'];
+    /**
+     * Create a new Tileset3D
+     * @param json - TilesetJSON
+     * @param options - Tileset3dOptions
+     */
+    constructor(json: TilesetJSON, options: Tileset3dOptions);
+    get maxMemoryUsage(): number;
+    get asset(): any;
+    get type(): any;
+    get basePath(): any;
+    get modelMatrix(): Matrix4;
+    get geometricError(): number;
+    get lodMetricType(): number;
+    get lodMetricValue(): number;
+    get refine(): 'ADD' | "REPLACE";
+    get tiles(): Tile3D[];
+    get floorInfo(): TilesetJSON['floorInfo'];
+    /** Release resources */
+    reset(): void;
+    /** Is the tileset loaded (update needs to have been called at least once) */
+    isLoaded(): boolean;
+    /**
+     * The callback to post-process tiles after traversal procedure
+     * @param frameState - frame state for tile culling
+     */
+    private onTraversalEnd;
+    loadTile(tile: Tile3D): void;
+    unloadTile(tile: Tile3D): void;
+}
+
+export declare interface Tileset3dOptions {
+    throttleRequests: boolean;
+    maxRequests: number;
+    maxMemoryUsage: number;
+    modelMatrix: Matrix4;
+    maxScreenSpaceError: number;
+    viewDistanceScale: number;
+    onTileLoad: (tile: Tile3D) => any;
+    onTileUnload: (tile: Tile3D) => any;
+    onTileError: (tile: Tile3D, message: string) => any;
+    contentLoader: (tile: Tile3D) => Promise<void>;
+    onTraversalComplete: (selectedTiles: Tile3D[]) => Tile3D[];
+    allowHosts?: string[];
+    requestProxy?: (url: string) => string;
+    networkSubscribe?: NetworkSubscribe;
+    maxDepth?: number;
+}
+
+export declare class Tileset3DTraverser {
+    root: Tile3D | null;
+    options: TilesetTraverserProps;
+    requestedTiles: Record<string, Tile3D>;
+    selectedTiles: Record<string, Tile3D>;
+    emptyTiles: Record<string, Tile3D>;
+    private _traversalStack;
+    private _emptyTraversalStack;
+    private _frameNumber;
+    constructor(options: TilesetTraverserProps);
+    traverse(root: Tile3D, frameState: TileFrameState): void;
+    reset(): void;
+    private executeTraversal;
+    private updateChildTiles;
+    private updateAndPushChildren;
+    updateTile(tile: Tile3D, frameState: TileFrameState): void;
+    selectTile(tile: Tile3D, frameState: TileFrameState): void;
+    loadTile(tile: Tile3D, frameState: TileFrameState): void;
+    touchTile(tile: Tile3D, frameState: TileFrameState): void;
+    private canTraverse;
+    private shouldLoadTile;
+    private shouldSelectTile;
+    private shouldRefine;
+    private updateTileVisibility;
+    private meetsScreenSpaceErrorEarly;
+    private compareDistanceToCamera;
+    private anyChildrenVisible;
+    private everyChildrenVisibleIsLoaded;
+    private executeEmptyTraversal;
+}
+
+export declare class TilesetCache {
+    private list;
+    private sentinel;
+    constructor();
+    reset(): void;
+    touch(tile: Tile3D): void;
+    add(tile: Tile3D, addCallback?: (tile: Tile3D) => void): void;
+    unloadTile(tile: Tile3D, unloadCallback?: (tile: Tile3D) => void): void;
+    unloadTiles(isOverMemory: () => boolean, unloadCallback?: (tile: Tile3D) => void): void;
+}
+
+export declare interface TilesetJSON {
+    asset: {
+        gltfUpAxis: "X" | "Y" | "Z";
+        version: "1.0";
+    };
+    basePath: string;
+    lodMetricType: "geometricError";
+    geometricError: number;
+    lodMetricValue: number;
+    root: TilesetJSONNode;
+    type: "TILES3D";
+    floorInfo: {
+        ground: number;
+        height: number;
+    }[];
+    b3dmMapping: {
+        b3dm_base_url: string;
+        b3dm_url: Record<string, string>;
+    };
 }
 
-export declare type Work = {
-    uuid: string;
+export declare interface TilesetJSONNode {
+    boundingVolume: {
+        box: number[];
+    };
+    content: {
+        uri: string;
+    };
+    id: string;
+    transform?: number[];
+    contentUrl?: string;
+    children: TilesetJSONNode[];
+    lodMetricType: "geometricError";
+    geometricError: number;
+    lodMetricValue: number;
+    refine: "REPLACE" | "ADD";
+    type: "EMPTY" | "SCENEGRAPH" | "MESH";
+}
+
+export declare type TilesetTraverserProps = {
+    loadSiblings: boolean;
+    skipLevelOfDetail: boolean;
+    maxScreenSpaceError: number;
+    maxDepth?: number;
+    onTraversalEnd: (frameState: TileFrameState) => any;
+};
+
+export declare interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "defaultLongitude" | "defaultLatitude" | "maxLatitude" | "minLatitude"> {
+}
+
+export declare interface VRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
+
+export declare type WebXREventTypes = {
+    /** WebXR模式开始，session完成坐标系设置*/
+    webXRSessionStart(): void;
+    /** WebXR模式结束，销毁session*/
+    webXRSessionEnd(): void;
+};
+
+export declare type WebXRSelectType = "Select" | "Squeeze";
+
+export declare class Work {
+    /** 名称 */
+    name: string;
+    /** 编号 */
+    workCode: string;
+    /** 允许访问的安全域名 */
+    allowHosts: string[];
+    /** 过期时间 */
+    expire: Date;
+    /** 初始化参数 */
     initial: WorkInitial;
+    /** 模型参数 */
     model?: WorkModel;
+    /** 全景点位信息 */
     observers: WorkObserver[];
-};
+    /** 数据签发人 */
+    issuer: string;
+    /** 原始数据 */
+    raw: {
+        works: string[];
+        options: string;
+    };
+    /**
+     * 解析 Work 数据
+     * @param obj - work 数据，从如数开发者平台获取
+     * @param options - 配置参数， 可以在此二次设置 baseURL 等参数
+     * @param urlTransform - 配置参数， URL 解析规则
+     * @returns - 签署过的 Work 数据结构
+     */
+    static parse: typeof parseWork;
+    constructor();
+    toJSON(): any;
+}
 
-/** 全景图 */
-export declare type WorkImages = {
+export declare interface WorkCubeImage {
+    /** 全景图 up */
     up: string;
+    /** 全景图 down */
     down: string;
+    /** 全景图 right */
     right: string;
+    /** 全景图 left */
     left: string;
+    /** 全景图 front */
     front: string;
+    /** 全景图 back */
     back: string;
+}
+
+/** 全景图 */
+export declare interface WorkImage extends WorkCubeImage {
+    /** 深度图 */
     depth?: string;
-    tiles?: string;
-};
+    /** 光照强度图 */
+    luminance?: WorkCubeImage;
+    /** 瓦片信息 */
+    tiles?: WorkTile[];
+}
 
 /** 初始化位姿参数 */
-export declare type WorkInitial = Omit<State, "offset">;
+export declare interface WorkInitial extends Omit<State, "offset" | "distance"> {
+}
 
 /** 模型数据 */
-export declare type WorkModel = {
+export declare interface WorkModel {
+    /** 模型文件地址 at3d / domez */
     file: string;
+    /** 模型贴图文件地址 */
     textures: string[];
+    /** 模型贴图文件地址的父目录 */
     textureBase: string;
+    /** 是否开启 bvh 碰撞树，开启会大大加快射线碰撞的执行效率 */
     bvh: boolean;
-    async: boolean;
-};
+    tiles?: WorkModelTiles;
+}
+
+/** 模型瓦片 */
+export declare interface WorkModelTiles {
+    tileset_url: string;
+    tileset_url_md5: string;
+    b3md_mappings_url: string;
+    b3md_mappings_url_md5: string;
+}
 
 /** 每个点位的数据 */
-export declare type WorkObserver = {
+export declare interface WorkObserver {
+    /** 点位序号 */
     panoIndex: number;
+    /** 点位是否激活可用 */
     active: boolean;
+    /** 点位是否可加载 */
     loadable: boolean;
-    images: WorkImages;
+    /** 点位全景图 */
+    images: WorkImage;
+    /** 点位视频 */
     video?: WorkVideo;
+    /** 可以看到的相关点位序号 */
     visibleNodes: number[];
+    /** 可以连通的相关点位序号 */
     accessibleNodes: number[];
+    /** 点位和模型的旋转对齐关系四元数 */
     quaternion: THREE_2.Quaternion;
+    /** 点位和模型的地面位置坐标关系 */
     standingPosition: THREE_2.Vector3;
+    /** 点位和模型的观察点坐标关系 */
     position: THREE_2.Vector3;
+    /** 点位所在楼层 */
     floorIndex: number;
-};
+}
+
+export declare interface WorkTile {
+    level: number;
+    size: number;
+    up: string;
+    down: string;
+    right: string;
+    left: string;
+    front: string;
+    back: string;
+}
 
 /** 全景视频贴片 */
-export declare type WorkVideo = {
+export declare interface WorkVideo {
+    /** 视频源 url */
     source: string;
+    /** 视频源变化矩阵 */
     matrix: THREE_2.Matrix4;
+    /** 视频源长宽尺寸 */
     size: THREE_2.Vector2;
-};
+}
+
+export declare class XRButton {
+    static createButton(onClickHook: () => void): HTMLAnchorElement | HTMLButtonElement;
+}
+
+export declare interface XRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
 
 export { }