opensips-js 0.1.14 → 0.1.16

package/README.md

@@ -243,11 +243,64 @@ Also, there are next public fields on OpensipsJS instance:
 - `isDND: Boolean` - returns if the agent is in "Do not disturb" status
 - `isMuted: Boolean` - returns if the agent is muted
 
-### Noise Reduction Options
+### Noise Reduction Options (VAD)
+
+**Important**: Voice Activity Detection (VAD) is an **optional feature** that requires installing an additional peer dependency. It is **NOT compatible with React Native**.
+
+#### For Web Applications (with VAD support)
+
+Install the VAD library:
+```bash
+npm install @ricky0123/vad-web
+# or
+yarn add @ricky0123/vad-web
+```
+
+Then import and inject it in your configuration:
+```javascript
+import OpenSIPSJS from 'opensips-js'
+import * as VAD from '@ricky0123/vad-web'
+
+const opensipsJS = new OpenSIPSJS({
+  configuration: {
+    // ... other configuration
+    noiseReductionOptions: {
+      mode: 'dynamic', // or 'enabled'
+      noiseThreshold: 0.004,
+      checkEveryMs: 500,
+      noiseCheckInterval: 2000
+    },
+    vadModule: VAD  // Inject the VAD module
+  },
+  // ... rest of configuration
+})
+```
+
+#### For React Native Applications (VAD not supported)
+
+Simply omit the VAD module and disable noise reduction:
+```javascript
+import OpenSIPSJS from 'opensips-js'
+
+const opensipsJS = new OpenSIPSJS({
+  configuration: {
+    // ... other configuration
+    noiseReductionOptions: {
+      mode: 'disabled'  // or omit noiseReductionOptions entirely
+    }
+    // NO vadModule needed
+  },
+  // ... rest of configuration
+})
+```
+
+**See [VAD_USAGE.md](VAD_USAGE.md) and [EXAMPLES.md](EXAMPLES.md) for detailed usage examples.**
+
+#### Configuration Parameters
 
 | Parameter            | Type                             | Default    | Description                                                                                                                                                                                                                                                                                      |
 |----------------------|----------------------------------|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `mode`               | `disabled \| enabled \| dynamic` | `disabled` | Noice reduction mode                                                                                                                                                                                                                                                                             |
+| `mode`               | `disabled \| enabled \| dynamic` | `disabled` | Noise reduction mode. **Note**: `enabled` and `dynamic` modes require `vadModule` to be provided                                                                                                                                                                                                 |
 | `vadConfig`          | `Partial<RealTimeVADOptions>`    | `{}`       | VAD configuration                                                                                                                                                                                                                                                                                |
 | `noiseThreshold`     | `number`                         | `0.004`    | Noise threshold                                                                                                                                                                                                                                                                                  |
 | `noiseCheckInterval` | `number`                         | `2000`     | The interval, used to check if we need to disable/enable outgoing audio every N-milliseconds                                                                                                                                                                                                     |

package/dist/index.d.ts

@@ -75,6 +75,7 @@ declare class AudioModule {
     private vadIntervals;
     private vadMrsIntervals;
     private VUMeter;
+    private MicVAD;
     managedAudioContext: ManagedAudioContext;
     constructor(context: OpenSIPSJS);
     private processVADConfiguration;
@@ -978,6 +979,7 @@ declare type UAConfigurationExtended = UAConfiguration & {
     overrideUserAgent?: (userAgent: string) => string
     noiseReductionOptions?: NoiseReductionOptions
     onTransportCallback?: OnTransportCallback
+    vadModule?: VADModule
 }
 
 declare const UAConstructor: typeof UA;
@@ -1067,6 +1069,10 @@ declare interface UAExtendedInterface_2 extends UA {
 
 declare type updateRoomListener = (value: RoomChangeEmitType) => void
 
+declare interface VADModule {
+    MicVAD: any
+}
+
 declare interface VADOptions {
     model: 'v5' | 'legacy'
     positiveSpeechThreshold: number