xrblocks 0.3.1 → 0.4.0

package/build/addons/ai/GeminiManager.d.ts

@@ -26,6 +26,7 @@ export declare class GeminiManager extends xb.Script<GeminiManagerEventMap> {
     currentInputText: string;
     currentOutputText: string;
     tools: xb.Tool[];
+    scheduleAheadTime: number;
     constructor();
     init(): void;
     startGeminiLive({ liveParams, model, }?: {

package/build/addons/ai/GeminiManager.js

@@ -1,6 +1,7 @@
 import * as xb from 'xrblocks';
 import { AUDIO_CAPTURE_PROCESSOR_CODE } from './AudioCaptureProcessorCode.js';
 
+const DEFAULT_SCHEDULE_AHEAD_TIME = 1.0;
 class GeminiManager extends xb.Script {
     constructor() {
         super();
@@ -19,6 +20,7 @@ class GeminiManager extends xb.Script {
         this.currentInputText = '';
         this.currentOutputText = '';
         this.tools = [];
+        this.scheduleAheadTime = DEFAULT_SCHEDULE_AHEAD_TIME;
     }
     init() {
         this.xrDeviceCamera = xb.core.deviceCamera;
@@ -191,10 +193,9 @@ class GeminiManager extends xb.Script {
         }
     }
     scheduleAudioBuffers() {
-        const SCHEDULE_AHEAD_TIME = 0.2;
         while (this.audioQueue.length > 0 &&
             this.nextAudioStartTime <=
-                this.audioContext.currentTime + SCHEDULE_AHEAD_TIME) {
+                this.audioContext.currentTime + this.scheduleAheadTime) {
             const audioBuffer = this.audioQueue.shift();
             const source = this.audioContext.createBufferSource();
             source.buffer = audioBuffer;

package/build/core/Options.d.ts

@@ -95,6 +95,7 @@ export declare class Options {
      * Whether to use post-processing effects.
      */
     usePostprocessing: boolean;
+    enableSimulator: boolean;
     /**
      * Configuration for the XR session button.
      */
@@ -104,7 +105,7 @@ export declare class Options {
         endText: string;
         invalidText: string;
         startSimulatorText: string;
-        enableSimulator: boolean;
+        showEnterSimulatorButton: boolean;
         alwaysAutostartSimulator: boolean;
     };
     /**

package/build/core/components/WebXRSessionManager.d.ts

@@ -34,6 +34,7 @@ export declare class WebXRSessionManager extends THREE.EventDispatcher<WebXRSess
     private sessionOptions?;
     private onSessionEndedBound;
     private xrModeSupported?;
+    private waitingForXRSession;
     constructor(renderer: THREE.WebGLRenderer, sessionInit: XRSessionInit, mode: XRSessionMode);
     /**
      * Checks for WebXR support and availability of the requested session mode.

package/build/core/components/XRButton.d.ts

@@ -9,7 +9,7 @@ export declare class XRButton {
     domElement: HTMLDivElement;
     simulatorButtonElement: HTMLButtonElement;
     xrButtonElement: HTMLButtonElement;
-    constructor(sessionManager: WebXRSessionManager, startText?: string, endText?: string, invalidText?: string, startSimulatorText?: string, enableSimulator?: boolean, startSimulator?: () => void);
+    constructor(sessionManager: WebXRSessionManager, startText?: string, endText?: string, invalidText?: string, startSimulatorText?: string, showEnterSimulatorButton?: boolean, startSimulator?: () => void);
     private createSimulatorButton;
     private createXRButtonElement;
     private onSessionReady;

package/build/sound/AudioPlayer.d.ts

@@ -14,6 +14,7 @@ export declare class AudioPlayer extends Script {
     private categoryVolumes?;
     private volume;
     private category;
+    scheduleAheadTime: number;
     constructor(options?: AudioPlayerOptions);
     /**
      * Sets the CategoryVolumes instance for this player to respect

package/build/xrblocks.js

@@ -14,9 +14,9 @@
  * limitations under the License.
  *
  * @file xrblocks.js
- * @version v0.3.1
- * @commitid 8945d46
- * @builddate 2025-11-04T06:32:35.799Z
+ * @version v0.4.0
+ * @commitid 385db96
+ * @builddate 2025-11-20T21:08:04.032Z
  * @description XR Blocks SDK, built from source with the above commit ID.
  * @agent When using with Gemini to create XR apps, use **Gemini Canvas** mode,
  * and follow rules below:
@@ -3208,9 +3208,9 @@ class Depth {
     update(frame) {
         if (!this.options.enabled)
             return;
-        if (!frame)
-            return;
-        this.updateLocalDepth(frame);
+        if (frame) {
+            this.updateLocalDepth(frame);
+        }
         if (this.options.occlusion.enabled) {
             this.renderOcclusionPass();
         }
@@ -4284,6 +4284,7 @@ class WebXRSessionManager extends THREE.EventDispatcher {
         this.sessionInit = sessionInit;
         this.mode = mode;
         this.onSessionEndedBound = this.onSessionEndedInternal.bind(this);
+        this.waitingForXRSession = false;
     }
     /**
      * Checks for WebXR support and availability of the requested session mode.
@@ -4350,8 +4351,15 @@ class WebXRSessionManager extends THREE.EventDispatcher {
         else if (this.currentSession) {
             throw new Error('Session already started');
         }
+        else if (this.waitingForXRSession) {
+            throw new Error('Waiting for session to start');
+        }
+        this.waitingForXRSession = true;
         navigator
             .xr.requestSession(this.mode, this.sessionOptions)
+            .finally(() => {
+            this.waitingForXRSession = false;
+        })
             .then(this.onSessionStartedInternal.bind(this));
     }
     /**
@@ -4394,7 +4402,7 @@ class WebXRSessionManager extends THREE.EventDispatcher {
 const XRBUTTON_WRAPPER_ID = 'XRButtonWrapper';
 const XRBUTTON_CLASS = 'XRButton';
 class XRButton {
-    constructor(sessionManager, startText = 'ENTER XR', endText = 'END XR', invalidText = 'XR NOT SUPPORTED', startSimulatorText = 'START SIMULATOR', enableSimulator = false, startSimulator = () => { }) {
+    constructor(sessionManager, startText = 'ENTER XR', endText = 'END XR', invalidText = 'XR NOT SUPPORTED', startSimulatorText = 'START SIMULATOR', showEnterSimulatorButton = false, startSimulator = () => { }) {
         this.sessionManager = sessionManager;
         this.startText = startText;
         this.endText = endText;
@@ -4406,7 +4414,7 @@ class XRButton {
         this.xrButtonElement = document.createElement('button');
         this.domElement.id = XRBUTTON_WRAPPER_ID;
         this.createXRButtonElement();
-        if (enableSimulator) {
+        if (showEnterSimulatorButton) {
             this.createSimulatorButton();
         }
         this.sessionManager.addEventListener(WebXRSessionEventType.UNSUPPORTED, this.showXRNotSupported.bind(this));
@@ -7414,6 +7422,7 @@ class Options {
          * Whether to use post-processing effects.
          */
         this.usePostprocessing = false;
+        this.enableSimulator = true;
         /**
          * Configuration for the XR session button.
          */
@@ -7423,7 +7432,7 @@ class Options {
             endText: 'Exit XR',
             invalidText: 'XR Not Supported',
             startSimulatorText: 'Enter Simulator',
-            enableSimulator: true,
+            showEnterSimulatorButton: false,
             // Whether to autostart the simulator even if WebXR is available.
             alwaysAutostartSimulator: false,
         };
@@ -10259,6 +10268,7 @@ class AudioListener extends Script {
     }
 }
 
+const DEFAULT_SCHEDULE_AHEAD_TIME = 1.0;
 class AudioPlayer extends Script {
     constructor(options = {}) {
         super();
@@ -10267,6 +10277,7 @@ class AudioPlayer extends Script {
         this.nextStartTime = 0;
         this.volume = 1.0;
         this.category = 'speech';
+        this.scheduleAheadTime = DEFAULT_SCHEDULE_AHEAD_TIME;
         this.options = { sampleRate: 24000, channelCount: 1, ...options };
         if (options.category) {
             this.category = options.category;
@@ -10331,9 +10342,9 @@ class AudioPlayer extends Script {
         this.scheduleAudioBuffers();
     }
     scheduleAudioBuffers() {
-        const SCHEDULE_AHEAD_TIME = 0.2;
         while (this.audioQueue.length > 0 &&
-            this.nextStartTime <= this.audioContext.currentTime + SCHEDULE_AHEAD_TIME) {
+            this.nextStartTime <=
+                this.audioContext.currentTime + this.scheduleAheadTime) {
             const audioBuffer = this.audioQueue.shift();
             const currentTime = this.audioContext.currentTime;
             const startTime = Math.max(this.nextStartTime, currentTime);
@@ -14589,11 +14600,11 @@ class Core {
         // Sets up xrButton.
         let shouldAutostartSimulator = this.options.xrButton.alwaysAutostartSimulator;
         if (!shouldAutostartSimulator && options.xrButton.enabled) {
-            this.xrButton = new XRButton(this.webXRSessionManager, options.xrButton?.startText, options.xrButton?.endText, options.xrButton?.invalidText, options.xrButton?.startSimulatorText, options.xrButton?.enableSimulator, this.startSimulator.bind(this));
+            this.xrButton = new XRButton(this.webXRSessionManager, options.xrButton?.startText, options.xrButton?.endText, options.xrButton?.invalidText, options.xrButton?.startSimulatorText, options.xrButton?.showEnterSimulatorButton, this.startSimulator.bind(this));
             document.body.appendChild(this.xrButton.domElement);
         }
         this.webXRSessionManager.addEventListener(WebXRSessionEventType.UNSUPPORTED, () => {
-            if (this.options.xrButton.enableSimulator) {
+            if (this.options.enableSimulator) {
                 this.xrButton?.domElement.remove();
                 shouldAutostartSimulator = true;
             }
@@ -14716,7 +14727,6 @@ class Core {
      * scripts.
      */
     onXRSessionEnded() {
-        this.startSimulator();
         this.scriptsManager.onXRSessionEnded();
     }
     /**