@newgameplusinc/odyssey-audio-video-sdk-dev 1.0.263 → 1.0.265

package/dist/channels/spatial/SpatialAudioChannel.d.ts

@@ -27,6 +27,10 @@ export declare class SpatialAudioChannel {
     private positionCache;
     private panSmoother;
     private isMasterMuted;
+    private lastGainValues;
+    private lastPanValues;
+    private readonly GAIN_CHANGE_THRESHOLD;
+    private readonly PAN_CHANGE_THRESHOLD;
     private mlNoiseSuppressor;
     private noiseSuppressionMode;
     constructor(config?: SpatialAudioConfig);
@@ -40,6 +44,7 @@ export declare class SpatialAudioChannel {
     setupParticipant(participantId: string, track: MediaStreamTrack, bypassSpatialization?: boolean): Promise<void>;
     /**
      * Update spatial audio for a participant
+     * OPTIMIZED: Only updates gain/pan when values change significantly
      */
     updateSpatialAudio(participantId: string, position: Position, direction?: {
         x: number;

package/dist/channels/spatial/SpatialAudioChannel.js

@@ -29,6 +29,11 @@ class SpatialAudioChannel {
             initialized: false,
         };
         this.isMasterMuted = false;
+        // Gain/Pan caching to prevent unnecessary audio parameter updates
+        this.lastGainValues = new Map();
+        this.lastPanValues = new Map();
+        this.GAIN_CHANGE_THRESHOLD = 0.02; // 2% change required to update
+        this.PAN_CHANGE_THRESHOLD = 0.03; // 3% change required to update
         // ML Noise Suppression
         this.mlNoiseSuppressor = null;
         this.noiseSuppressionMode = 'none';
@@ -38,13 +43,13 @@ class SpatialAudioChannel {
         // Master gain
         this.masterGainNode = this.audioContext.createGain();
         this.masterGainNode.gain.value = 1.0;
-        // Master compressor
+        // Master compressor - gentle settings for voice clarity
         this.compressor = this.audioContext.createDynamicsCompressor();
-        this.compressor.threshold.value = -15;
-        this.compressor.knee.value = 40;
-        this.compressor.ratio.value = 2.5;
-        this.compressor.attack.value = 0.02;
-        this.compressor.release.value = 0.25;
+        this.compressor.threshold.value = -24; // Higher threshold - only compress loud peaks
+        this.compressor.knee.value = 30; // Soft knee for natural transition
+        this.compressor.ratio.value = 3; // Gentle ratio for voice
+        this.compressor.attack.value = 0.003; // 3ms attack - catch transients but not too fast
+        this.compressor.release.value = 0.25; // 250ms release - smooth recovery
         // Connect master chain
         this.masterGainNode.connect(this.compressor);
         this.compressor.connect(this.audioContext.destination);
@@ -124,9 +129,13 @@ class SpatialAudioChannel {
             dynamicLowpass,
             stream,
         });
+        // Initialize gain cache for this participant at full volume
+        this.lastGainValues.set(participantId, 1.0);
+        this.lastPanValues.set(participantId, 0);
     }
     /**
      * Update spatial audio for a participant
+     * OPTIMIZED: Only updates gain/pan when values change significantly
      */
     updateSpatialAudio(participantId, position, direction) {
         const nodes = this.participantNodes.get(participantId);
@@ -140,7 +149,11 @@ class SpatialAudioChannel {
         const distance = (0, distance_calc_1.getDistanceBetween)(listenerPos, speakerHead);
         // Hard cutoff at max distance
         if (distance >= this.distanceConfig.maxDistance) {
-            (0, gain_smoothing_1.applyGainSmooth)(nodes.gain, 0, this.audioContext, 0.033);
+            const lastGain = this.lastGainValues.get(participantId) ?? 1.0;
+            if (lastGain > 0.01) {
+                (0, gain_smoothing_1.applyGainSmooth)(nodes.gain, 0, this.audioContext, 0.1);
+                this.lastGainValues.set(participantId, 0);
+            }
             return;
         }
         // Calculate pan
@@ -153,11 +166,21 @@ class SpatialAudioChannel {
             maxDistance: this.distanceConfig.maxDistance,
         });
         const gainValue = gainPercent / 100;
-        // Apply stereo panning
+        // Calculate pan value
         const panValue = (panning.right - panning.left) / 100;
-        (0, gain_smoothing_1.applyStereoPanSmooth)(nodes.stereoPanner, panValue, this.audioContext, 0.05);
-        // Apply gain
-        (0, gain_smoothing_1.applyGainSmooth)(nodes.gain, gainValue, this.audioContext, 0.1);
+        // OPTIMIZATION: Only apply pan if it changed significantly
+        const lastPan = this.lastPanValues.get(participantId) ?? 0;
+        if (Math.abs(panValue - lastPan) > this.PAN_CHANGE_THRESHOLD) {
+            (0, gain_smoothing_1.applyStereoPanSmooth)(nodes.stereoPanner, panValue, this.audioContext, 0.08);
+            this.lastPanValues.set(participantId, panValue);
+        }
+        // OPTIMIZATION: Only apply gain if it changed significantly
+        // This prevents continuous setTargetAtTime calls which cause audio instability
+        const lastGain = this.lastGainValues.get(participantId) ?? 1.0;
+        if (Math.abs(gainValue - lastGain) > this.GAIN_CHANGE_THRESHOLD) {
+            (0, gain_smoothing_1.applyGainSmooth)(nodes.gain, gainValue, this.audioContext, 0.15);
+            this.lastGainValues.set(participantId, gainValue);
+        }
     }
     /**
      * Set listener position from LSD data
@@ -316,6 +339,8 @@ class SpatialAudioChannel {
             this.participantNodes.delete(participantId);
             this.panSmoother.clear(participantId);
             this.positionCache.clear(participantId);
+            this.lastGainValues.delete(participantId);
+            this.lastPanValues.delete(participantId);
         }
     }
     /**
@@ -399,12 +424,13 @@ class SpatialAudioChannel {
         return { monoSplitter, monoGainL, monoGainR, monoMerger, stereoUpmixer };
     }
     createParticipantCompressor() {
+        // Per-participant compressor - light touch to preserve voice dynamics
         const compressor = this.audioContext.createDynamicsCompressor();
-        compressor.threshold.value = -6;
-        compressor.knee.value = 3;
-        compressor.ratio.value = 20;
-        compressor.attack.value = 0.001;
-        compressor.release.value = 0.05;
+        compressor.threshold.value = -18; // Only compress loud speech
+        compressor.knee.value = 12; // Soft knee for natural sound
+        compressor.ratio.value = 4; // Moderate ratio (was 20:1 - way too aggressive)
+        compressor.attack.value = 0.003; // 3ms attack - catch transients naturally
+        compressor.release.value = 0.15; // 150ms release - smooth recovery, no pumping
         return compressor;
     }
     createFilters() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newgameplusinc/odyssey-audio-video-sdk-dev",
-  "version": "1.0.263",
+  "version": "1.0.265",
   "description": "Odyssey Spatial Audio & Video SDK using MediaSoup for real-time communication",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",