@realsee/five 5.0.0-alpha.132 → 5.0.0-alpha.136

package/five/index.d.ts

@@ -11,7 +11,7 @@ export declare interface AddableObject extends THREE_2.Object3D {
 }
 
 export declare interface AnimationFrame {
-    callback: (time: number, deltaTime: number) => void;
+    callback: (time: number, deltaTime: number, ...args: any[]) => void;
     once: boolean;
     delay: number;
     order: number;
@@ -21,11 +21,17 @@ 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;
     /**
      * 添加到动画循环
@@ -39,51 +45,6 @@ export declare class AnimationFrameLoop {
     disponse(): void;
 }
 
-declare interface B3DMMapping {
-    b3dm_base_url: string;
-    b3dm_url: Record<string, string>;
-}
-
-declare class BoundingSphere {
-    center: Vector3;
-    radius: number;
-    constructor(center?: number[], radius?: number);
-    fromCenterRadius(center: number[], radius: number): this;
-    fromCornerPoints(corner: number[], oppositeCorner: number[]): this;
-    equals(right: BoundingSphere): boolean;
-    clone(): BoundingSphere;
-    union(boundingSphere: BoundingSphere): BoundingSphere;
-    expand(point: number[]): this;
-    transform(transform: Matrix4): this;
-    distanceSquaredTo(point: number[]): number;
-    distanceTo(point: number[]): number;
-    intersectPlane(plane: Plane): number;
-}
-
-declare interface BoundingVolume {
-    /**
-     * 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.
-     */
-    intersectPlane(plane: Plane): number;
-}
-
 export declare class BVH {
     trianglesArray?: Float32Array;
     offsetArray?: Uint32Array;
@@ -140,13 +101,6 @@ export declare class BVHVector3 {
     clone(): BVHVector3;
 }
 
-declare class CacheNode<T> {
-    item: T;
-    previous: CacheNode<T> | null;
-    next: CacheNode<T> | null;
-    constructor(item: T, previous: CacheNode<T> | null, next: CacheNode<T> | null);
-}
-
 /** Five 相机 */
 export declare class Camera extends THREE_2.PerspectiveCamera {
     /** 相机姿态 */
@@ -176,6 +130,7 @@ export declare type ControllerCustomInitTypes = {
     Model: ModelControllerCustomInitArgs;
     DepthPanorama: DepthPanoramaControllerCustomInitArgs;
     Mapview: MapviewControllerCustomInitArgs;
+    XRPanorama: XRPanoramaControllerCustomInitArgs;
 };
 
 export declare type ControllerEventTypes = {
@@ -463,22 +418,16 @@ export declare type ControllerEventTypes = {
      * @param error - 抛出错误
      */
     error(error: Error): void;
+    /**
+     * webXR模式开始，webxr session完成坐标系矫正
+     */
+    webXRSessionStart(): void;
+    /**
+     * webXR模式结束,webxr session销毁
+     */
+    webXRSessionEnd(): void;
 };
 
-declare class CullingVolume {
-    static get MASK_OUTSIDE(): number;
-    static get MASK_INSIDE(): number;
-    static get MASK_INDETERMINATE(): number;
-    planes: Plane[];
-    constructor(planes?: Plane[]);
-    fromBoundingSphere(boundingSphere: {
-        center: Vector3;
-        radius: number;
-    }): this;
-    computeVisibility(boundingVolume: BoundingVolume): number;
-    computeVisibilityWithPlaneMask(boundingVolume: BoundingVolume, parentPlaneMask: number): number;
-}
-
 /**
  * URL 地址的转换
  * @param source - url 原地址
@@ -641,8 +590,9 @@ 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 - 帮助元素的是否开启
@@ -683,6 +633,7 @@ export declare class Five extends Subscribe<EventTypes> {
      * Topview 户型图模式
      * DepthPanorama 深度图游走模式
      * VRPanorama VR眼镜模式
+     * XRPanorama VR硬件模式
      * ```
      */
     static Mode: Mirror<Mode>;
@@ -978,7 +929,7 @@ export declare class Five extends Subscribe<EventTypes> {
      * @param callback - 渲染完成回调
      */
     render(callback?: () => void, updateObjectResolution?: boolean): THREE_2.WebGLRenderTarget;
-    updateTime(time: number, deltaTime: number): void;
+    updateTime(time: number, deltaTime: number, ...args: any[]): void;
     /**
      * 但停自动播放
      */
@@ -1037,8 +988,17 @@ export declare class Five extends Subscribe<EventTypes> {
     setState(state: Partial<State>, immediately?: boolean, userAction?: boolean): void;
     aroundScissor(callback: () => void): void;
     private syncState;
+    /**
+     * 当前页面静态
+     */
     ready(): Promise<void>;
+    /**
+     * 请求全屏
+     */
     requestFullscreen(): void;
+    /**
+     * 退出全屏
+     */
     exitFullscreen(): void;
     private throwError;
     private loadModel;
@@ -1188,6 +1148,8 @@ export declare interface FiveInitArgs {
     depthPanorama?: ControllerCustomInitTypes["DepthPanorama"];
     /** VR眼镜模式下的特定参数 */
     vrPanorama?: ControllerCustomInitTypes["VRPanorama"];
+    /** XR眼镜模式下的特定参数 */
+    xrPanorama?: ControllerCustomInitTypes["XRPanorama"];
     /**
      * 模式间切换时的过度动画时间
      * @description
@@ -1244,11 +1206,6 @@ parameters: Parameters<T>[1]
  */
 export declare type FivePluginInstance<T extends FivePlugin<any, any>> = ReturnType<T>;
 
-declare interface FloorInfo {
-    ground: number;
-    height: number;
-}
-
 export declare interface FloorplanControllerCustomInitArgs {
     /** 默认偏航角 */
     defaultLongitude?: number;
@@ -1266,18 +1223,6 @@ export declare interface FloorplanControllerCustomInitArgs {
     minFov?: number;
 }
 
-declare type FrameState = {
-    camera: {
-        position: number[];
-        direction: number[];
-        up: number[];
-    };
-    height: number;
-    cullingVolume: CullingVolume;
-    frameNumber: number;
-    sseDenominator: number;
-};
-
 export declare type GestureTypes = "pan" | "tap" | "pinch" | "press" | "mouseWheel";
 
 export declare function getViewportScale(): number;
@@ -1395,21 +1340,6 @@ export declare class LegacyPanoCircleMesh extends THREE_2.Object3D implements Pa
     dispose(): void;
 }
 
-/** Advanced loader options */
-declare interface LoaderOptions {
-    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 type LooseWork = {
     bvh?: boolean;
     modelAsync?: boolean;
@@ -1484,48 +1414,6 @@ export declare type LooseWorkVideo = {
     size: number[];
 };
 
-declare class ManagedArray<T> {
-    private map;
-    private array;
-    private _length;
-    constructor();
-    /**
-     * Gets or sets the length of the array.
-     * If the set length is greater than the length of the internal array, the internal array is resized.
-     *
-     * @memberof ManagedArray.prototype
-     * @type Number
-     */
-    get length(): number;
-    /**
-     * Gets the element at an index.
-     * @param { Number } index The index to get.
-     */
-    get(index: number): T;
-    /**
-     * Sets the element at an index. Resizes the array if index is greater than the length of the array.
-     *
-     * @param {Number} index The index to set.
-     * @param {*} element The element to set at index.
-     */
-    set(index: number, element: T): void;
-    delete(element: T): void;
-    /**
-     * Push an element into the array.
-     *
-     * @param {*} element The element to push.
-     */
-    push(element: T): void;
-    /**
-     * Pop an element from the array.
-     *
-     * @returns {*} The last element in the array.
-     */
-    pop(): T;
-    reset(): void;
-    find(target: T): boolean;
-}
-
 export declare interface MapviewControllerCustomInitArgs {
     /** 默认偏航角 */
     defaultLongitude?: number;
@@ -1569,7 +1457,9 @@ export declare type Mode =
 /** 模型游走模式 */
 "Model" | 
 /** 深度图游走模式 */
-"DepthPanorama";
+"DepthPanorama" | 
+/** XR眼镜模式*/
+"XRPanorama";
 
 /**
  * Five 模型
@@ -1800,23 +1690,6 @@ export declare class NetworkSubscribe extends Subscribe<{
 
 export declare type NetworkType = "XMLHttpRequest" | "Script" | "Image" | "Link";
 
-declare class OrientedBoundingBox {
-    center: Vector3;
-    halfAxes: Matrix3;
-    constructor(center?: number[], halfAxes?: number[]);
-    get halfSize(): number[];
-    get quaternion(): Quaternion;
-    fromCenterHalfSizeQuaternion(center: number[], halfSize: number[], quaternion: number[]): this;
-    clone(): OrientedBoundingBox;
-    equals(right: OrientedBoundingBox): boolean;
-    getBoundingSphere(result?: BoundingSphere): BoundingSphere;
-    intersectPlane(plane: Plane): number;
-    distanceTo(point: number[]): number;
-    distanceSquaredTo(point: number[]): number;
-    computePlaneDistances(position: Vector3, direction: Vector3, result?: number[]): number[];
-    transform(transformation: number[]): this;
-}
-
 export declare class PanoCircleMesh extends THREE_2.Object3D implements PanoCircleMeshInterface {
     needsRender: boolean;
     private loadingMesh;
@@ -1981,6 +1854,8 @@ export declare class PBMMaterial extends THREE_2.ShaderMaterial implements PBMPa
     progress: number;
     /** 全景图通过过度黑色混合 */
     useBlackTransition: boolean;
+    /** XR模式防止申请纹理显存时的黑色过渡 */
+    useXRBlackTransition: boolean;
     perspToOrtho: number;
     /** 模型透明度 */
     opacity: number;
@@ -2019,6 +1894,8 @@ export declare interface PBMParameters {
     progress: number;
     /** 全景图通过过度黑色混合 */
     useBlackTransition: boolean;
+    /** XR模式防止申请纹理显存时的黑色过渡 */
+    useXRBlackTransition: boolean;
     perspToOrtho: number;
     /** 模型透明度 */
     opacity: number;
@@ -2026,20 +1903,6 @@ export declare interface PBMParameters {
     floorInfo?: THREE_2.Vector3 | null;
 }
 
-declare class Plane {
-    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(): Plane;
-    equals(right: Plane): boolean;
-    getPointDistance(point: number[]): number;
-    transform(matrix4: Matrix4): this;
-    projectPointOntoPlane(point: number[], result?: number[]): Vector3;
-}
-
 /**
  * 相机位姿
  * [[include: coordinate.md]]
@@ -2057,57 +1920,7 @@ export declare interface Pose {
     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", "wantsPressGesture", "pressGesture", "wantsPanGesture", "wantsInteriaPan", "panGesture", "interiaPan", "wantsPinchGesture", "pinchGesture", "wantsMouseWheel", "mouseWheel", "wantsShowIntersectionOnModel", "intersectionOnModelUpdate", "intersectionHidden", "textureStartLoad", "textureLoading", "textureAbort", "textureLoaded", "textureError"];
-
-declare type RequestResult = null | {
-    done: () => void;
-};
-
-/**
- * Used to issue a request, without having them "deeply queued" by the browser.
- * @todo - Track requests globally, across multiple servers
- */
-declare class RequestScheduler<Identiy> {
-    private props;
-    private activeRequestCount;
-    /** Tracks the number of active requests and prioritizes/cancels queued requests. */
-    private requestQueue;
-    private requestMap;
-    private deferred;
-    constructor(props?: RequestSchedulerOptions);
-    /**
-     * 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
-     * @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 < 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 < 0).
-     *     In this case the application should not issue the request
-     */
-    scheduleRequest(identiy: Identiy, getPriority?: (identiy: Identiy) => number): Promise<RequestResult>;
-    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 */
-declare type RequestSchedulerOptions = {
-    throttleRequests?: boolean;
-    maxRequests?: 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", "wantsPressGesture", "pressGesture", "wantsPanGesture", "wantsInteriaPan", "panGesture", "interiaPan", "wantsPinchGesture", "pinchGesture", "wantsMouseWheel", "mouseWheel", "wantsShowIntersectionOnModel", "intersectionOnModelUpdate", "intersectionHidden", "textureStartLoad", "textureLoading", "textureAbort", "textureLoaded", "textureError", "webXRSessionStart", "webXRSessionEnd"];
 
 /** Five 场景*/
 export declare class Scene extends THREE_2.Scene {
@@ -2256,13 +2069,13 @@ export declare interface TextureOptions {
  * the content is loaded on-demand when needed based on the view.
  * Do not construct this directly, instead access tiles through {@link Tileset3D#tileVisible}.
  */
-declare class Tile3D {
-    cacheNode?: CacheNode<Tile3D>;
+export declare class Tile3D {
+    cacheNode?: TileCacheNode<Tile3D>;
     tileset: Tileset3D;
     header: TilesetJSONNode;
     content?: TileContent;
     parent?: Tile3D;
-    boundingVolume: OrientedBoundingBox;
+    boundingVolume: TileOrientedBoundingBox;
     contentState: "UNLOADED" | "LOADING" | "PROCESSING" | "READY" | "FAILED";
     children: Tile3D[];
     depth: number;
@@ -2318,8 +2131,8 @@ declare class Tile3D {
     get contentUnloaded(): boolean;
     get contentFailed(): boolean;
     /** Get the tile's screen space error. */
-    getScreenSpaceError(frameState: FrameState, useParentLodMetric: boolean): number;
-    getPriority(): number;
+    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.
@@ -2329,15 +2142,15 @@ declare class Tile3D {
     /**
      * Update the tile's visibility
      */
-    updateVisibility(frameState: FrameState): void;
-    visibility(frameState: FrameState, parentVisibilityPlaneMask: number): number;
+    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 {Number} The distance, in meters, or zero if the camera is inside the bounding volume.
+     * @param frameState - The frame state.
+     * @returns The distance, in meters, or zero if the camera is inside the bounding volume.
      */
-    distanceToTile(frameState: FrameState): number;
-    updateTransform(parentTransform?: Matrix4): void;
+    private distanceToTile;
+    private updateTransform;
 }
 
 export declare class Tile3DModel extends PBMContainer {
@@ -2357,16 +2170,78 @@ export declare class Tile3DModel extends PBMContainer {
     private lastCamera;
     private lastRenderer;
     private enabled;
-    constructor(loaderOptions?: Partial<LoaderOptions>);
+    constructor(loaderOptions?: Partial<Tile3DModelLoaderOptions>);
     get enable(): boolean;
     set enable(value: boolean);
-    load(url: WorkModelTiles_2): void;
+    load(url: WorkModelTiles): void;
     update(renderer: THREE_2.WebGLRenderer, camera: THREE_2.PerspectiveCamera): void;
     private tilesetUpdate;
     reset(): void;
 }
 
-declare interface TileContent {
+/** 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 {
+    /**
+     * 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.
+     */
+    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;
@@ -2389,24 +2264,133 @@ declare interface TileContent {
     rtcCenter?: Float32Array;
 }
 
-declare class Tileset3D {
+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: RequestScheduler<string>;
+    requestScheduler: TileRequestScheduler<string>;
     selectedTiles: Tile3D[];
     requestedTiles: Tile3D[];
     memoryUsageInBytes: number;
     frameNumber: number;
     private _tiles;
     private pendingCount;
-    b3dmMapping: B3DMMapping;
+    b3dmMapping: TilesetJSON['b3dmMapping'];
     /**
      * Create a new Tileset3D
-     * @param json
-     * @param options
+     * @param json - TilesetJSON
+     * @param options - Tileset3dOptions
      */
     constructor(json: TilesetJSON, options: Tileset3dOptions);
     get maxMemoryUsage(): number;
@@ -2419,7 +2403,7 @@ declare class Tileset3D {
     get lodMetricValue(): number;
     get refine(): 'ADD' | "REPLACE";
     get tiles(): Tile3D[];
-    get floorInfo(): FloorInfo[];
+    get floorInfo(): TilesetJSON['floorInfo'];
     /** Release resources */
     reset(): void;
     /** Is the tileset loaded (update needs to have been called at least once) */
@@ -2433,7 +2417,7 @@ declare class Tileset3D {
     unloadTile(tile: Tile3D): void;
 }
 
-declare interface Tileset3dOptions {
+export declare interface Tileset3dOptions {
     throttleRequests: boolean;
     maxRequests: number;
     maxMemoryUsage: number;
@@ -2451,38 +2435,38 @@ declare interface Tileset3dOptions {
     maxDepth?: number;
 }
 
-declare class Tileset3DTraverser {
+export declare class Tileset3DTraverser {
     root: Tile3D | null;
     options: TilesetTraverserProps;
     requestedTiles: Record<string, Tile3D>;
     selectedTiles: Record<string, Tile3D>;
     emptyTiles: Record<string, Tile3D>;
-    protected _traversalStack: ManagedArray<Tile3D>;
-    protected _emptyTraversalStack: ManagedArray<Tile3D>;
-    protected _frameNumber: number | null;
+    private _traversalStack;
+    private _emptyTraversalStack;
+    private _frameNumber;
     constructor(options: TilesetTraverserProps);
-    traverse(root: Tile3D, frameState: FrameState): void;
+    traverse(root: Tile3D, frameState: TileFrameState): void;
     reset(): void;
-    executeTraversal(root: Tile3D, frameState: FrameState): void;
-    updateChildTiles(tile: Tile3D, frameState: FrameState): boolean;
-    updateAndPushChildren(tile: Tile3D, frameState: FrameState, stack: ManagedArray<Tile3D>, depth: number): boolean;
-    updateTile(tile: Tile3D, frameState: FrameState): void;
-    selectTile(tile: Tile3D, frameState: FrameState): void;
-    loadTile(tile: Tile3D, frameState: FrameState): void;
-    touchTile(tile: Tile3D, frameState: FrameState): void;
-    canTraverse(tile: Tile3D, frameState: FrameState, useParentMetric?: boolean, ignoreVisibility?: boolean): boolean;
-    shouldLoadTile(tile: Tile3D): boolean;
-    shouldSelectTile(tile: Tile3D): boolean;
-    shouldRefine(tile: Tile3D, frameState: FrameState, useParentMetric: boolean): boolean;
-    updateTileVisibility(tile: Tile3D, frameState: FrameState): void;
-    meetsScreenSpaceErrorEarly(tile: Tile3D, frameState: FrameState): boolean;
-    compareDistanceToCamera(a: Tile3D, b: Tile3D): number;
-    anyChildrenVisible(tile: Tile3D, frameState: FrameState): boolean;
-    everyChildrenVisibleIsLoaded(tile: Tile3D): boolean;
-    executeEmptyTraversal(root: Tile3D, frameState: FrameState): boolean;
-}
-
-declare class TilesetCache {
+    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();
@@ -2493,7 +2477,7 @@ declare class TilesetCache {
     unloadTiles(isOverMemory: () => boolean, unloadCallback?: (tile: Tile3D) => void): void;
 }
 
-declare interface TilesetJSON {
+export declare interface TilesetJSON {
     asset: {
         gltfUpAxis: "X" | "Y" | "Z";
         version: "1.0";
@@ -2504,11 +2488,17 @@ declare interface TilesetJSON {
     lodMetricValue: number;
     root: TilesetJSONNode;
     type: "TILES3D";
-    floorInfo: FloorInfo[] | [];
-    b3dmMapping: B3DMMapping;
+    floorInfo: {
+        ground: number;
+        height: number;
+    }[];
+    b3dmMapping: {
+        b3dm_base_url: string;
+        b3dm_url: Record<string, string>;
+    };
 }
 
-declare interface TilesetJSONNode {
+export declare interface TilesetJSONNode {
     boundingVolume: {
         box: number[];
     };
@@ -2526,12 +2516,12 @@ declare interface TilesetJSONNode {
     type: "EMPTY" | "SCENEGRAPH" | "MESH";
 }
 
-declare type TilesetTraverserProps = {
+export declare type TilesetTraverserProps = {
     loadSiblings: boolean;
     skipLevelOfDetail: boolean;
     maxScreenSpaceError: number;
     maxDepth?: number;
-    onTraversalEnd: (frameState: FrameState) => any;
+    onTraversalEnd: (frameState: TileFrameState) => any;
 };
 
 export declare interface TopviewControllerCustomInitArgs extends Omit<FloorplanControllerCustomInitArgs, "defaultLongitude" | "defaultLatitude" | "maxLatitude" | "minLatitude"> {
@@ -2540,6 +2530,13 @@ export declare interface TopviewControllerCustomInitArgs extends Omit<FloorplanC
 export declare interface VRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
 }
 
+declare type WebXREventTypes = {
+    /** WebXR模式开始，session完成坐标系设置*/
+    webXRSessionStart(): void;
+    /** WebXR模式结束，销毁session*/
+    webXRSessionEnd(): void;
+};
+
 export declare class Work {
     /** 名称 */
     name: string;
@@ -2624,13 +2621,6 @@ export declare interface WorkModelTiles {
     b3md_mappings_url_md5: string;
 }
 
-declare interface WorkModelTiles_2 {
-    tileset_url: string;
-    tileset_url_md5: string;
-    b3md_mappings_url: string;
-    b3md_mappings_url_md5: string;
-}
-
 /** 每个点位的数据 */
 export declare interface WorkObserver {
     /** 点位序号 */
@@ -2678,4 +2668,109 @@ export declare interface WorkVideo {
     size: THREE_2.Vector2;
 }
 
+export declare class XRButton {
+    static createButton(onClickHook: () => void): HTMLAnchorElement | HTMLButtonElement;
+}
+
+declare class XRController {
+    _targetRay: any;
+    _grip: any;
+    _hand: any;
+    _axes: number[];
+    constructor();
+    getHandSpace(): any;
+    getTargetRaySpace(): any;
+    getGripSpace(): any;
+    dispatchEvent(event: any): this;
+    disconnect(inputSource: XRInputSource): this;
+    getAxes(): number[];
+    update(inputSource: any, frame: any, referenceSpace: any): this;
+}
+
+declare type XRControllerRay = {
+    angularVelocity: THREE_2.Vector3;
+    linearVelocity: THREE_2.Vector3;
+    up: THREE_2.Vector3;
+    matrix: THREE_2.Matrix4;
+    position: THREE_2.Vector3;
+    rotation: THREE_2.Euler;
+};
+
+declare interface XRInitOption {
+    /** 使用WEBXR的当前设备*/
+    machineType: XRMachineType;
+    /** 全景模式还是视差模式*/
+    isPanorama: boolean;
+    /** 使用的参考空间类型*/
+    referenceSpaceType: XRReferenceSpaceType;
+}
+
+declare type XRMachineType = 'Pico' | 'Oculus';
+
+export declare class XRManager extends Subscribe<WebXREventTypes> {
+    /** 是否使用全景模式*/
+    isPanorama: boolean;
+    /** 当前的设备*/
+    machineType: XRMachineType;
+    /** 场景渲染器*/
+    renderer: THREE_2.WebGLRenderer;
+    /** opengles句柄*/
+    gl: WebGLRenderingContext;
+    /** 是否开启XR模式 */
+    enabled: boolean;
+    /** WebXR模式Context */
+    session: XRSession | null;
+    /** XR参考空间类型*/
+    referenceSpaceType: XRReferenceSpaceType;
+    /** XR参考空间 */
+    referenceSpace: XRReferenceSpace | null;
+    /** XR控制器 */
+    controllers: XRController[];
+    /** XR控制器控制数据 */
+    inputSourcesMap: Map<XRInputSource, XRController>;
+    /** XR双相机 */
+    cameraVR: THREE_2.ArrayCamera;
+    /** XR左眼相机*/
+    cameraL: THREE_2.PerspectiveCamera;
+    /** XR右眼相机*/
+    cameraR: THREE_2.PerspectiveCamera;
+    /** 是否在获取*/
+    isPresenting: boolean;
+    /** 视锥近面*/
+    private currentDepthNear;
+    /** 视锥远面*/
+    private currentDepthFar;
+    /** 左眼相机位姿*/
+    private cameraLPos;
+    /** 右眼相机位姿*/
+    private cameraRPos;
+    constructor(renderer: THREE_2.WebGLRenderer, gl: WebGLRenderingContext, options?: Partial<XRInitOption>);
+    getController(index: number): XRControllerRay;
+    getCameras(): any;
+    private updateCamera;
+    /**
+     * @author jsantell / https://www.jsantell.com/
+     *
+     * Assumes 2 cameras that are parallel and share an X-axis, and that
+     * the cameras' projection and world matrices have already been set.
+     * And that near and far planes are identical for both cameras.
+     * Visualization of this technique: https://computergraphics.stackexchange.com/a/4765
+     */
+    private setProjectionFromUnion;
+    /**
+     * 获取THREEJS用于渲染XR场景的双眼相机
+     * @param camera - 传统模式下渲染场景的THREEJS相机
+     * @returns - 用于渲染XR场景的双眼相机
+     */
+    getCamera(camera: THREE_2.PerspectiveCamera): any;
+    private updateInputSources;
+    private onSessionEvent;
+    private onSessionEnd;
+    private onRequestReferenceSpace;
+    setSession(value: XRSession | null): void;
+}
+
+declare interface XRPanoramaControllerCustomInitArgs extends Omit<PanoramaControllerCustomInitArgs, "maxLatitude" | "minLatitude"> {
+}
+
 export { }