@newgameplusinc/odyssey-audio-video-sdk-dev 1.0.63 → 1.0.64

package/README.md

@@ -78,7 +78,7 @@ sdk.setListenerFromLSD(listenerPos, cameraPos, lookAtPos);
 ### Web Audio Algorithms
 - **Coordinate normalization** – Unreal sends centimeters; `SpatialAudioManager` auto-detects large values and converts to meters once.
 - **Orientation math** – `setListenerFromLSD()` builds forward/right/up vectors from camera/LookAt to keep the listener aligned with head movement.
-- **Dynamic distance gain** – `updateSpatialAudio()` measures distance from listener → source and applies a smooth rolloff curve, so distant avatars fade to silence.
+- **Dynamic distance gain** – `updateSpatialAudio()` measures distance from listener → source and applies a quadratic rolloff curve (0.5m-10m range). Voices gradually fade from 100% (0.5m clear) to complete silence at 10m+. Distance calculated from listener's HEAD position to participant's standing position.
 - **Noise handling** – the AudioWorklet denoiser now runs an adaptive multi-band gate (per W3C AudioWorklet guidance) before the high/low-pass filters, stripping constant HVAC/fan noise even when the speaker is close. A newly added silence gate mutes tracks entirely after ~250 ms of sub-noise-floor energy, eliminating hiss during dead air without touching spatial cues.
 
 #### Noise-Cancellation Stack (What’s Included)

package/dist/SpatialAudioManager.d.ts

