@newgameplusinc/odyssey-audio-video-sdk-dev 1.0.25 → 1.0.26

package/README.md

@@ -83,6 +83,8 @@ sdk.setListenerFromLSD(listenerPos, cameraPos, lookAtPos);
 
 #### Noise-Cancellation Stack (What’s Included)
 1. **Adaptive denoiser worklet** – learns each participant’s noise floor in real time, then applies a multi-band downward expander plus dynamic low/high-pass shaping.
+	- `speechBoost` lifts the low/mid band only when speech confidence is high, keeping consonants bright without reintroducing floor noise.
+	- `highBandGate` + `highBandAttack/Release` clamp constant fan hiss in the 4–12 kHz band whenever speechPresence is low, so background whoosh never leaks through live mics.
 2. **Optional voice enhancement** – autocorrelation-derived confidence (inspired by the tuner article) can raise the reduction floor when speech is present to keep vocals bright.
 3. **Silence gate** – if energy stays below `silenceFloor` for a configurable hold window, the track ramps to true silence, then wakes instantly once voice energy returns.
 4. **Classic filters** – fixed high-pass/low-pass filters shave off rumble and hiss before signals reach the HRTF panner.
@@ -101,6 +103,10 @@ These layers run entirely in Web Audio, so you can ship “AirPods-style” back
 			silenceFloor: 0.00075,
 			silenceHoldMs: 520,
 			silenceReleaseMs: 160,
+			speechBoost: 0.35,
+			highBandGate: 0.7,
+			highBandAttack: 0.25,
+			highBandRelease: 0.12,
 		},
 	});
 	```

package/dist/SpatialAudioManager.d.ts

@@ -23,6 +23,10 @@ type DenoiserOptions = {
     silenceFloor?: number;
     silenceHoldMs?: number;
     silenceReleaseMs?: number;
+    speechBoost?: number;
+    highBandGate?: number;
+    highBandAttack?: number;
+    highBandRelease?: number;
 };
 export type SpatialAudioOptions = {
     distance?: SpatialAudioDistanceConfig;

package/dist/SpatialAudioManager.js

@@ -94,6 +94,10 @@ class SpatialAudioManager extends EventManager_1.EventManager {
                         silenceFloor: this.options.denoiser?.silenceFloor,
                         silenceHoldMs: this.options.denoiser?.silenceHoldMs,
                         silenceReleaseMs: this.options.denoiser?.silenceReleaseMs,
+                        speechBoost: this.options.denoiser?.speechBoost,
+                        highBandGate: this.options.denoiser?.highBandGate,
+                        highBandAttack: this.options.denoiser?.highBandAttack,
+                        highBandRelease: this.options.denoiser?.highBandRelease,
                     },
                 });
             }
@@ -603,6 +607,10 @@ class SpatialAudioManager extends EventManager_1.EventManager {
     this.voiceBoost = this._sanitize(cfg.voiceBoost, 0, 1, 0.6);
     this.voiceSensitivity = this._sanitize(cfg.voiceSensitivity, 0.05, 0.9, 0.35);
     this.voiceEnhancement = cfg.voiceEnhancement === true;
+    this.speechBoost = this._sanitize(cfg.speechBoost, 0, 1.5, 0.35);
+    this.highBandGate = this._sanitize(cfg.highBandGate, 0, 1, 0.7);
+    this.highBandAttack = this._sanitize(cfg.highBandAttack, 0.01, 1, 0.25);
+    this.highBandRelease = this._sanitize(cfg.highBandRelease, 0.01, 1, 0.12);
     this.silenceFloor = this._sanitize(cfg.silenceFloor, 0.0002, 0.02, 0.00085);
     this.gateGraceSamples = Math.round(sampleRate * 0.45);
     this.postSpeechHoldSamples = Math.round(sampleRate * 0.35);
@@ -649,6 +657,8 @@ class SpatialAudioManager extends EventManager_1.EventManager {
         muteGain: 1,
         graceSamplesRemaining: this.gateGraceSamples,
         postSpeechHold: 0,
+        highBandEnv: this.silenceFloor,
+        broadbandEnv: this.silenceFloor,
       };
     }
     return this.channelState[index];
@@ -820,13 +830,27 @@ class SpatialAudioManager extends EventManager_1.EventManager {
         let processed = sample * state.gain;
 
         state.lpState = this.hfAlpha * state.lpState + (1 - this.hfAlpha) * processed;
-        const highComponent = processed - state.lpState;
+        const lowComponent = state.lpState;
+        const highComponent = processed - lowComponent;
+
+        // Track broadband/high-band envelopes for multi-band gating
+        state.broadbandEnv += (Math.abs(processed) - state.broadbandEnv) * 0.12;
+        const highEnvDelta = Math.abs(highComponent) - state.highBandEnv;
+        const highEnvCoef = highEnvDelta > 0 ? this.highBandAttack : this.highBandRelease;
+        state.highBandEnv += highEnvDelta * highEnvCoef;
+
         const hissRatio = Math.min(
           1,
-          Math.abs(highComponent) / (Math.abs(state.lpState) + 1e-5)
+          Math.abs(highComponent) / (Math.abs(lowComponent) + 1e-5)
         );
         const hissGain = 1 - hissRatio * (this.hissCut * (1 - 0.4 * speechPresence));
-        processed = state.lpState + highComponent * hissGain;
+
+        const highEnvRatio = state.highBandEnv / (state.broadbandEnv + 1e-5);
+        const gateAmount = this.highBandGate * Math.max(0, highEnvRatio - speechPresence * 0.5);
+        const gatedHigh = highComponent * hissGain * (1 - gateAmount);
+
+        const speechLift = 1 + this.speechBoost * speechPresence;
+        processed = lowComponent * speechLift + gatedHigh;
 
         const muteTarget = state.isSilenced ? 0.05 : 1;
         const smoothing = state.isSilenced ? 0.12 : 0.42;
@@ -885,6 +909,10 @@ registerProcessor('odyssey-denoise', OdysseyDenoiseProcessor);
             silenceFloor: 0.00075,
             silenceHoldMs: 520,
             silenceReleaseMs: 160,
+            speechBoost: 0.35,
+            highBandGate: 0.7,
+            highBandAttack: 0.25,
+            highBandRelease: 0.12,
         };
         return {
             distance: {
@@ -910,6 +938,10 @@ registerProcessor('odyssey-denoise', OdysseyDenoiseProcessor);
                 silenceFloor: options?.denoiser?.silenceFloor ?? denoiserDefaults.silenceFloor,
                 silenceHoldMs: options?.denoiser?.silenceHoldMs ?? denoiserDefaults.silenceHoldMs,
                 silenceReleaseMs: options?.denoiser?.silenceReleaseMs ?? denoiserDefaults.silenceReleaseMs,
+                speechBoost: options?.denoiser?.speechBoost ?? denoiserDefaults.speechBoost,
+                highBandGate: options?.denoiser?.highBandGate ?? denoiserDefaults.highBandGate,
+                highBandAttack: options?.denoiser?.highBandAttack ?? denoiserDefaults.highBandAttack,
+                highBandRelease: options?.denoiser?.highBandRelease ?? denoiserDefaults.highBandRelease,
             },
         };
     }

package/package.json

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