@plattar/plattar-ar-adapter 1.122.2 → 1.122.3

package/dist/ar/raw-ar.d.ts

@@ -0,0 +1,30 @@
+import { LauncherAR } from "./launcher-ar";
+/**
+ * Allows launching AR Experiences provided a single remote 3D Model file
+ */
+export declare class RawAR extends LauncherAR {
+    private readonly _modelLocation;
+    private _ar;
+    constructor(modelLocation?: string | undefined | null);
+    get modelLocation(): string;
+    /**
+     * Initialise the RawAR instance. This returns a Promise that resolves
+     * successfully if initialisation is successful, otherwise it will fail.
+     *
+     * filure can occur for a number of reasons but it generally means that AR
+     * cannot be performed.
+     */
+    init(): Promise<LauncherAR>;
+    /**
+     * Initialise and launch with a single function call. this is mostly for convenience.
+     * Use .init() and .start() separately for fine-grained control
+     */
+    launch(): Promise<void>;
+    /**
+     * Launches the internal AR instance using an appropriate version of AR Viewers
+     */
+    start(): void;
+    canQuicklook(): boolean;
+    canRealityViewer(): boolean;
+    canSceneViewer(): boolean;
+}

package/dist/ar/raw-ar.js

@@ -0,0 +1,110 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RawAR = void 0;
+const util_1 = require("../util/util");
+const quicklook_viewer_1 = __importDefault(require("../viewers/quicklook-viewer"));
+const reality_viewer_1 = __importDefault(require("../viewers/reality-viewer"));
+const scene_viewer_1 = __importDefault(require("../viewers/scene-viewer"));
+const launcher_ar_1 = require("./launcher-ar");
+/**
+ * Allows launching AR Experiences provided a single remote 3D Model file
+ */
+class RawAR extends launcher_ar_1.LauncherAR {
+    constructor(modelLocation = null) {
+        super();
+        if (!modelLocation) {
+            throw new Error("RawAR.constructor(modelLocation) - modelLocation must be defined");
+        }
+        const lowerLoc = modelLocation.toLowerCase();
+        if (lowerLoc.endsWith("usdz") || lowerLoc.endsWith("glb") || lowerLoc.endsWith("gltf") || lowerLoc.endsWith("reality")) {
+            this._modelLocation = modelLocation;
+            this._ar = null;
+        }
+        else {
+            throw new Error("RawAR.constructor(modelLocation) - modelLocation must be one of gltf, glb, usdz or reality");
+        }
+    }
+    get modelLocation() {
+        return this._modelLocation;
+    }
+    /**
+     * Initialise the RawAR instance. This returns a Promise that resolves
+     * successfully if initialisation is successful, otherwise it will fail.
+     *
+     * filure can occur for a number of reasons but it generally means that AR
+     * cannot be performed.
+     */
+    init() {
+        return new Promise((accept, reject) => {
+            if (!util_1.Util.canAugment()) {
+                return reject(new Error("RawAR.init() - cannot proceed as AR not available in context"));
+            }
+            const modelLocation = this._modelLocation;
+            const lowerLoc = modelLocation.toLowerCase();
+            // we need to define our AR module here
+            // we are in Safari/Quicklook mode here
+            if (util_1.Util.isSafari() || util_1.Util.isChromeOnIOS()) {
+                // load the reality experience if dealing with reality file
+                if (lowerLoc.endsWith("reality") && util_1.Util.canRealityViewer()) {
+                    this._ar = new reality_viewer_1.default();
+                    this._ar.modelUrl = modelLocation;
+                    return accept(this);
+                }
+                // load the usdz experience if dealing with usdz file
+                if (lowerLoc.endsWith("usdz") && util_1.Util.canQuicklook()) {
+                    this._ar = new quicklook_viewer_1.default();
+                    this._ar.modelUrl = modelLocation;
+                    return accept(this);
+                }
+                return reject(new Error("RawAR.init() - cannot proceed as model is not a .usdz or .reality file"));
+            }
+            // check android
+            if (util_1.Util.canSceneViewer()) {
+                if (lowerLoc.endsWith("glb") || lowerLoc.endsWith("gltf")) {
+                    this._ar = new scene_viewer_1.default();
+                    this._ar.modelUrl = modelLocation;
+                    return accept(this);
+                }
+                return reject(new Error("RawAR.init() - cannot proceed as model is not a .glb or .gltf file"));
+            }
+            // otherwise, we didn't have AR available - it should never really reach this stage as this should be caught
+            // earlier in the process
+            return reject(new Error("RawAR.init() - could not initialise AR correctly, check values"));
+        });
+    }
+    /**
+     * Initialise and launch with a single function call. this is mostly for convenience.
+     * Use .init() and .start() separately for fine-grained control
+     */
+    launch() {
+        return new Promise((accept, reject) => {
+            this.init().then((value) => {
+                value.start();
+                return accept();
+            }).catch(reject);
+        });
+    }
+    /**
+     * Launches the internal AR instance using an appropriate version of AR Viewers
+     */
+    start() {
+        if (!this._ar) {
+            throw new Error("RawAR.start() - cannot proceed as AR instance is null");
+        }
+        // this was initialised via the init() function
+        this._ar.start();
+    }
+    canQuicklook() {
+        return this._ar && this._ar.nodeType === "Quick Look" ? true : false;
+    }
+    canRealityViewer() {
+        return this._ar && this._ar.nodeType === "Reality Viewer" ? true : false;
+    }
+    canSceneViewer() {
+        return this._ar && this._ar.nodeType === "Scene Viewer" ? true : false;
+    }
+}
+exports.RawAR = RawAR;

