@iwsdk/core 0.1.0

package/dist/audio/audio-system.js

@@ -0,0 +1,478 @@
+import { AudioListener, PositionalAudio } from 'three';
+import { AssetManager } from '../asset/asset-manager.js';
+import '../asset/cache-manager.js';
+import { createSystem } from '../ecs/system.js';
+import '../ecs/world.js';
+import { Types } from 'elics';
+import '../ecs/component-registry.js';
+import { AudioPool } from './audio-pool.js';
+import { AudioSource, PlaybackMode, InstanceStealPolicy } from './audio.js';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Runtime audio manager that loads sources, pools players, and applies XR-aware behavior.
+ *
+ * @remarks
+ * - Creates an `AudioListener` on the player head and resumes/suspends the
+ *   audio context when XR sessions start/end.
+ * - Pools `Audio`/`PositionalAudio` instances per entity to minimize allocations
+ *   and implements play/overlap/fade-restart behaviors.
+ * - Optionally culls distant positional audio by a distance multiplier.
+ *
+ * @category Audio
+ */
+class AudioSystem extends createSystem({
+    audioEntities: { required: [AudioSource] },
+}, {
+    /** Enable distance-based culling for positional audio instances. */
+    enableDistanceCulling: { type: Types.Boolean, default: true },
+    /** Multiplier applied to `maxDistance` for culling threshold. */
+    cullingDistanceMultiplier: { type: Types.Float32, default: 1.5 },
+}) {
+    constructor() {
+        super(...arguments);
+        this.activeInstances = new Map();
+        this.onXRSessionStart = () => {
+            // Resume audio context when entering XR
+            const context = this.listener.context;
+            if (context.state === 'suspended') {
+                context.resume();
+            }
+            // Resume audio that was paused by session end
+            for (const [, instances] of this.activeInstances) {
+                instances.forEach((instance) => {
+                    if (instance.pausedBySessionEnd) {
+                        instance.audio.play();
+                        instance.pausedBySessionEnd = false;
+                    }
+                });
+            }
+        };
+        this.onXRSessionEnd = () => {
+            // Pause all active audio when exiting XR
+            for (const [, instances] of this.activeInstances) {
+                instances.forEach((instance) => {
+                    if (instance.audio.isPlaying) {
+                        instance.audio.pause();
+                        instance.pausedBySessionEnd = true;
+                    }
+                });
+            }
+            // Suspend audio context to save resources
+            const context = this.listener.context;
+            if (context.state === 'running') {
+                context.suspend();
+            }
+        };
+    }
+    init() {
+        // Create and attach AudioListener to camera
+        this.listener = new AudioListener();
+        this.player.head.add(this.listener);
+        // Handle XR session changes
+        this.renderer.xr.addEventListener('sessionstart', this.onXRSessionStart);
+        this.renderer.xr.addEventListener('sessionend', this.onXRSessionEnd);
+        // Handle entity lifecycle
+        this.queries.audioEntities.subscribe('disqualify', (entity) => {
+            this.cleanupEntity(entity);
+        });
+    }
+    update(_delta, _time) {
+        const time = _time;
+        const entities = this.queries.audioEntities.entities;
+        // Early exit if no audio entities
+        if (entities.size === 0) {
+            return;
+        }
+        entities.forEach((entity) => {
+            const index = entity.index;
+            // Handle audio loading
+            if (!AudioSource.data._loaded[index] &&
+                !AudioSource.data._loading[index]) {
+                const src = AudioSource.data.src[index];
+                if (src) {
+                    this.loadAudio(entity, src);
+                }
+                return; // Skip further processing until loaded
+            }
+            // Skip if not loaded yet
+            if (!AudioSource.data._loaded[index]) {
+                return;
+            }
+            // Create pool if needed
+            if (!AudioSource.data._pool[index]) {
+                this.createPool(entity);
+            }
+            // Handle playback requests
+            this.handlePlaybackRequests(entity, time);
+            // Update active instances
+            this.updateActiveInstances(entity, time);
+            // Handle autoplay (only trigger once, not loop)
+            if (AudioSource.data.autoplay[index] &&
+                !AudioSource.data._isPlaying[index] &&
+                AudioSource.data._playRequested[index] === 0 // Only if not already requested
+            ) {
+                AudioSource.data._playRequested[index] = 1;
+                // Disable autoplay after first trigger to prevent looping
+                AudioSource.data.autoplay[index] = 0;
+            }
+        });
+    }
+    async loadAudio(entity, src) {
+        const index = entity.index;
+        AudioSource.data._loading[index] = 1;
+        try {
+            // Try to get from AssetManager cache first (fast path)
+            let buffer = AssetManager.getAudio(src);
+            if (!buffer) {
+                // Load if not in cache (handles caching automatically)
+                buffer = await AssetManager.loadAudio(src);
+            }
+            // TODO: Add AssetManager.retain(src) when memory management is implemented
+            AudioSource.data._buffer[index] = buffer;
+            AudioSource.data._loaded[index] = 1;
+        }
+        catch (error) {
+            console.error(`Failed to load audio: ${src}`, error);
+        }
+        finally {
+            AudioSource.data._loading[index] = 0;
+        }
+    }
+    createPool(entity) {
+        const index = entity.index;
+        const maxInstances = AudioSource.data.maxInstances[index];
+        const positional = AudioSource.data.positional[index];
+        // Get entity's Object3D
+        const parent = entity.object3D || this.scene;
+        // Auto-calculate pool size from maxInstances (no need for separate poolSize config)
+        const poolSize = maxInstances;
+        const pool = positional === 1
+            ? new AudioPool(this.listener, poolSize, true, parent)
+            : new AudioPool(this.listener, poolSize, false, parent);
+        AudioSource.data._pool[index] = pool;
+        // Configure spatial properties for all instances
+        if (positional) {
+            const positionalPool = pool;
+            const instances = positionalPool.getAllInstances();
+            instances.forEach((audio) => {
+                audio.setRefDistance(AudioSource.data.refDistance[index]);
+                audio.setRolloffFactor(AudioSource.data.rolloffFactor[index]);
+                audio.setMaxDistance(AudioSource.data.maxDistance[index]);
+                audio.setDistanceModel(AudioSource.data.distanceModel[index]);
+                audio.setDirectionalCone(AudioSource.data.coneInnerAngle[index], AudioSource.data.coneOuterAngle[index], AudioSource.data.coneOuterGain[index]);
+            });
+        }
+    }
+    handlePlaybackRequests(entity, time) {
+        const index = entity.index;
+        // Handle stop request first
+        if (AudioSource.data._stopRequested[index]) {
+            this.stopAllInstances(entity);
+            AudioSource.data._stopRequested[index] = 0;
+            AudioSource.data._playRequested[index] = 0;
+            AudioSource.data._pauseRequested[index] = 0;
+            return;
+        }
+        // Handle pause request
+        if (AudioSource.data._pauseRequested[index]) {
+            const fadeOut = AudioSource.data._fadeOut[index];
+            this.pauseAllInstances(entity, fadeOut, time);
+            AudioSource.data._pauseRequested[index] = 0;
+            return;
+        }
+        // Handle play request
+        if (AudioSource.data._playRequested[index] &&
+            AudioSource.data._loaded[index]) {
+            const playbackMode = AudioSource.data.playbackMode[index];
+            const fadeIn = AudioSource.data._fadeIn[index];
+            switch (playbackMode) {
+                case PlaybackMode.Restart:
+                    this.playRestart(entity, fadeIn, time);
+                    break;
+                case PlaybackMode.Overlap:
+                    this.playOverlap(entity, fadeIn, time);
+                    break;
+                case PlaybackMode.Ignore:
+                    this.playIgnore(entity, fadeIn, time);
+                    break;
+                case PlaybackMode.FadeRestart:
+                    this.playFadeRestart(entity, time);
+                    break;
+            }
+            AudioSource.data._playRequested[index] = 0;
+        }
+    }
+    playRestart(entity, fadeIn, time) {
+        this.stopAllInstances(entity);
+        this.createAndPlayInstance(entity, fadeIn, time);
+    }
+    playOverlap(entity, fadeIn, time) {
+        const index = entity.index;
+        const instances = this.activeInstances.get(entity) || [];
+        const maxInstances = AudioSource.data.maxInstances[index];
+        if (instances.length < maxInstances) {
+            this.createAndPlayInstance(entity, fadeIn, time);
+        }
+        else {
+            // Apply steal policy
+            const policy = AudioSource.data.instanceStealPolicy[index];
+            this.stealInstance(entity, instances, policy, time);
+            this.createAndPlayInstance(entity, fadeIn, time);
+        }
+    }
+    playIgnore(entity, fadeIn, time) {
+        const instances = this.activeInstances.get(entity) || [];
+        if (instances.length === 0) {
+            this.createAndPlayInstance(entity, fadeIn, time);
+        }
+    }
+    playFadeRestart(entity, time) {
+        const index = entity.index;
+        const crossfadeDuration = AudioSource.data.crossfadeDuration[index];
+        const instances = this.activeInstances.get(entity) || [];
+        // Fade out existing instances
+        instances.forEach((instance) => {
+            instance.isFadingOut = true;
+            instance.fadeStartTime = time;
+            instance.fadeStartVolume = instance.audio.getVolume();
+            instance.fadeDuration = crossfadeDuration;
+        });
+        // Start new instance with fade in
+        this.createAndPlayInstance(entity, crossfadeDuration, time);
+    }
+    createAndPlayInstance(entity, fadeIn, time) {
+        const index = entity.index;
+        const pool = AudioSource.data._pool[index];
+        const buffer = AudioSource.data._buffer[index];
+        if (!pool || !buffer) {
+            return;
+        }
+        const audio = pool.acquire();
+        if (!audio) {
+            return;
+        }
+        // Set buffer and properties
+        audio.setBuffer(buffer);
+        const shouldLoop = AudioSource.data.loop[index] === 1;
+        audio.setLoop(shouldLoop);
+        audio.setVolume(fadeIn > 0 ? 0 : AudioSource.data.volume[index]);
+        // Create instance tracking
+        const instance = {
+            audio,
+            startTime: time,
+        };
+        if (fadeIn > 0) {
+            instance.isFadingIn = true;
+            instance.fadeStartTime = instance.startTime;
+            instance.fadeStartVolume = 0;
+            instance.fadeDuration = fadeIn;
+        }
+        // Add to active instances
+        const instances = this.activeInstances.get(entity) || [];
+        instances.push(instance);
+        this.activeInstances.set(entity, instances);
+        // Start playback
+        audio.play();
+        AudioSource.data._isPlaying[index] = 1;
+        // Handle onEnded - use audio.source.onended (the only method that works reliably)
+        if (audio.source) {
+            audio.source.onended = () => {
+                this.onInstanceEnded(entity, instance);
+            };
+        }
+        else {
+            // If source not available immediately, try after a short delay
+            setTimeout(() => {
+                if (audio.source) {
+                    audio.source.onended = () => {
+                        this.onInstanceEnded(entity, instance);
+                    };
+                }
+            }, 10);
+        }
+    }
+    updateActiveInstances(entity, time) {
+        const instances = this.activeInstances.get(entity);
+        if (!instances || instances.length === 0) {
+            return;
+        }
+        const index = entity.index;
+        const currentTime = time;
+        const targetVolume = AudioSource.data.volume[index];
+        // Update each instance
+        for (let i = instances.length - 1; i >= 0; i--) {
+            const instance = instances[i];
+            // Handle fade in
+            if (instance.isFadingIn &&
+                instance.fadeStartTime &&
+                instance.fadeDuration) {
+                const fadeProgress = (currentTime - instance.fadeStartTime) / instance.fadeDuration;
+                if (fadeProgress >= 1) {
+                    instance.audio.setVolume(targetVolume);
+                    instance.isFadingIn = false;
+                }
+                else {
+                    const currentVolume = targetVolume * fadeProgress;
+                    instance.audio.setVolume(currentVolume);
+                }
+            }
+            // Handle fade out
+            if (instance.isFadingOut &&
+                instance.fadeStartTime &&
+                instance.fadeDuration) {
+                const fadeProgress = (currentTime - instance.fadeStartTime) / instance.fadeDuration;
+                if (fadeProgress >= 1) {
+                    this.releaseInstance(entity, instance, i);
+                }
+                else {
+                    const startVolume = instance.fadeStartVolume || targetVolume;
+                    const currentVolume = startVolume * (1 - fadeProgress);
+                    instance.audio.setVolume(currentVolume);
+                }
+            }
+            // Update volume if it changed (and not currently fading)
+            if (!instance.isFadingIn && !instance.isFadingOut) {
+                const currentVolume = instance.audio.getVolume();
+                if (Math.abs(currentVolume - targetVolume) > 0.01) {
+                    instance.audio.setVolume(targetVolume);
+                }
+            }
+            // Update spatial properties if they changed
+            if (AudioSource.data.positional[index] &&
+                instance.audio instanceof PositionalAudio) {
+                if (instance.audio.getRefDistance() !==
+                    AudioSource.data.refDistance[index]) {
+                    instance.audio.setRefDistance(AudioSource.data.refDistance[index]);
+                }
+                instance.audio.setRolloffFactor(AudioSource.data.rolloffFactor[index]);
+                instance.audio.setMaxDistance(AudioSource.data.maxDistance[index]);
+            }
+        }
+        // Update playing state
+        AudioSource.data._isPlaying[index] = instances.length > 0 ? 1 : 0;
+    }
+    onInstanceEnded(entity, instance) {
+        const instances = this.activeInstances.get(entity);
+        if (!instances) {
+            return;
+        }
+        const instanceIndex = instances.indexOf(instance);
+        if (instanceIndex !== -1) {
+            this.releaseInstance(entity, instance, instanceIndex);
+        }
+    }
+    releaseInstance(entity, instance, instanceIndex) {
+        const index = entity.index;
+        const pool = AudioSource.data._pool[index];
+        const instances = this.activeInstances.get(entity);
+        // Release back to pool
+        pool.release(instance.audio);
+        // Remove from active instances
+        instances.splice(instanceIndex, 1);
+        if (instances.length === 0) {
+            this.activeInstances.delete(entity);
+            AudioSource.data._isPlaying[index] = 0;
+        }
+    }
+    stopAllInstances(entity) {
+        const instances = this.activeInstances.get(entity);
+        if (!instances) {
+            return;
+        }
+        const index = entity.index;
+        const pool = AudioSource.data._pool[index];
+        instances.forEach((instance) => {
+            pool.release(instance.audio);
+        });
+        this.activeInstances.delete(entity);
+        AudioSource.data._isPlaying[index] = 0;
+    }
+    pauseAllInstances(entity, fadeOut, time) {
+        const instances = this.activeInstances.get(entity);
+        if (!instances) {
+            return;
+        }
+        if (fadeOut > 0) {
+            instances.forEach((instance) => {
+                instance.isFadingOut = true;
+                instance.fadeStartTime = time;
+                instance.fadeStartVolume = instance.audio.getVolume();
+                instance.fadeDuration = fadeOut;
+            });
+        }
+        else {
+            instances.forEach((instance) => {
+                instance.audio.pause();
+            });
+        }
+    }
+    stealInstance(entity, instances, policy, _time) {
+        if (instances.length === 0) {
+            return;
+        }
+        let instanceToSteal;
+        switch (policy) {
+            case InstanceStealPolicy.Oldest:
+                instanceToSteal = instances[0];
+                break;
+            case InstanceStealPolicy.Quietest:
+                instanceToSteal = instances.reduce((quietest, current) => current.audio.getVolume() < quietest.audio.getVolume()
+                    ? current
+                    : quietest);
+                break;
+            case InstanceStealPolicy.Furthest:
+                // Implement distance-based stealing using camera position
+                const cameraPosition = this.player.head.position;
+                instanceToSteal = instances.reduce((furthest, current) => {
+                    const furthestDistance = furthest.audio.position
+                        ? cameraPosition.distanceTo(furthest.audio.position)
+                        : 0;
+                    const currentDistance = current.audio.position
+                        ? cameraPosition.distanceTo(current.audio.position)
+                        : 0;
+                    return currentDistance > furthestDistance ? current : furthest;
+                });
+                break;
+            default:
+                instanceToSteal = instances[0];
+        }
+        const instanceIndex = instances.indexOf(instanceToSteal);
+        this.releaseInstance(entity, instanceToSteal, instanceIndex);
+    }
+    cleanupEntity(entity) {
+        const instances = this.activeInstances.get(entity);
+        if (!instances) {
+            return;
+        }
+        const index = entity.index;
+        const pool = AudioSource.data._pool[index];
+        if (pool) {
+            instances.forEach((instance) => {
+                pool.release(instance.audio);
+            });
+            pool.dispose();
+        }
+        // TODO: Add AssetManager.release(src) when memory management is implemented
+        // const src = AudioSource.data.src[index];
+        // if (src) AssetManager.release(src);
+        this.activeInstances.delete(entity);
+    }
+    destroy() {
+        // Clean up all entities
+        for (const [entity] of this.activeInstances) {
+            this.cleanupEntity(entity);
+        }
+        // Remove event listeners
+        this.renderer.xr.removeEventListener('sessionstart', this.onXRSessionStart);
+        this.renderer.xr.removeEventListener('sessionend', this.onXRSessionEnd);
+    }
+}
+
+export { AudioSystem };
+//# sourceMappingURL=audio-system.js.map