@@ -181,13 +181,13 @@ export declare class SpatialAudioManager extends EventManager {
     /**
      * Calculate gain based on distance using logarithmic scale
      * Distance range: 0.5m to 5m
-     * Gain range: 100% to 0%
+     * Gain range: 100% to 20% (never goes to 0 for better audibility)
      * Uses quadratic equation for human ear perception
      */
     private calculateLogarithmicGain;
     /**
-     * Apply stereo panning to participant audio
-     * Converts panning percentages to StereoPanner values
+     * Apply stereo panning to participant audio using StereoPannerNode
+     * This provides STABLE left-right panning without jitter
      */
     private applyStereoPanning;
     private ensureDenoiseWorklet;

package/dist/SpatialAudioManager.js

@@ -99,6 +99,7 @@ class SpatialAudioManager extends EventManager_1.EventManager {
         const stream = new MediaStream([track]);
         const source = this.audioContext.createMediaStreamSource(stream);
         const panner = this.audioContext.createPanner();
+        const stereoPanner = this.audioContext.createStereoPanner(); // For stable L/R panning
         const analyser = this.audioContext.createAnalyser();
         const gain = this.audioContext.createGain();
         const proximityGain = this.audioContext.createGain();
@@ -181,13 +182,13 @@ class SpatialAudioManager extends EventManager_1.EventManager {
         panner.coneOuterAngle = 360;
         panner.coneOuterGain = 0.3; // Some sound even outside cone
         // Configure gain for individual participant volume control
-        gain.gain.value = 1.0;
+        gain.gain.value = 1.5; // Boost initial gain (was 1.0)
         // ADD COMPRESSOR: Prevents sudden peaks and "pops" when speaking starts
         // This is KEY to eliminating onset artifacts
         const participantCompressor = this.audioContext.createDynamicsCompressor();
-        participantCompressor.threshold.value = -24; // Start compressing at -24dB
+        participantCompressor.threshold.value = -30; // Higher threshold (less compression)
         participantCompressor.knee.value = 10; // Smooth knee for natural sound
-        participantCompressor.ratio.value = 3; // 3:1 compression ratio
+        participantCompressor.ratio.value = 2; // 2:1 gentle ratio (was 3:1)
         participantCompressor.attack.value = 0.003; // 3ms fast attack for transients
         participantCompressor.release.value = 0.15; // 150ms release for natural decay
         let currentNode = source;
@@ -210,9 +211,10 @@ class SpatialAudioManager extends EventManager_1.EventManager {
             analyser.connect(this.masterGainNode);
         }
         else {
-            // Standard spatialized path with full audio chain
-            // Audio Chain: source -> filters -> panner -> analyser -> gain -> masterGain -> compressor -> destination
-            proximityGain.connect(panner);
+            // Standard spatialized path with stereo panner
+            // Audio Chain: source -> compressor -> filters -> stereoPanner -> panner -> analyser -> gain -> masterGain -> compressor -> destination
+            proximityGain.connect(stereoPanner); // Stereo panner for stable L/R
+            stereoPanner.connect(panner); // Then 3D panner for distance
             panner.connect(analyser);
             analyser.connect(gain);
             gain.connect(this.masterGainNode);
@@ -220,6 +222,7 @@ class SpatialAudioManager extends EventManager_1.EventManager {
         this.participantNodes.set(participantId, {
             source,
             panner,
+            stereoPanner,
             analyser,
             gain,
             proximityGain,
@@ -330,11 +333,10 @@ class SpatialAudioManager extends EventManager_1.EventManager {
             // Use exponentialRampToValueAtTime for smoother, more natural transitions
             // This prevents the "pop" when someone starts speaking
             const currentTime = this.audioContext.currentTime;
-            const rampTime = 0.08; // 80ms smooth ramp (was 50ms - increased for gentler onset)
+            const rampTime = 0.08; // 80ms smooth ramp
             // Ensure we never ramp to exactly 0 (causes issues)
-            const targetGain = Math.max(0.001, gainValue);
+            const targetGain = Math.max(0.2, gainValue); // Minimum 20% gain (was 0.001)
             nodes.gain.gain.setTargetAtTime(targetGain, currentTime, rampTime);
-            nodes.proximityGain.gain.setTargetAtTime(targetGain, currentTime, rampTime);
             // Update 3D position for PannerNode (still used for vertical positioning)
             nodes.panner.positionY.setValueAtTime(normalizedPosition.y, this.audioContext.currentTime);
             nodes.panner.positionZ.setValueAtTime(normalizedPosition.z, this.audioContext.currentTime);
@@ -747,32 +749,31 @@ class SpatialAudioManager extends EventManager_1.EventManager {
     /**
      * Calculate gain based on distance using logarithmic scale
      * Distance range: 0.5m to 5m
-     * Gain range: 100% to 0%
+     * Gain range: 100% to 20% (never goes to 0 for better audibility)
      * Uses quadratic equation for human ear perception
      */
     calculateLogarithmicGain(distance) {
-        const minDistance = 0.5; // meters
-        const maxDistance = 5.0; // meters
+        const minDistance = 0.5; // meters - clear voice starts here
+        const maxDistance = 10.0; // meters - complete silence beyond this
         // Clamp distance
         if (distance <= minDistance)
-            return 100;
+            return 100; // Full volume at 0.5m or closer
         if (distance >= maxDistance)
-            return 0;
+            return 0; // Complete silence at 10m or beyond
         // Normalize distance to 0-1 range
         const normalizedDistance = (distance - minDistance) / (maxDistance - minDistance);
         // Apply quadratic falloff for natural perception
-        // gain = 100 * (1 - x²)
-        // This creates a logarithmic-like curve that sounds linear to human ear
+        // gain = 100 * (1 - x²) - gradual fade from 100% to 0%
         const gain = 100 * Math.pow(1 - normalizedDistance, 2);
-        return Math.max(0, Math.min(100, gain));
+        return Math.max(0, Math.min(100, gain)); // Clamp between 0-100%
     }
     /**
-     * Apply stereo panning to participant audio
-     * Converts panning percentages to StereoPanner values
+     * Apply stereo panning to participant audio using StereoPannerNode
+     * This provides STABLE left-right panning without jitter
      */
     applyStereoPanning(participantId, panning) {
         const nodes = this.participantNodes.get(participantId);
-        if (!nodes?.panner)
+        if (!nodes?.stereoPanner)
             return;
         // Convert left/right percentages to pan value (-1 to +1)
         // If left=100, right=0 → pan = -1 (full left)
@@ -785,9 +786,10 @@ class SpatialAudioManager extends EventManager_1.EventManager {
         if (leftRatio + rightRatio > 0) {
             panValue = (rightRatio - leftRatio);
         }
-        // Adjust X position for left-right panning (-1 = left, +1 = right)
+        // Use StereoPannerNode for stable, glitch-free panning
+        // This is MUCH more stable than manipulating PannerNode.positionX
         const currentTime = this.audioContext.currentTime;
-        nodes.panner.positionX.setTargetAtTime(panValue * 5, currentTime, 0.05);
+        nodes.stereoPanner.pan.setTargetAtTime(panValue, currentTime, 0.05);
     }
     async ensureDenoiseWorklet() {
         if (!this.isDenoiserEnabled()) {

package/package.json

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