package/dist/index.d.ts

@@ -5,4 +5,5 @@ export { ConfiguratorAR } from "./ar/configurator-ar";
 export { ProductAR } from "./ar/product-ar";
 export { SceneAR } from "./ar/scene-ar";
 export { ModelAR } from "./ar/model-ar";
+export { RawAR } from "./ar/raw-ar";
 export { Util } from "./util/util";

package/dist/index.js

@@ -22,7 +22,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Util = exports.ModelAR = exports.SceneAR = exports.ProductAR = exports.ConfiguratorAR = exports.version = exports.PlattarQRCode = exports.PlattarWeb = void 0;
+exports.Util = exports.RawAR = exports.ModelAR = exports.SceneAR = exports.ProductAR = exports.ConfiguratorAR = exports.version = exports.PlattarQRCode = exports.PlattarWeb = void 0;
 exports.PlattarWeb = __importStar(require("@plattar/plattar-web"));
 exports.PlattarQRCode = __importStar(require("@plattar/plattar-qrcode"));
 exports.version = __importStar(require("./version"));
@@ -34,6 +34,8 @@ var scene_ar_1 = require("./ar/scene-ar");
 Object.defineProperty(exports, "SceneAR", { enumerable: true, get: function () { return scene_ar_1.SceneAR; } });
 var model_ar_1 = require("./ar/model-ar");
 Object.defineProperty(exports, "ModelAR", { enumerable: true, get: function () { return model_ar_1.ModelAR; } });
+var raw_ar_1 = require("./ar/raw-ar");
+Object.defineProperty(exports, "RawAR", { enumerable: true, get: function () { return raw_ar_1.RawAR; } });
 var util_1 = require("./util/util");
 Object.defineProperty(exports, "Util", { enumerable: true, get: function () { return util_1.Util; } });
 const plattar_embed_1 = __importDefault(require("./embed/plattar-embed"));

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "1.122.2";
+declare const _default: "1.122.3";
 export default _default;

package/dist/version.js

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = "1.122.2";
+exports.default = "1.122.3";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plattar/plattar-ar-adapter",
-  "version": "1.122.2",
+  "version": "1.122.3",
   "description": "Plattar AR Adapter for interfacing with Google & Apple WebAR",
   "main": "dist/index.js",
   "module": "dist/index.js",