package/dist/audio/audio-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-system.js","sources":["../../src/audio/audio-system.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/audio/audio-utils.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Entity } from '../ecs/index.js';
+import type { World } from '../ecs/index.js';
+/** Utility helpers to control {@link AudioSource} without touching Three audio.
+ * @category Audio
+ */
+export declare class AudioUtils {
+    /**
+     * Play audio on an entity
+     * @param entity - Entity with Audio component
+     * @param fadeIn - Fade in duration in seconds
+     */
+    static play(entity: Entity, fadeIn?: number): void;
+    /**
+     * Pause audio on an entity
+     * @param entity - Entity with Audio component
+     * @param fadeOut - Fade out duration in seconds
+     */
+    static pause(entity: Entity, fadeOut?: number): void;
+    /**
+     * Stop audio on an entity
+     * @param entity - Entity with Audio component
+     */
+    static stop(entity: Entity): void;
+    /**
+     * Check if audio is playing on an entity
+     * @param entity - Entity with Audio component
+     * @returns True if audio is playing
+     */
+    static isPlaying(entity: Entity): boolean;
+    /**
+     * Set volume on an entity's audio
+     * @param entity - Entity with Audio component
+     * @param volume - Volume level (0.0 to 1.0)
+     */
+    static setVolume(entity: Entity, volume: number): void;
+    /**
+     * Get volume from an entity's audio
+     * @param entity - Entity with Audio component
+     * @returns Current volume level
+     */
+    static getVolume(entity: Entity): number;
+    /**
+     * Preload audio for an entity
+     * @param entity - Entity with Audio component
+     * @returns Promise that resolves when audio is loaded
+     */
+    static preload(entity: Entity): Promise<void>;
+    /**
+     * Create a one-shot audio entity that auto-removes after playing
+     * @param world - World instance
+     * @param src - Audio source path
+     * @param options - Additional audio options
+     * @returns Created entity
+     */
+    static createOneShot(world: World, src: string, options?: {
+        volume?: number;
+        positional?: boolean;
+        position?: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    }): Entity;
+}
+//# sourceMappingURL=audio-utils.d.ts.map

package/dist/audio/audio-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-utils.d.ts","sourceRoot":"","sources":["../../src/audio/audio-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C;;GAEG;AACH,qBAAa,UAAU;IACrB;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,IAAI;IAY7C;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,IAAI;IAW/C;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUjC;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IASzC;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAUtD;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IASxC;;;;OAIG;WACU,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BnD;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAClB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3C,GACL,MAAM;CAqBV"}