xrblocks 0.3.0 → 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,10 +105,8 @@ export declare class Options {
         endText: string;
         invalidText: string;
         startSimulatorText: string;
-        enableSimulator: boolean;
-        showSimulatorButtonOnMobile: boolean;
-        autostartSimulatorOnDesktop: boolean;
-        autostartSimulator: boolean;
+        showEnterSimulatorButton: boolean;
+        alwaysAutostartSimulator: boolean;
     };
     /**
      * Constructs the Options object by merging default values with provided

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, showSimulatorButtonOnMobile?: 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/depth/Depth.d.ts

@@ -57,7 +57,7 @@ export declare class Depth {
     updateCPUDepthData(depthData: XRCPUDepthInformation, view_id?: number): void;
     updateGPUDepthData(depthData: XRWebGLDepthInformation, view_id?: number): void;
     getTexture(view_id: number): THREE.DataTexture | THREE.ExternalTexture | undefined;
-    update(frame: XRFrame): void;
+    update(frame?: XRFrame): void;
     updateLocalDepth(frame: XRFrame): void;
     renderOcclusionPass(): void;
     debugLog(): void;

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.d.ts

@@ -99,7 +99,6 @@ export * from './ui/layouts/SpatialPanel';
 export * from './ui/layouts/TextScrollerState';
 export * from './ui/layouts/VerticalPager';
 export * from './ui/UI';
-export * from './utils/BrowserUtils';
 export * from './utils/DependencyInjection';
 export * from './utils/HelperConstants';
 export * from './utils/Keycodes';

package/build/xrblocks.js

@@ -14,9 +14,9 @@
  * limitations under the License.
  *
  * @file xrblocks.js
- * @version v0.3.0
- * @commitid c7b519d
- * @builddate 2025-11-04T00:07:30.989Z
+ * @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:
@@ -1890,10 +1890,6 @@ const xrDeviceCameraUserContinuousOptions = deepFreeze(new DeviceCameraOptions({
     willCaptureFrequently: true,
 }));
 
-function onDesktopUserAgent() {
-    return !/Mobi|Android|iPhone/i.test(navigator.userAgent);
-}
-
 const DepthMeshTexturedShader = {
     vertexShader: /* glsl */ `
 varying vec3 vNormal;
@@ -3212,22 +3208,19 @@ class Depth {
     update(frame) {
         if (!this.options.enabled)
             return;
-        this.updateLocalDepth(frame);
+        if (frame) {
+            this.updateLocalDepth(frame);
+        }
         if (this.options.occlusion.enabled) {
             this.renderOcclusionPass();
         }
     }
     updateLocalDepth(frame) {
-        if (onDesktopUserAgent()) {
-            return;
-        }
         const leftCamera = this.renderer.xr?.getCamera?.()?.cameras?.[0];
         if (leftCamera && this.depthMesh && this.depthMesh.parent != leftCamera) {
             leftCamera.add(this.depthMesh);
             this.scene.add(leftCamera);
         }
-        if (!frame)
-            return;
         const session = frame.session;
         const binding = this.renderer.xr.getBinding();
         // Enable or disable depth based on the number of clients.
@@ -4291,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.
@@ -4357,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));
     }
     /**
@@ -4401,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, showSimulatorButtonOnMobile = 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;
@@ -4413,8 +4414,7 @@ class XRButton {
         this.xrButtonElement = document.createElement('button');
         this.domElement.id = XRBUTTON_WRAPPER_ID;
         this.createXRButtonElement();
-        if (enableSimulator &&
-            (onDesktopUserAgent() || showSimulatorButtonOnMobile)) {
+        if (showEnterSimulatorButton) {
             this.createSimulatorButton();
         }
         this.sessionManager.addEventListener(WebXRSessionEventType.UNSUPPORTED, this.showXRNotSupported.bind(this));
@@ -7422,6 +7422,7 @@ class Options {
          * Whether to use post-processing effects.
          */
         this.usePostprocessing = false;
+        this.enableSimulator = true;
         /**
          * Configuration for the XR session button.
          */
@@ -7431,11 +7432,9 @@ class Options {
             endText: 'Exit XR',
             invalidText: 'XR Not Supported',
             startSimulatorText: 'Enter Simulator',
-            enableSimulator: true,
-            showSimulatorButtonOnMobile: false,
-            autostartSimulatorOnDesktop: true,
-            // Whether to always autostart the simulator.
-            autostartSimulator: false,
+            showEnterSimulatorButton: false,
+            // Whether to autostart the simulator even if WebXR is available.
+            alwaysAutostartSimulator: false,
         };
         deepMerge(this, options);
     }
@@ -10269,6 +10268,7 @@ class AudioListener extends Script {
     }
 }
 
+const DEFAULT_SCHEDULE_AHEAD_TIME = 1.0;
 class AudioPlayer extends Script {
     constructor(options = {}) {
         super();
@@ -10277,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;
@@ -10341,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);
@@ -14597,14 +14598,17 @@ class Core {
         this.webXRSessionManager.addEventListener(WebXRSessionEventType.SESSION_START, (event) => this.onXRSessionStarted(event.session));
         this.webXRSessionManager.addEventListener(WebXRSessionEventType.SESSION_END, this.onXRSessionEnded.bind(this));
         // Sets up xrButton.
-        const shouldAutostartSimulator = this.options.xrButton.autostartSimulator ||
-            (this.options.xrButton.autostartSimulatorOnDesktop &&
-                this.options.xrButton.enableSimulator &&
-                onDesktopUserAgent());
+        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, options.xrButton?.showSimulatorButtonOnMobile, 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.enableSimulator) {
+                this.xrButton?.domElement.remove();
+                shouldAutostartSimulator = true;
+            }
+        });
         await this.webXRSessionManager.initialize();
         // Sets up postprocessing effects.
         if (options.usePostprocessing) {
@@ -14723,7 +14727,6 @@ class Core {
      * scripts.
      */
     onXRSessionEnded() {
-        this.startSimulator();
         this.scriptsManager.onXRSessionEnded();
     }
     /**
@@ -16825,5 +16828,5 @@ class VideoFileStream extends VideoStream {
     }
 }
 
-export { AI, AIOptions, AVERAGE_IPD_METERS, ActiveControllers, Agent, AnimatableNumber, AudioListener, AudioPlayer, BACK, BackgroundMusic, CategoryVolumes, Col, Core, CoreSound, DEFAULT_DEVICE_CAMERA_HEIGHT, DEFAULT_DEVICE_CAMERA_WIDTH, DOWN, Depth, DepthMesh, DepthMeshOptions, DepthOptions, DepthTextures, DetectedObject, DetectedPlane, DeviceCameraOptions, DragManager, DragMode, ExitButton, FORWARD, FreestandingSlider, GazeController, Gemini, GeminiOptions, GenerateSkyboxTool, GestureRecognition, GestureRecognitionOptions, GetWeatherTool, Grid, HAND_BONE_IDX_CONNECTION_MAP, HAND_JOINT_COUNT, HAND_JOINT_IDX_CONNECTION_MAP, HAND_JOINT_NAMES, Handedness, Hands, HandsOptions, HorizontalPager, IconButton, IconView, ImageView, Input, InputOptions, Keycodes, LEFT, LEFT_VIEW_ONLY_LAYER, LabelView, Lighting, LightingOptions, LoadingSpinnerManager, MaterialSymbolsView, MeshScript, ModelLoader, ModelViewer, MouseController, NEXT_SIMULATOR_MODE, NUM_HANDS, OCCLUDABLE_ITEMS_LAYER, ObjectDetector, ObjectsOptions, OcclusionPass, OcclusionUtils, OpenAI, OpenAIOptions, Options, PageIndicator, Pager, PagerState, Panel, PanelMesh, Physics, PhysicsOptions, PinchOnButtonAction, PlaneDetector, PlanesOptions, RIGHT, RIGHT_VIEW_ONLY_LAYER, Registry, Reticle, ReticleOptions, RotationRaycastMesh, Row, SIMULATOR_HAND_POSE_NAMES, SIMULATOR_HAND_POSE_TO_JOINTS_LEFT, SIMULATOR_HAND_POSE_TO_JOINTS_RIGHT, SOUND_PRESETS, ScreenshotSynthesizer, Script, ScriptMixin, ScriptsManager, ScrollingTroikaTextView, SetSimulatorModeEvent, ShowHandsAction, Simulator, SimulatorCamera, SimulatorControlMode, SimulatorControllerState, SimulatorControls, SimulatorDepth, SimulatorDepthMaterial, SimulatorHandPose, SimulatorHandPoseChangeRequestEvent, SimulatorHands, SimulatorInterface, SimulatorMediaDeviceInfo, SimulatorMode, SimulatorOptions, SimulatorRenderMode, SimulatorScene, SimulatorUser, SimulatorUserAction, SketchPanel, SkyboxAgent, SoundOptions, SoundSynthesizer, SpatialAudio, SpatialPanel, SpeechRecognizer, SpeechRecognizerOptions, SpeechSynthesizer, SpeechSynthesizerOptions, SplatAnchor, StreamState, TextButton, TextScrollerState, TextView, Tool, UI, UI_OVERLAY_LAYER, UP, UX, User, VIEW_DEPTH_GAP, VerticalPager, VideoFileStream, VideoStream, VideoView, View, VolumeCategory, WaitFrame, WalkTowardsPanelAction, World, WorldOptions, XRButton, XRDeviceCamera, XREffects, XRPass, XRTransitionOptions, XR_BLOCKS_ASSETS_PATH, ZERO_VECTOR3, add, ai, aspectRatios, callInitWithDependencyInjection, clamp, clampRotationToAngle, core, cropImage, extractYaw, getColorHex, getDeltaTime, getUrlParamBool, getUrlParamFloat, getUrlParamInt, getUrlParameter, getVec4ByColorString, getXrCameraLeft, getXrCameraRight, init, initScript, lerp, loadStereoImageAsTextures, loadingSpinnerManager, lookAtRotation, objectIsDescendantOf, onDesktopUserAgent, parseBase64DataURL, placeObjectAtIntersectionFacingTarget, print, rgbToDepthParams, scene, showOnlyInLeftEye, showOnlyInRightEye, showReticleOnDepthMesh, transformRgbToDepthUv, transformRgbUvToWorld, traverseUtil, uninitScript, urlParams, user, world, xrDepthMeshOptions, xrDepthMeshPhysicsOptions, xrDepthMeshVisualizationOptions, xrDeviceCameraEnvironmentContinuousOptions, xrDeviceCameraEnvironmentOptions, xrDeviceCameraUserContinuousOptions, xrDeviceCameraUserOptions };
+export { AI, AIOptions, AVERAGE_IPD_METERS, ActiveControllers, Agent, AnimatableNumber, AudioListener, AudioPlayer, BACK, BackgroundMusic, CategoryVolumes, Col, Core, CoreSound, DEFAULT_DEVICE_CAMERA_HEIGHT, DEFAULT_DEVICE_CAMERA_WIDTH, DOWN, Depth, DepthMesh, DepthMeshOptions, DepthOptions, DepthTextures, DetectedObject, DetectedPlane, DeviceCameraOptions, DragManager, DragMode, ExitButton, FORWARD, FreestandingSlider, GazeController, Gemini, GeminiOptions, GenerateSkyboxTool, GestureRecognition, GestureRecognitionOptions, GetWeatherTool, Grid, HAND_BONE_IDX_CONNECTION_MAP, HAND_JOINT_COUNT, HAND_JOINT_IDX_CONNECTION_MAP, HAND_JOINT_NAMES, Handedness, Hands, HandsOptions, HorizontalPager, IconButton, IconView, ImageView, Input, InputOptions, Keycodes, LEFT, LEFT_VIEW_ONLY_LAYER, LabelView, Lighting, LightingOptions, LoadingSpinnerManager, MaterialSymbolsView, MeshScript, ModelLoader, ModelViewer, MouseController, NEXT_SIMULATOR_MODE, NUM_HANDS, OCCLUDABLE_ITEMS_LAYER, ObjectDetector, ObjectsOptions, OcclusionPass, OcclusionUtils, OpenAI, OpenAIOptions, Options, PageIndicator, Pager, PagerState, Panel, PanelMesh, Physics, PhysicsOptions, PinchOnButtonAction, PlaneDetector, PlanesOptions, RIGHT, RIGHT_VIEW_ONLY_LAYER, Registry, Reticle, ReticleOptions, RotationRaycastMesh, Row, SIMULATOR_HAND_POSE_NAMES, SIMULATOR_HAND_POSE_TO_JOINTS_LEFT, SIMULATOR_HAND_POSE_TO_JOINTS_RIGHT, SOUND_PRESETS, ScreenshotSynthesizer, Script, ScriptMixin, ScriptsManager, ScrollingTroikaTextView, SetSimulatorModeEvent, ShowHandsAction, Simulator, SimulatorCamera, SimulatorControlMode, SimulatorControllerState, SimulatorControls, SimulatorDepth, SimulatorDepthMaterial, SimulatorHandPose, SimulatorHandPoseChangeRequestEvent, SimulatorHands, SimulatorInterface, SimulatorMediaDeviceInfo, SimulatorMode, SimulatorOptions, SimulatorRenderMode, SimulatorScene, SimulatorUser, SimulatorUserAction, SketchPanel, SkyboxAgent, SoundOptions, SoundSynthesizer, SpatialAudio, SpatialPanel, SpeechRecognizer, SpeechRecognizerOptions, SpeechSynthesizer, SpeechSynthesizerOptions, SplatAnchor, StreamState, TextButton, TextScrollerState, TextView, Tool, UI, UI_OVERLAY_LAYER, UP, UX, User, VIEW_DEPTH_GAP, VerticalPager, VideoFileStream, VideoStream, VideoView, View, VolumeCategory, WaitFrame, WalkTowardsPanelAction, World, WorldOptions, XRButton, XRDeviceCamera, XREffects, XRPass, XRTransitionOptions, XR_BLOCKS_ASSETS_PATH, ZERO_VECTOR3, add, ai, aspectRatios, callInitWithDependencyInjection, clamp, clampRotationToAngle, core, cropImage, extractYaw, getColorHex, getDeltaTime, getUrlParamBool, getUrlParamFloat, getUrlParamInt, getUrlParameter, getVec4ByColorString, getXrCameraLeft, getXrCameraRight, init, initScript, lerp, loadStereoImageAsTextures, loadingSpinnerManager, lookAtRotation, objectIsDescendantOf, parseBase64DataURL, placeObjectAtIntersectionFacingTarget, print, rgbToDepthParams, scene, showOnlyInLeftEye, showOnlyInRightEye, showReticleOnDepthMesh, transformRgbToDepthUv, transformRgbUvToWorld, traverseUtil, uninitScript, urlParams, user, world, xrDepthMeshOptions, xrDepthMeshPhysicsOptions, xrDepthMeshVisualizationOptions, xrDeviceCameraEnvironmentContinuousOptions, xrDeviceCameraEnvironmentOptions, xrDeviceCameraUserContinuousOptions, xrDeviceCameraUserOptions };
 //# sourceMappingURL=xrblocks.js.map