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

package/dist/browser.js

@@ -99,9 +99,10 @@
      */ exports.XRSessionState = void 0;
     (function(XRSessionState) {
         XRSessionState[XRSessionState[/** Not initialized. */ "None"] = 0] = "None";
-        XRSessionState[XRSessionState[/** Initialized but not started. */ "Initialized"] = 1] = "Initialized";
-        XRSessionState[XRSessionState[/** Running. */ "Running"] = 2] = "Running";
-        XRSessionState[XRSessionState[/** Paused. */ "Paused"] = 3] = "Paused";
+        XRSessionState[XRSessionState[/** Initializing session. */ "Initializing"] = 1] = "Initializing";
+        XRSessionState[XRSessionState[/** Initialized but not started. */ "Initialized"] = 2] = "Initialized";
+        XRSessionState[XRSessionState[/** Running. */ "Running"] = 3] = "Running";
+        XRSessionState[XRSessionState[/** Paused. */ "Paused"] = 4] = "Paused";
     })(exports.XRSessionState || (exports.XRSessionState = {}));
 
     /**
@@ -184,7 +185,7 @@
        */ _proto._onSessionExit = function _onSessionExit() {};
         /**
        * @internal
-       */ _proto._getCameraClearFlagsMask = function _getCameraClearFlagsMask(cameraType) {
+       */ _proto._getIgnoreClearFlags = function _getIgnoreClearFlags(cameraType) {
             if (cameraType === engine.CameraType.XRCenterCamera) {
                 if (this._xrManager.sessionManager.state === exports.XRSessionState.Running) {
                     return engine.CameraClearFlags.Color;
@@ -344,7 +345,7 @@
             this._removed = [];
             this._trackedDevices = [];
             this._statusSnapshot = [];
-            this._listeners = [];
+            this._listeners = new engine.SafeLoopArray();
             var _this = this, trackedDevices = _this._trackedDevices, controllers = _this._controllers, cameras = _this._cameras;
             for(var i = 0; i < 6; i++){
                 switch(i){
@@ -374,22 +375,22 @@
        * Add a listener for tracked device changes.
        * @param listener - The listener to add
        */ _proto.addTrackedDeviceChangedListener = function addTrackedDeviceChangedListener(listener) {
-            this._listeners.push(listener);
+            this._listeners.push({
+                fn: listener
+            });
         };
         /**
        * Remove a listener of tracked device changes.
        * @param listener - The listener to remove
        */ _proto.removeTrackedDeviceChangedListener = function removeTrackedDeviceChangedListener(listener) {
-            var _this = this, listeners = _this._listeners;
-            var index = listeners.indexOf(listener);
-            if (index >= 0) {
-                listeners.splice(index, 1);
-            }
+            this._listeners.findAndRemove(function(value) {
+                return value.fn === listener ? value.destroyed = true : false;
+            });
         };
         /**
        * @internal
        */ _proto._onUpdate = function _onUpdate() {
-            var _this = this, added = _this._added, removed = _this._removed, listeners = _this._listeners, statusSnapshot = _this._statusSnapshot;
+            var _this = this, added = _this._added, removed = _this._removed, statusSnapshot = _this._statusSnapshot;
             var _this1 = this, trackedDevices = _this1._trackedDevices, controllers = _this1._controllers;
             // Reset data
             added.length = removed.length = 0;
@@ -422,15 +423,19 @@
             }
             // Dispatch change event
             if (added.length > 0 || removed.length > 0) {
+                var listeners = this._listeners.getLoopArray();
                 for(var i3 = 0, n3 = listeners.length; i3 < n3; i3++){
-                    listeners[i3](added, removed);
+                    var listener = listeners[i3];
+                    !listener.destroyed && listener.fn(added, removed);
                 }
             }
         };
         /**
        * @internal
        */ _proto._onDestroy = function _onDestroy() {
-            this._listeners.length = 0;
+            this._listeners.findAndRemove(function(value) {
+                return value.destroyed = true;
+            });
         };
         _proto._handleEvent = function _handleEvent(event) {
             var input = this._trackedDevices[event.input];
@@ -526,6 +531,7 @@
             this._engine = _engine;
             this._mode = exports.XRSessionMode.None;
             this._state = exports.XRSessionState.None;
+            this._listeners = new engine.SafeLoopArray();
             // @ts-ignore
             this._rhi = _engine._hardwareRenderer;
             this._raf = requestAnimationFrame.bind(window);
@@ -548,7 +554,7 @@
                 throw new Error("Without session to run.");
             }
             platformSession.start();
-            this._state = exports.XRSessionState.Running;
+            this._setState(exports.XRSessionState.Running);
             this._xrManager._onSessionStart();
             if (!engine.isPaused) {
                 engine.pause();
@@ -568,7 +574,7 @@
             rhi._mainFrameBuffer = null;
             rhi._mainFrameWidth = rhi._mainFrameHeight = 0;
             platformSession.stop();
-            this._state = exports.XRSessionState.Paused;
+            this._setState(exports.XRSessionState.Paused);
             this._xrManager._onSessionStop();
             if (!engine.isPaused) {
                 engine.pause();
@@ -576,6 +582,32 @@
             }
         };
         /**
+       * Add a listening function for session state changes.
+       * @param listener - The listening function
+       */ _proto.addStateChangedListener = function addStateChangedListener(listener) {
+            this._listeners.push({
+                fn: listener
+            });
+        };
+        /**
+       * Remove a listening function of session state changes.
+       * @param listener - The listening function
+       */ _proto.removeStateChangedListener = function removeStateChangedListener(listener) {
+            this._listeners.findAndRemove(function(value) {
+                return value.fn === listener ? value.destroyed = true : false;
+            });
+        };
+        /**
+       * @internal
+       */ _proto._setState = function _setState(value) {
+            this._state = value;
+            var listeners = this._listeners.getLoopArray();
+            for(var i = 0, n = listeners.length; i < n; i++){
+                var listener = listeners[i];
+                !listener.destroyed && listener.fn(value);
+            }
+        };
+        /**
        * @internal
        */ _proto._initialize = function _initialize(mode, features) {
             var _this = this;
@@ -590,7 +622,7 @@
                 xrManager._platformDevice.requestSession(_this._rhi, mode, platformFeatures).then(function(platformSession) {
                     _this._mode = mode;
                     _this._platformSession = platformSession;
-                    _this._state = exports.XRSessionState.Initialized;
+                    _this._setState(exports.XRSessionState.Initialized);
                     platformSession.setSessionExitCallBack(_this._onSessionExit);
                     platformSession.addEventListener();
                     xrManager._onSessionInit();
@@ -639,7 +671,7 @@
             rhi._mainFrameWidth = rhi._mainFrameHeight = 0;
             platformSession.removeEventListener();
             this._platformSession = null;
-            this._state = exports.XRSessionState.None;
+            this._setState(exports.XRSessionState.None);
             this._xrManager._onSessionExit();
             if (!engine.isPaused) {
                 engine.pause();
@@ -648,7 +680,12 @@
         };
         /**
        * @internal
-       */ _proto._onDestroy = function _onDestroy() {};
+       */ _proto._onDestroy = function _onDestroy() {
+            this._listeners.findAndRemove(function(value) {
+                return value.destroyed = true;
+            });
+            this._raf = this._caf = null;
+        };
         _create_class(XRSessionManager, [
             {
                 key: "mode",
@@ -687,47 +724,36 @@
     }();
 
     /**
-     * XRManager is the entry point of the XR system.
+     * @internal
      */ var XRManagerExtended = /*#__PURE__*/ function(XRManager1) {
         _inherits(XRManagerExtended, XRManager1);
         function XRManagerExtended() {
             return XRManager1.apply(this, arguments);
         }
         var _proto = XRManagerExtended.prototype;
-        /**
-       * Check if the specified feature is supported.
-       * @param type - The type of the feature
-       * @returns If the feature is supported
-       */ _proto.isSupportedFeature = function isSupportedFeature(feature) {
+        _proto.isSupportedFeature = function isSupportedFeature(feature) {
             return this._platformDevice.isSupportedFeature(XRManagerExtended._featureMap.get(feature));
         };
-        /**
-       * 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
-       */ _proto.addFeature = function addFeature(type) {
+        _proto.addFeature = function addFeature(type) {
             for(var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++){
                 args[_key - 1] = arguments[_key];
             }
             if (this.sessionManager._platformSession) {
                 throw new Error("Cannot add feature when the session is initialized.");
             }
-            var _this = this, features = _this._features;
+            if (!this._platformDevice.isSupportedFeature(XRManagerExtended._featureMap.get(type))) {
+                throw new Error("The feature is not supported");
+            }
+            var features = this.features;
             for(var i = 0, n = features.length; i < n; i++){
-                var feature = features[i];
-                if (_instanceof(feature, type)) throw new Error("The feature has been added");
+                if (_instanceof(features[i], type)) throw new Error("The feature has been added");
             }
-            var feature1 = _construct(type, [].concat(this, args));
-            this._features.push(feature1);
-            return feature1;
+            var feature = _construct(type, [].concat(this, args));
+            features.push(feature);
+            return feature;
         };
-        /**
-       * Get feature which match the type.
-       * @param type - The type of the feature
-       * @returns	The feature which match type
-       */ _proto.getFeature = function getFeature(type) {
-            var _this = this, features = _this._features;
+        _proto.getFeature = function getFeature(type) {
+            var features = this.features;
             for(var i = 0, n = features.length; i < n; i++){
                 var feature = features[i];
                 if (_instanceof(feature, type)) {
@@ -735,25 +761,7 @@
                 }
             }
         };
-        _proto.getFeatures = function getFeatures(type, out) {
-            if (out) {
-                out.length = 0;
-            } else {
-                out = [];
-            }
-            var _this = this, features = _this._features;
-            for(var i = 0, n = features.length; i < n; i--){
-                var feature = features[i];
-                _instanceof(feature, type) && out.push(feature);
-            }
-            return out;
-        };
-        /**
-       * 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
-       */ _proto.enterXR = function enterXR(sessionMode, autoRun) {
+        _proto.enterXR = function enterXR(sessionMode, autoRun) {
             if (autoRun === void 0) autoRun = true;
             var _this = this;
             var sessionManager = this.sessionManager;
@@ -766,18 +774,16 @@
             return new Promise(function(resolve, reject) {
                 // 1. Check if this xr mode is supported
                 sessionManager.isSupportedMode(sessionMode).then(function() {
+                    sessionManager._setState(exports.XRSessionState.Initializing);
                     // 2. Initialize session
-                    sessionManager._initialize(sessionMode, _this._features).then(function() {
+                    sessionManager._initialize(sessionMode, _this.features).then(function() {
                         autoRun && sessionManager.run();
                         resolve();
                     }, reject);
                 }, reject);
             });
         };
-        /**
-       * 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
-       */ _proto.exitXR = function exitXR() {
+        _proto.exitXR = function exitXR() {
             var _this = this;
             return new Promise(function(resolve, reject) {
                 _this.sessionManager._exit().then(function() {
@@ -785,32 +791,26 @@
                 }, reject);
             });
         };
-        /**
-       * @internal
-       */ _proto._initialize = function _initialize(engine, xrDevice) {
+        _proto._initialize = function _initialize(engine, xrDevice) {
             this._features = [];
             this._platformDevice = xrDevice;
             this.sessionManager = new XRSessionManager(this, engine);
             this.inputManager = new XRInputManager(this, engine);
             this.cameraManager = new XRCameraManager(this);
         };
-        /**
-       * @internal
-       */ _proto._update = function _update() {
+        _proto._update = function _update() {
             var sessionManager = this.sessionManager;
             if (sessionManager.state !== exports.XRSessionState.Running) return;
             sessionManager._onUpdate();
             this.inputManager._onUpdate();
             this.cameraManager._onUpdate();
-            var _this = this, features = _this._features;
+            var features = this.features;
             for(var i = 0, n = features.length; i < n; i++){
                 var feature = features[i];
                 feature.enabled && feature._onUpdate();
             }
         };
-        /**
-       * @internal
-       */ _proto._destroy = function _destroy() {
+        _proto._destroy = function _destroy() {
             var _this = this;
             if (this.sessionManager._platformSession) {
                 this.exitXR().then(function() {
@@ -824,25 +824,19 @@
                 this.cameraManager._onDestroy();
             }
         };
-        /**
-       * @internal
-       */ _proto._getRequestAnimationFrame = function _getRequestAnimationFrame() {
+        _proto._getRequestAnimationFrame = function _getRequestAnimationFrame() {
             return this.sessionManager._getRequestAnimationFrame();
         };
-        /**
-       * @internal
-       */ _proto._getCancelAnimationFrame = function _getCancelAnimationFrame() {
+        _proto._getCancelAnimationFrame = function _getCancelAnimationFrame() {
             return this.sessionManager._getCancelAnimationFrame();
         };
-        /**
-       * @internal
-       */ _proto._getCameraClearFlagsMask = function _getCameraClearFlagsMask(type) {
-            return this.cameraManager._getCameraClearFlagsMask(type);
+        _proto._getCameraIgnoreClearFlags = function _getCameraIgnoreClearFlags(type) {
+            return this.cameraManager._getIgnoreClearFlags(type);
         };
         /**
        * @internal
        */ _proto._onSessionStop = function _onSessionStop() {
-            var _this = this, features = _this._features;
+            var features = this.features;
             for(var i = 0, n = features.length; i < n; i++){
                 var feature = features[i];
                 feature.enabled && feature._onSessionStop();
@@ -851,7 +845,7 @@
         /**
        * @internal
        */ _proto._onSessionInit = function _onSessionInit() {
-            var _this = this, features = _this._features;
+            var features = this.features;
             for(var i = 0, n = features.length; i < n; i++){
                 var feature = features[i];
                 feature.enabled && feature._onSessionInit();
@@ -861,7 +855,7 @@
        * @internal
        */ _proto._onSessionStart = function _onSessionStart() {
             this.cameraManager._onSessionStart();
-            var _this = this, features = _this._features;
+            var features = this.features;
             for(var i = 0, n = features.length; i < n; i++){
                 var feature = features[i];
                 feature.enabled && feature._onSessionStart();
@@ -871,7 +865,7 @@
        * @internal
        */ _proto._onSessionExit = function _onSessionExit() {
             this.cameraManager._onSessionExit();
-            var _this = this, features = _this._features;
+            var features = this.features;
             for(var i = 0, n = features.length; i < n; i++){
                 var feature = features[i];
                 feature.enabled && feature._onSessionExit();
@@ -880,12 +874,15 @@
             features.length = 0;
         };
         _create_class(XRManagerExtended, [
+            {
+                key: "features",
+                get: function get() {
+                    return this._features;
+                }
+            },
             {
                 key: "origin",
-                get: /**
-       * The current origin of XR space.
-       * @remarks The connection point between the virtual world and the real world ( XR Space )
-       */ function get() {
+                get: function get() {
                     return this._origin;
                 },
                 set: function set(value) {
@@ -978,50 +975,6 @@
         return XRFeature;
     }();
 
-    /**
-     * Enum for the types of hit test that can be performed.
-     * Note: currently only supports plane.
-     */ exports.TrackableType = void 0;
-    (function(TrackableType) {
-        TrackableType[TrackableType[/** Tracked plane. */ "Plane"] = 0x1] = "Plane";
-        TrackableType[TrackableType[/** All tracked objects. */ "All"] = 0x1] = "All";
-    })(exports.TrackableType || (exports.TrackableType = {}));
-
-    /**
-     * XR hit result.
-     * It is the detection result returned by using XR HitTest feature.
-     */ var XRHitResult = function XRHitResult() {
-        /** The position of the hit point. */ this.point = new engine.Vector3();
-        /** The normal of the hit point. */ this.normal = new engine.Vector3();
-    };
-
-    /******************************************************************************
-    Copyright (c) Microsoft Corporation.
-
-    Permission to use, copy, modify, and/or distribute this software for any
-    purpose with or without fee is hereby granted.
-
-    THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-    REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-    AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-    INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-    LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-    OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-    PERFORMANCE OF THIS SOFTWARE.
-    ***************************************************************************** */
-
-    function __decorate(decorators, target, key, desc) {
-      var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-      if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-      else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-      return c > 3 && r && Object.defineProperty(target, key, r), r;
-    }
-
-    typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
-      var e = new Error(message);
-      return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
-    };
-
     exports.XRFeatureType = void 0;
     (function(XRFeatureType) {
         XRFeatureType[XRFeatureType["AnchorTracking"] = 0] = "AnchorTracking";
@@ -1053,7 +1006,7 @@
             _this._updated = [];
             _this._removed = [];
             _this._statusSnapshot = {};
-            _this._listeners = [];
+            _this._listeners = new engine.SafeLoopArray();
             return _this;
         }
         var _proto = XRTrackableFeature.prototype;
@@ -1061,22 +1014,22 @@
        * Add a listening function for tracked object changes.
        * @param listener - The listening function
        */ _proto.addChangedListener = function addChangedListener(listener) {
-            this._listeners.push(listener);
+            this._listeners.push({
+                fn: listener
+            });
         };
         /**
        * Remove a listening function of tracked object changes.
        * @param listener - The listening function
        */ _proto.removeChangedListener = function removeChangedListener(listener) {
-            var _this = this, listeners = _this._listeners;
-            var index = listeners.indexOf(listener);
-            if (index >= 0) {
-                listeners.splice(index, 1);
-            }
+            this._listeners.findAndRemove(function(value) {
+                return value.fn === listener ? value.destroyed = true : false;
+            });
         };
         _proto._onUpdate = function _onUpdate() {
             var _this__xrManager_sessionManager = this._xrManager.sessionManager, platformSession = _this__xrManager_sessionManager._platformSession;
             var platformFrame = platformSession.frame;
-            var _this = this, platformFeature = _this._platformFeature, listeners = _this._listeners, requestTrackings = _this._requestTrackings, statusSnapshot = _this._statusSnapshot, allTracked = _this._tracked, added = _this._added, updated = _this._updated, removed = _this._removed;
+            var _this = this, platformFeature = _this._platformFeature, requestTrackings = _this._requestTrackings, statusSnapshot = _this._statusSnapshot, allTracked = _this._tracked, added = _this._added, updated = _this._updated, removed = _this._removed;
             if (!platformFrame || !requestTrackings.length) {
                 return;
             }
@@ -1128,8 +1081,10 @@
                 requestTrackings[i1].state === exports.XRRequestTrackingState.Destroyed && requestTrackings.splice(i1, 1);
             }
             if (added.length > 0 || updated.length > 0 || removed.length > 0) {
+                var listeners = this._listeners.getLoopArray();
                 for(var i2 = 0, n3 = listeners.length; i2 < n3; i2++){
-                    listeners[i2](added, updated, removed);
+                    var listener = listeners[i2];
+                    !listener.destroyed && listener.fn(added, updated, removed);
                 }
             }
         };
@@ -1139,10 +1094,9 @@
         _proto._onSessionExit = function _onSessionExit() {
             // prettier-ignore
             this._requestTrackings.length = this._tracked.length = this._added.length = this._updated.length = this._removed.length = 0;
-        };
-        _proto._onDestroy = function _onDestroy() {
-            // prettier-ignore
-            this._requestTrackings.length = this._tracked.length = this._added.length = this._updated.length = this._removed.length = 0;
+            this._listeners.findAndRemove(function(value) {
+                return value.destroyed = true;
+            });
         };
         _proto._addRequestTracking = function _addRequestTracking(requestTracking) {
             var _this = this, platformFeature = _this._platformFeature;
@@ -1175,6 +1129,57 @@
         XRTrackableFeature._uuid = 0;
     })();
 
+    /**
+     * The base class of XR tracked object.
+     */ var XRTracked = function XRTracked() {
+        /** The pose of the trackable in XR space. */ this.pose = new XRPose();
+        /** The tracking state of the trackable. */ this.state = exports.XRTrackingState.NotTracking;
+    };
+
+    /**
+     * Enum for the types of hit test that can be performed.
+     * Note: currently only supports plane.
+     */ exports.TrackableType = void 0;
+    (function(TrackableType) {
+        TrackableType[TrackableType[/** Tracked plane. */ "Plane"] = 0x1] = "Plane";
+        TrackableType[TrackableType[/** All tracked objects. */ "All"] = 0x1] = "All";
+    })(exports.TrackableType || (exports.TrackableType = {}));
+
+    /**
+     * XR hit result.
+     * It is the detection result returned by using XR HitTest feature.
+     */ var XRHitResult = function XRHitResult() {
+        /** The position of the hit point. */ this.point = new engine.Vector3();
+        /** The normal of the hit point. */ this.normal = new engine.Vector3();
+    };
+
+    /******************************************************************************
+    Copyright (c) Microsoft Corporation.
+
+    Permission to use, copy, modify, and/or distribute this software for any
+    purpose with or without fee is hereby granted.
+
+    THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+    REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+    AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+    INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+    LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+    OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+    PERFORMANCE OF THIS SOFTWARE.
+    ***************************************************************************** */
+
+    function __decorate(decorators, target, key, desc) {
+      var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+      if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+      else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      return c > 3 && r && Object.defineProperty(target, key, r), r;
+    }
+
+    typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+      var e = new Error(message);
+      return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+    };
+
     /**
      * Enumerates modes of plane in XR.
      */ exports.XRPlaneMode = void 0;
@@ -1205,13 +1210,6 @@
         return XRRequestPlane;
     }(XRRequestTracking);
 
-    /**
-     * The base class of XR tracked object.
-     */ var XRTracked = function XRTracked() {
-        /** The pose of the trackable in XR space. */ this.pose = new XRPose();
-        /** The tracking state of the trackable. */ this.state = exports.XRTrackingState.NotTracking;
-    };
-
     /**
      * The tracked plane in XR space.
      */ var XRTrackedPlane = /*#__PURE__*/ function(XRTracked1) {
@@ -1559,6 +1557,64 @@
         this.physicalWidth = physicalWidth;
     };
 
+    exports.XRReferenceImageDecoder = /*#__PURE__*/ function() {
+        function XRReferenceImageDecoder() {}
+        XRReferenceImageDecoder.decode = function decode(engine, bufferReader) {
+            return new Promise(function(resolve, reject) {
+                var physicalWidth = bufferReader.nextFloat32();
+                bufferReader.nextUint8();
+                var img = new Image();
+                img.onload = function() {
+                    resolve(new XRReferenceImage("", img, physicalWidth));
+                };
+                img.src = URL.createObjectURL(new window.Blob([
+                    bufferReader.nextImagesData(1)[0]
+                ]));
+            });
+        };
+        return XRReferenceImageDecoder;
+    }();
+    exports.XRReferenceImageDecoder = __decorate([
+        engine.decoder("XRReferenceImage")
+    ], exports.XRReferenceImageDecoder);
+
+    function _extends() {
+        _extends = Object.assign || function assign(target) {
+            for (var i = 1; i < arguments.length; i++) {
+                var source = arguments[i];
+                for (var key in source) if (Object.prototype.hasOwnProperty.call(source, key)) target[key] = source[key];
+            }
+
+            return target;
+        };
+
+        return _extends.apply(this, arguments);
+    }
+
+    exports.XRReferenceImageLoader = /*#__PURE__*/ function(Loader1) {
+        _inherits(XRReferenceImageLoader, Loader1);
+        function XRReferenceImageLoader() {
+            return Loader1.apply(this, arguments);
+        }
+        var _proto = XRReferenceImageLoader.prototype;
+        _proto.load = function load(item, resourceManager) {
+            var _this = this;
+            return new engine.AssetPromise(function(resolve, reject) {
+                _this.request(item.url, _extends({}, item, {
+                    type: "arraybuffer"
+                })).then(function(data) {
+                    engine.decode(data, resourceManager.engine).then(function(referenceImage) {
+                        resolve(referenceImage);
+                    });
+                }).catch(reject);
+            });
+        };
+        return XRReferenceImageLoader;
+    }(engine.Loader);
+    exports.XRReferenceImageLoader = __decorate([
+        engine.resourceLoader("XRReferenceImage", [])
+    ], exports.XRReferenceImageLoader);
+
     exports.XRAnchor = XRAnchor;
     exports.XRCamera = XRCamera;
     exports.XRCameraManager = XRCameraManager;
@@ -1569,6 +1625,8 @@
     exports.XRPose = XRPose;
     exports.XRReferenceImage = XRReferenceImage;
     exports.XRSessionManager = XRSessionManager;
+    exports.XRTrackableFeature = XRTrackableFeature;
+    exports.XRTracked = XRTracked;
     exports.XRTrackedImage = XRTrackedImage;
     exports.XRTrackedPlane = XRTrackedPlane;