New: 3D preview logic now loads from generated JSON file.

build/karma.conf.js

@@ -3,7 +3,7 @@ const webpackConfig = require('./webpack.karma.config');
 
 const DOC_STATIC_ASSETS_VERSION = '0.130.0';
 const MEDIA_STATIC_ASSETS_VERSION = '0.127.0';
-const MODEL3D_STATIC_ASSETS_VERSION = '1.1.1';
+const MODEL3D_STATIC_ASSETS_VERSION = '1.4.1';
 const SWF_STATIC_ASSETS_VERSION = '0.112.0';
 const TEXT_STATIC_ASSETS_VERSION = '0.114.0';
 

src/lib/Preview.js

@@ -606,6 +606,9 @@ class Preview extends EventEmitter {
         // Enable or disable hotkeys
         this.options.useHotkeys = options.useHotkeys !== false;
 
+        // Custom Box3D application definition
+        this.options.box3dApplication = options.box3dApplication;
+
         // Save the files to iterate through
         this.collection = options.collection || [];
 

src/lib/constants.js

@@ -81,7 +81,7 @@ export const X_REP_HINT_VIDEO_MP4 = '[mp4]';
 // whenever a file in that third party directory is updated
 export const DOC_STATIC_ASSETS_VERSION = '0.130.0';
 export const MEDIA_STATIC_ASSETS_VERSION = '0.127.0';
-export const MODEL3D_STATIC_ASSETS_VERSION = '1.1.1';
+export const MODEL3D_STATIC_ASSETS_VERSION = '1.4.1';
 export const SWF_STATIC_ASSETS_VERSION = '0.112.0';
 export const TEXT_STATIC_ASSETS_VERSION = '0.114.0';
 

src/lib/viewers/box3d/Box3DControls.js

@@ -22,6 +22,9 @@ class Box3DControls extends EventEmitter {
     /** @property {HTMLElement} - Button used to enable/disable VR mode */
     vrButtonEl;
 
+    /** @property {boolean} - State used to show and hide the VR button */
+    vrButtonVisible = false;
+
     /**
      * Base class for building 3D previews on. Contains events for VR, Fullscreen,
      * Scene Reset, and Scene Loaded. Also, used for programmatic building of control
@@ -78,6 +81,11 @@ class Box3DControls extends EventEmitter {
      */
     addVrButton() {
         this.vrButtonEl = this.controls.add(__('box3d_toggle_vr'), this.handleToggleVr, '', ICON_3D_VR);
+        if (this.vrButtonVisible) {
+            this.showVrButton();
+        } else {
+            this.hideVrButton();
+        }
     }
 
     /**
@@ -122,6 +130,7 @@ class Box3DControls extends EventEmitter {
      * @return {void}
      */
     showVrButton() {
+        this.vrButtonVisible = true;
         if (this.vrButtonEl) {
             this.vrButtonEl.classList.remove(CLASS_HIDDEN);
         }
@@ -133,6 +142,7 @@ class Box3DControls extends EventEmitter {
      * @return {void}
      */
     hideVrButton() {
+        this.vrButtonVisible = false;
         if (this.vrButtonEl) {
             this.vrButtonEl.classList.add(CLASS_HIDDEN);
         }

src/lib/viewers/box3d/Box3DRenderer.js

@@ -1,18 +1,16 @@
 /* global Box3D */
 /* eslint no-param-reassign:0 */
+import 'whatwg-fetch';
 import EventEmitter from 'events';
 import {
     EVENT_SHOW_VR_BUTTON,
     EVENT_SCENE_LOADED,
-    EVENT_TRIGGER_RENDER,
     EVENT_WEBGL_CONTEXT_RESTORED,
     EVENT_WEBGL_CONTEXT_LOST
 } from './box3DConstants';
 import { MODEL3D_STATIC_ASSETS_VERSION } from '../../constants';
 
 const PREVIEW_CAMERA_CONTROLLER_ID = 'orbit_camera';
-const PREVIEW_CAMERA_POSITION = { x: 0, y: 0, z: 0 };
-const PREVIEW_CAMERA_QUATERNION = { x: 0, y: 0, z: 0, w: 1 };
 const OCULUS_TOUCH_LEFT = 'oculusTouchLeft';
 const OCULUS_TOUCH_RIGHT = 'oculusTouchRight';
 const HTC_VIVE = 'viveController';
@@ -50,10 +48,10 @@ class Box3DRenderer extends EventEmitter {
     boxSdk;
 
     /** @property {Object} - Default X, Y, Z position for the scene camera in 3D space */
-    defaultCameraPosition = PREVIEW_CAMERA_POSITION;
+    savedCameraPosition;
 
     /** @property {Object} - Default X, Y, Z, W quaternion for the scene camera in 3D space */
-    defaultCameraQuaternion = PREVIEW_CAMERA_QUATERNION;
+    savedCameraQuaternion;
 
     /** @property {Object} - Mapping of promises that each resolve when it's controller model file is loaded */
     vrGamepadLoadPromises = {};
@@ -77,7 +75,6 @@ class Box3DRenderer extends EventEmitter {
 
         this.containerEl = containerEl;
         this.boxSdk = boxSdk;
-        this.on(EVENT_TRIGGER_RENDER, this.handleOnRender);
 
         this.handleContextLost = this.handleContextLost.bind(this);
         this.handleContextRestored = this.handleContextRestored.bind(this);
@@ -106,8 +103,6 @@ class Box3DRenderer extends EventEmitter {
      * @return {void}
      */
     destroy() {
-        this.removeListener(EVENT_TRIGGER_RENDER, this.handleOnRender);
-
         if (!this.box3d) {
             return;
         }
@@ -142,16 +137,12 @@ class Box3DRenderer extends EventEmitter {
 
         // Reset camera settings to default.
         if (camera) {
-            camera.setPosition(
-                this.defaultCameraPosition.x,
-                this.defaultCameraPosition.y,
-                this.defaultCameraPosition.z
-            );
+            camera.setPosition(this.savedCameraPosition.x, this.savedCameraPosition.y, this.savedCameraPosition.z);
             camera.setQuaternion(
-                this.defaultCameraQuaternion.x,
-                this.defaultCameraQuaternion.y,
-                this.defaultCameraQuaternion.z,
-                this.defaultCameraQuaternion.w
+                this.savedCameraQuaternion.x,
+                this.savedCameraQuaternion.y,
+                this.savedCameraQuaternion.z,
+                this.savedCameraQuaternion.w
             );
         }
     }
@@ -162,7 +153,7 @@ class Box3DRenderer extends EventEmitter {
      * @return {Box3DEntity} The camera instance
      */
     getCamera() {
-        return this.box3d ? this.box3d.getObjectById('CAMERA_ID') : null;
+        return this.box3d ? this.box3d.getObjectByClass(Box3D.CameraObject) : null;
     }
 
     /**
@@ -171,7 +162,7 @@ class Box3DRenderer extends EventEmitter {
      * @return {SceneObject} The scene object
      */
     getScene() {
-        return this.box3d ? this.box3d.getEntityById('SCENE_ID') : null;
+        return this.box3d ? this.box3d.getObjectByClass(Box3D.SceneObject) : null;
     }
 
     /**
@@ -208,6 +199,15 @@ class Box3DRenderer extends EventEmitter {
         return Promise.resolve(xhr);
     }
 
+    /**
+     * Load Box3D entities from a JSON file specified with the provided path.
+     * @param {string} url - A path to a JSON file containing Box3D entity descriptions.
+     * @return {Promise} - A promise that resolves on completion of the load.
+     */
+    getEntitiesFromUrl(url) {
+        return fetch(url).then((response) => response.json());
+    }
+
     /**
      * Initialize the Box3D engine.
      *
@@ -216,6 +216,7 @@ class Box3DRenderer extends EventEmitter {
      * @param {string} [options.apiHost] - API URL base to make requests to
      * @param {Object|null} [options.file] - Information about the current box file we're using.
      * Used to get the parent.id of the box file.
+     * @param {Object|string} [options.box3dApplication] - Path to a json file published from Box3D Studio (or the json itself).
      * @return {Promise} A promise that resolves with the created box3d
      */
     initBox3d(options = {}) {
@@ -229,32 +230,51 @@ class Box3DRenderer extends EventEmitter {
         }
 
         const resourceLoader = new Box3D.XhrResourceLoader(this.configureXHR.bind(this, options));
+        const json = options && options.box3dApplication ? options.box3dApplication : {};
+        let getApplication = Promise.resolve([]);
+        if (typeof json === 'object') {
+            getApplication = Promise.resolve(json);
+        } else if (typeof json === 'string') {
+            getApplication = this.getEntitiesFromUrl(json);
+        }
 
-        return this.createBox3d(resourceLoader, options.sceneEntities);
+        return getApplication.then((applicationEntities) =>
+            this.createBox3d(resourceLoader, options.sceneEntities, applicationEntities.entities, `${options.apiHost}`)
+        );
     }
 
     /**
      * Create a new Box3D engine.
      *
      * @param {Object} resourceLoader - The resource loader used to load assets used by the box3d engine
      * @param {Array} [sceneEntities] - The descriptor of the default scene. See ./scene-entities.js
-     * @param {Object} [inputSettings] - Config for the input controller of the Box3D Engine
+     * @param {Array} [applicationEntities] - Array of entities published from Box3D Studio project.
+     * @param {string} [apiBase] - Optional base path for Box API calls.
      * @return {Promise} A promise that resolves with the Box3D Engine.
      */
-    createBox3d(resourceLoader, sceneEntities) {
+    createBox3d(resourceLoader, sceneEntities, applicationEntities, apiBase) {
         const box3d = new Box3D.Engine({
             container: this.containerEl,
             engineName: 'Default',
-            resourceLoader
+            resourceLoader,
+            apiBase
         });
         if (box3d.canvas) {
             box3d.canvas.addEventListener('webglcontextlost', this.handleContextLost);
             box3d.canvas.addEventListener('webglcontextrestored', this.handleContextRestored);
         }
 
         return new Promise((resolve) => {
+            if (applicationEntities) {
+                box3d.addEntities(applicationEntities);
+            }
+
+            let app = box3d.getAssetByClass(Box3D.ApplicationAsset);
             box3d.addEntities(sceneEntities);
-            const app = box3d.getAssetById('APP_ASSET_ID');
+            if (!app) {
+                app = box3d.getAssetByClass(Box3D.ApplicationAsset);
+            }
+
             app.load();
             this.box3d = box3d;
             resolve(this.box3d);
@@ -290,6 +310,11 @@ class Box3DRenderer extends EventEmitter {
      * @return {void}
      */
     onSceneLoad() {
+        const camera = this.getCamera();
+        if (camera) {
+            this.savedCameraPosition = camera.getPosition();
+            this.savedCameraQuaternion = camera.getQuaternion();
+        }
         // Reset the scene.
         this.reset();
         this.emit(EVENT_SCENE_LOADED);
@@ -366,18 +391,6 @@ class Box3DRenderer extends EventEmitter {
         this.box3d.trigger('disableVrRendering');
     }
 
-    /**
-     * Trigger an update and render event on the runtime.
-     *
-     * @return {void}
-     */
-    handleOnRender() {
-        if (!this.box3d) {
-            return;
-        }
-        this.box3d.trigger('render');
-    }
-
     /**
      * Call the onResize of the engine.
      *
@@ -430,6 +443,10 @@ class Box3DRenderer extends EventEmitter {
 
         const app = this.box3d.getApplication();
         const vrPresenter = app.getComponentByScriptId('vr_presenter');
+        if (!vrPresenter) {
+            return;
+        }
+
         vrPresenter.whenDisplaysAvailable((displays) => {
             if (displays.length) {
                 this.emit(EVENT_SHOW_VR_BUTTON);