@galacean/engine-xr 1.3.0-alpha.2 → 1.3.0-beta.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@galacean/engine-xr",
-  "version": "1.3.0-alpha.2",
+  "version": "1.3.0-beta.5",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -23,11 +23,11 @@
     "types/**/*"
   ],
   "devDependencies": {
-    "@galacean/engine-design": "1.3.0-alpha.2",
-    "@galacean/engine": "1.3.0-alpha.2"
+    "@galacean/engine-design": "1.3.0-beta.5",
+    "@galacean/engine": "1.3.0-beta.5"
   },
   "peerDependencies": {
-    "@galacean/engine": "1.3.0-alpha.2"
+    "@galacean/engine": "1.3.0-beta.5"
   },
   "scripts": {
     "b:types": "tsc"

package/types/XRManagerExtended.d.ts

@@ -1,59 +1,12 @@
-import { Entity, XRManager } from "@galacean/engine";
+import { Entity } from "@galacean/engine";
 import { XRFeature } from "./feature/XRFeature";
 import { XRCameraManager } from "./feature/camera/XRCameraManager";
 import { XRInputManager } from "./input/XRInputManager";
 import { XRSessionManager } from "./session/XRSessionManager";
 import { XRSessionMode } from "./session/XRSessionMode";
-/**
- * XRManager is the entry point of the XR system.
- */
-export declare class XRManagerExtended extends XRManager {
-    /** Input manager for XR. */
-    inputManager: XRInputManager;
-    /** Session manager for XR. */
-    sessionManager: XRSessionManager;
-    /** Camera manager for XR. */
-    cameraManager: XRCameraManager;
-    private _origin;
-    private _features;
-    /**
-     * The current origin of XR space.
-     * @remarks The connection point between the virtual world and the real world ( XR Space )
-     */
-    get origin(): Entity;
-    set origin(value: Entity);
-    /**
-     * Check if the specified feature is supported.
-     * @param type - The type of the feature
-     * @returns If the feature is supported
-     */
-    isSupportedFeature<T extends XRFeature>(feature: TFeatureConstructor<T>): boolean;
-    /**
-     * Add feature based on the xr feature type.
-     * @param type - The type of the feature
-     * @param args - The constructor params of the feature
-     * @returns The feature which has been added
-     */
-    addFeature<T extends new (xrManager: XRManagerExtended, ...args: any[]) => XRFeature>(type: T, ...args: TFeatureConstructorArguments<T>): XRFeature | null;
-    /**
-     * Get feature which match the type.
-     * @param type - The type of the feature
-     * @returns	The feature which match type
-     */
-    getFeature<T extends XRFeature>(type: TFeatureConstructor<T>): T | null;
-    getFeatures<T extends XRFeature>(type: TFeatureConstructor<T>, out?: T[]): T[];
-    /**
-     * Enter XR immersive mode, when you call this method, it will initialize and display the XR virtual world.
-     * @param sessionMode - The mode of the session
-     * @param autoRun - Whether to automatically run the session, when `autoRun` is set to true, xr will start working immediately after initialization. Otherwise, you need to call `sessionManager.run` later to work.
-     * @returns A promise that resolves if the XR virtual world is entered, otherwise rejects
-     */
-    enterXR(sessionMode: XRSessionMode, autoRun?: boolean): Promise<void>;
-    /**
-     * Exit XR immersive mode, when you call this method, it will destroy the XR virtual world.
-     * @returns A promise that resolves if the XR virtual world is destroyed, otherwise rejects
-     */
-    exitXR(): Promise<void>;
+export interface IXRListener {
+    fn: (...args: any[]) => any;
+    destroyed?: boolean;
 }
 type TFeatureConstructor<T extends XRFeature> = new (xrManager: XRManagerExtended, ...args: any[]) => T;
 type TFeatureConstructorArguments<T extends new (xrManager: XRManagerExtended, ...args: any[]) => XRFeature> = T extends new (xrManager: XRManagerExtended, ...args: infer P) => XRFeature ? P : never;
@@ -65,23 +18,14 @@ declare module "@galacean/engine" {
         sessionManager: XRSessionManager;
         /** Camera manager for XR. */
         cameraManager: XRCameraManager;
+        /** Initialized features. */
+        get features(): XRFeature[];
         /**
          * The current origin of XR space.
          * @remarks The connection point between the virtual world and the real world ( XR Space )
          */
         get origin(): Entity;
         set origin(value: Entity);
-        /**
-         * Get all initialized features at this moment.
-         * @param type - The type of the feature
-         */
-        getFeatures<T extends XRFeature>(type: TFeatureConstructor<T>): T[];
-        /**
-         * Get all initialized features at this moment.
-         * @param type - The type of the feature
-         * @param out - Save all features in `out`
-         */
-        getFeatures<T extends XRFeature>(type: TFeatureConstructor<T>, out: T[]): T[];
         /**
          * Check if the specified feature is supported.
          * @param type - The type of the feature
@@ -94,14 +38,13 @@ declare module "@galacean/engine" {
          * @param args - The constructor params of the feature
          * @returns The feature which has been added
          */
-        addFeature<T extends new (xrManager: XRManagerExtended, ...args: any[]) => XRFeature>(type: T, ...args: TFeatureConstructorArguments<T>): XRFeature | null;
+        addFeature<T extends new (xrManager: XRManagerExtended, ...args: any[]) => XRFeature>(type: T, ...args: TFeatureConstructorArguments<T>): InstanceType<T> | null;
         /**
          * Get feature which match the type.
          * @param type - The type of the feature
          * @returns	The feature which match type
          */
         getFeature<T extends XRFeature>(type: TFeatureConstructor<T>): T | null;
-        getFeatures<T extends XRFeature>(type: TFeatureConstructor<T>, out?: T[]): T[];
         /**
          * Enter XR immersive mode, when you call this method, it will initialize and display the XR virtual world.
          * @param sessionMode - The mode of the session

package/types/feature/trackable/XRTrackableFeature.d.ts

@@ -6,7 +6,7 @@ import { XRTracked } from "./XRTracked";
 /**
  * The base class of XR trackable manager.
  */
-export declare abstract class XRTrackableFeature<T extends XRTracked, K extends XRRequestTracking<T>> extends XRFeature<IXRTrackablePlatformFeature<T, K>> {
+export declare abstract class XRTrackableFeature<T extends XRTracked = XRTracked, K extends XRRequestTracking<T> = XRRequestTracking<T>> extends XRFeature<IXRTrackablePlatformFeature<T, K>> {
     protected static _uuid: number;
     protected _requestTrackings: K[];
     protected _tracked: T[];
@@ -28,7 +28,6 @@ export declare abstract class XRTrackableFeature<T extends XRTracked, K extends
     _onUpdate(): void;
     _onSessionStop(): void;
     _onSessionExit(): void;
-    _onDestroy(): void;
     protected _addRequestTracking(requestTracking: K): void;
     protected _removeRequestTracking(requestTracking: K): void;
     protected _removeAllRequestTrackings(): void;

package/types/index.d.ts

@@ -1,6 +1,8 @@
 import "./XRManagerExtended";
 export { XRPose } from "./XRPose";
 export { XRFeature } from "./feature/XRFeature";
+export { XRTrackableFeature } from "./feature/trackable/XRTrackableFeature";
+export { XRTracked } from "./feature/trackable/XRTracked";
 export { XRCameraManager } from "./feature/camera/XRCameraManager";
 export { TrackableType } from "./feature/hitTest/TrackableType";
 export { XRHitResult } from "./feature/hitTest/XRHitResult";
@@ -26,3 +28,5 @@ export { XRFeatureType } from "./feature/XRFeatureType";
 export { XRRequestTrackingState } from "./feature/trackable/XRRequestTrackingState";
 export { XRInputEventType } from "./input/XRInputEventType";
 export { XRTargetRayMode } from "./input/XRTargetRayMode";
+export * from "./loader/XRReferenceImageDecoder";
+export * from "./loader/XRReferenceImageLoader";

package/types/loader/XRReferenceImageDecoder.d.ts

@@ -0,0 +1,5 @@
+import { BufferReader, Engine } from "@galacean/engine";
+import { XRReferenceImage } from "../feature/trackable/image/XRReferenceImage";
+export declare class XRReferenceImageDecoder {
+    static decode(engine: Engine, bufferReader: BufferReader): Promise<XRReferenceImage>;
+}

package/types/loader/XRReferenceImageLoader.d.ts

@@ -0,0 +1,5 @@
+import { AssetPromise, Loader, LoadItem, ResourceManager } from "@galacean/engine";
+import { XRReferenceImage } from "../feature/trackable/image/XRReferenceImage";
+export declare class XRReferenceImageLoader extends Loader<XRReferenceImage> {
+    load(item: LoadItem, resourceManager: ResourceManager): AssetPromise<XRReferenceImage>;
+}

package/types/session/XRSessionManager.d.ts

@@ -11,6 +11,7 @@ export declare class XRSessionManager {
     private _rhi;
     private _raf;
     private _caf;
+    private _listeners;
     /**
      * The current session mode( AR or VR ).
      */
@@ -41,5 +42,15 @@ export declare class XRSessionManager {
      * Stop the session.
      */
     stop(): void;
+    /**
+     * Add a listening function for session state changes.
+     * @param listener - The listening function
+     */
+    addStateChangedListener(listener: (state: XRSessionState) => void): void;
+    /**
+     * Remove a listening function of session state changes.
+     * @param listener - The listening function
+     */
+    removeStateChangedListener(listener: (state: XRSessionState) => void): void;
     private _onSessionExit;
 }

package/types/session/XRSessionState.d.ts

@@ -4,10 +4,12 @@
 export declare enum XRSessionState {
     /** Not initialized. */
     None = 0,
+    /** Initializing session. */
+    Initializing = 1,
     /** Initialized but not started. */
-    Initialized = 1,
+    Initialized = 2,
     /** Running. */
-    Running = 2,
+    Running = 3,
     /** Paused. */
-    Paused = 3
+    Paused = 4
 }