@voltkit-rtc/react-native 0.1.5 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.1.6
+
+2026-11-06. WebRTC's own echo canceller by default on Android. Same peer dependencies as 0.1.5. Build the app again after
+upgrading: the setting is read from the manifest when the app starts, and the version check reads this package's version.
+
+- **WebRTC's echo canceller (AEC3) and noise suppressor by default** (`android.hardwareEchoCancellation` now defaults to
+  `false`; meta-data `in.voltkit.rtc.HW_AEC`). On Android, while WebRTC uses the phone's own canceller it switches its own
+  off, so the result depended on the phone: on an Oppo on the loudspeaker the person on the other phone heard themselves
+  with distortion, in this SDK and the Flutter one (a developer's finding, 2026-11-06). Agora and ZEGO tell developers to
+  use the SDK's canceller for such phones; theirs keep one, WebRTC does not. AEC3 is the canceller browsers use, and the
+  one this SDK's `react-native-webrtc` build carries. To keep the phone's, as before 0.1.6, set
+  `android: { hardwareEchoCancellation: true }` in the plugin options (or `in.voltkit.rtc.HW_AEC` to `true`). iOS is
+  unchanged: it uses the system's voice processing.
+
 ## 0.1.5
 
 2026-11-05. A developer's findings on 0.1.4, and the round of 2026-11-05 (decisions D2 and D10). Peer dependencies

package/README.md

@@ -134,7 +134,7 @@ you edit no native file:
 | `android.callServiceCamera` | `false` | Adds the `camera` type and `FOREGROUND_SERVICE_CAMERA`, for an app that keeps the camera on in the background (`background={{ pauseCamera: false }}`) |
 | `android.screenShare` | `false` | Turns on react-native-webrtc's screen-capture service for [screen sharing](#screen-sharing), with `FOREGROUND_SERVICE_MEDIA_PROJECTION` and the `mediaProjection` type on the call service |
 | `android.audioMode` | `"communication"` | `"media"` for an app whose users only listen: see [Audio routing](#audio-routing) |
-| `android.hardwareEchoCancellation` | `true` | The phone's own echo canceller and noise suppressor, where it has them |
+| `android.hardwareEchoCancellation` | `false` | `false` (the default from 0.1.6): WebRTC's own echo canceller and noise suppressor (AEC3). `true`: the phone's own, where it has them, as before 0.1.6. See [Echo on Android](#echo-on-android) |
 | `ios.backgroundAudio` | `true` | Adds `audio` to `UIBackgroundModes`, so a call keeps its sound in the background |
 | `ios.voip` | `false` | Adds `voip` to `UIBackgroundModes`, for an app that integrates CallKit itself |
 
@@ -741,11 +741,12 @@ export function OutputPicker() {
   tried again until the user picks it, a device is added, or the call ends.
 - **No Bluetooth permission** is needed: the routing goes through Android's
   `AudioManager`.
-- **Echo on one phone model.** The phone's own echo canceller and noise
-  suppressor are used where it has them. If one model echoes, turn them off with
-  the Expo plugin's `android.hardwareEchoCancellation: false` (or the
-  `in.voltkit.rtc.HW_AEC` meta-data, below), and WebRTC's own echo canceller
-  does the work.
+- **Echo cancellation.** From 0.1.6, WebRTC's own echo canceller and noise
+  suppressor (AEC3, the one browsers use), not the phone's built-in ones, which
+  some phones cannot run well on the loudspeaker.
+  `android: { hardwareEchoCancellation: true }` in the Expo plugin's options (or
+  the `in.voltkit.rtc.HW_AEC` meta-data, below) brings the phone's back. See
+  [Echo on Android](#echo-on-android).
 - **Apps whose users only listen** can set the audio mode to `media` (the
   plugin's `android.audioMode`, or the `in.voltkit.rtc.AUDIO_MODE` meta-data):
   sound plays at the media volume and on Bluetooth's high-quality profile, with
@@ -765,8 +766,8 @@ In a React Native app without Expo, the audio settings are meta-data in
 <application>
   <!-- communication (calls and audio rooms) or media (listen-only apps) -->
   <meta-data android:name="in.voltkit.rtc.AUDIO_MODE" android:value="communication" />
-  <!-- the phone's own echo canceller and noise suppressor, where it has them -->
-  <meta-data android:name="in.voltkit.rtc.HW_AEC" android:value="true" />
+  <!-- false: WebRTC's own echo canceller and noise suppressor (from 0.1.6); true: the phone's own, where it has them -->
+  <meta-data android:name="in.voltkit.rtc.HW_AEC" android:value="false" />
   <!-- react-native-webrtc's screen-capture service: see Screen sharing -->
   <meta-data android:name="in.voltkit.rtc.SCREEN_SHARE" android:value="false" />
 </application>
@@ -1433,12 +1434,42 @@ The emulator has only the loudspeaker, so `useAudioOutput().outputs` lists one
 output and `setSpeakerphoneOn(false)` has nowhere else to go. Test the earpiece
 and headsets on a phone.
 
-### Echo on one phone model
+### Echo on Android
 
-Turn off the phone's own echo canceller with the Expo plugin's
-`android.hardwareEchoCancellation: false` (or `in.voltkit.rtc.HW_AEC` set to
-`false`) and build again; WebRTC's own canceller takes over. A headset or the
-earpiece removes echo entirely.
+From 0.1.6 the SDK uses WebRTC's own echo canceller and noise suppressor (AEC3,
+the one browsers use) on Android, not the phone's built-in ones. While WebRTC
+uses a phone's canceller it switches its own off, and some phones' cancellers
+do not cope with the loudspeaker: the person on the other phone hears their own
+voice back, even in another room. An app on 0.1.5 or earlier that sees this
+should upgrade and build again.
+
+To use the phone's own canceller instead, as before 0.1.6, set it in the Expo
+plugin's options, in `app.json` or `app.config.js`:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      ["@voltkit-rtc/react-native", { "android": { "hardwareEchoCancellation": true } }]
+    ]
+  }
+}
+```
+
+Then make a new build of the app (`npx expo run:android`, or a new EAS build):
+the setting is read when the app starts, so reloading the JavaScript does not
+apply it. In a React Native app without Expo, set the meta-data in
+`AndroidManifest.xml` instead, and build again:
+
+```xml
+<meta-data android:name="in.voltkit.rtc.HW_AEC" android:value="true" />
+```
+
+An Expo app uses the plugin option, not a hand edit: `expo prebuild` writes the
+manifest again, and the edit is lost. Test either choice on the phone that
+echoed and on another before you ship it. A headset or the earpiece on the
+phone that causes the echo also stops it. Where echo comes from, including two
+phones in one room: https://voltkit.in/docs/troubleshooting#echo.
 
 ### Google Play rejects the app for 16 KB page sizes
 

package/android/src/main/java/com/voltkit/rtc/reactnative/RtcConfig.kt

@@ -25,8 +25,10 @@ internal enum class AudioMode {
  * (plan §5.3), as the Expo config plugin writes them or a hand-written manifest gives them:
  *
  *     <meta-data android:name="in.voltkit.rtc.AUDIO_MODE" android:value="communication" />  communication | media
- *     <meta-data android:name="in.voltkit.rtc.HW_AEC" android:value="true" />               the handset's own echo
- *                                                                                            canceller and noise suppressor
+ *     <meta-data android:name="in.voltkit.rtc.HW_AEC" android:value="false" />              the handset's own echo
+ *                                                                                            canceller and noise suppressor;
+ *                                                                                            false (the default from 0.1.6):
+ *                                                                                            WebRTC's own (AEC3)
  *     <meta-data android:name="in.voltkit.rtc.SCREEN_SHARE" android:value="false" />        react-native-webrtc's
  *                                                                                            screen-share service
  *
@@ -34,7 +36,7 @@ internal enum class AudioMode {
  */
 internal data class RtcConfig(
     val audioMode: AudioMode = AudioMode.communication,
-    val hardwareEchoCancellation: Boolean = true,
+    val hardwareEchoCancellation: Boolean = false,
     val screenShare: Boolean = false,
     /** What could not be read, with the default used instead; the init provider logs it. */
     val problems: List<String> = emptyList(),
@@ -55,7 +57,7 @@ internal data class RtcConfig(
             }
             return RtcConfig(
                 audioMode = mode,
-                hardwareEchoCancellation = flag(meta(HW_AEC), HW_AEC, default = true, problems),
+                hardwareEchoCancellation = flag(meta(HW_AEC), HW_AEC, default = false, problems),
                 screenShare = flag(meta(SCREEN_SHARE), SCREEN_SHARE, default = false, problems),
                 problems = problems,
             )

package/lib/commonjs/native.js

@@ -21,7 +21,7 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
  */
 
 /** The version of this package: what getDiagnostics() reports, and what the native side was built from. */
-const SDK_VERSION = exports.SDK_VERSION = '0.1.5';
+const SDK_VERSION = exports.SDK_VERSION = '0.1.6';
 
 /** The native module, or null where there is none (iOS, Expo Go, an app not rebuilt). */
 function nativeModule() {

package/lib/module/native.js

@@ -9,7 +9,7 @@ import { Platform } from 'react-native';
 import NativeVoltkitRtc from "./specs/NativeVoltkitRtc.js";
 import { iosUnsupported, logError, nativeMissing } from "./errors.js";
 /** The version of this package: what getDiagnostics() reports, and what the native side was built from. */
-export const SDK_VERSION = '0.1.5';
+export const SDK_VERSION = '0.1.6';
 
 /** The native module, or null where there is none (iOS, Expo Go, an app not rebuilt). */
 export function nativeModule() {

package/lib/typescript/commonjs/native.d.ts

@@ -2,7 +2,7 @@ import type { EventSubscription } from 'react-native';
 import { type AudioDevice, type Constants, type Spec } from './specs/NativeVoltkitRtc';
 import type { MediaDevice } from '@voltkit-rtc/client';
 /** The version of this package: what getDiagnostics() reports, and what the native side was built from. */
-export declare const SDK_VERSION = "0.1.5";
+export declare const SDK_VERSION = "0.1.6";
 /** The native module, or null where there is none (iOS, Expo Go, an app not rebuilt). */
 export declare function nativeModule(): Spec | null;
 /** The module's constants, read once: the audio mode, screen sharing, the call service as the manifest declares them. */

package/lib/typescript/module/native.d.ts

@@ -2,7 +2,7 @@ import type { EventSubscription } from 'react-native';
 import { type AudioDevice, type Constants, type Spec } from './specs/NativeVoltkitRtc.js';
 import type { MediaDevice } from '@voltkit-rtc/client';
 /** The version of this package: what getDiagnostics() reports, and what the native side was built from. */
-export declare const SDK_VERSION = "0.1.5";
+export declare const SDK_VERSION = "0.1.6";
 /** The native module, or null where there is none (iOS, Expo Go, an app not rebuilt). */
 export declare function nativeModule(): Spec | null;
 /** The module's constants, read once: the audio mode, screen sharing, the call service as the manifest declares them. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltkit-rtc/react-native",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "React Native SDK for VoltKit RTC: calls, audio rooms and live video on Android (iOS in preview), with the hooks of @voltkit-rtc/react, background calls, audio routing and an Expo config plugin.",
   "keywords": [
     "voltkit",

package/plugin/build/android.js

@@ -25,7 +25,7 @@ exports.setVoltkitManifest = setVoltkitManifest;
  *     <uses-feature android:name="android.hardware.microphone" android:required="false" />        with RECORD_AUDIO
  *     <application>
  *       <meta-data android:name="in.voltkit.rtc.AUDIO_MODE" android:value="communication" />   RtcConfig.kt
- *       <meta-data android:name="in.voltkit.rtc.HW_AEC" android:value="true" />
+ *       <meta-data android:name="in.voltkit.rtc.HW_AEC" android:value="false" />
  *       <meta-data android:name="in.voltkit.rtc.SCREEN_SHARE" android:value="false" />
  *       <service android:name="com.voltkit.rtc.reactnative.VoltkitCallService" android:exported="false"
  *                android:foregroundServiceType="microphone|mediaPlayback" />                    VoltkitCallService.kt

package/plugin/build/options.d.ts

@@ -51,7 +51,11 @@ export interface VoltkitRtcAndroidProps {
      * android.blockedPermissions blocks what it needs.
      */
     screenShare?: boolean;
-    /** The phone's own echo canceller and noise suppressor, where it has them (meta-data in.voltkit.rtc.HW_AEC; default true). */
+    /**
+     * The phone's own echo canceller and noise suppressor, where it has them (meta-data in.voltkit.rtc.HW_AEC). Default false
+     * from 0.1.6: WebRTC's own (AEC3, the one browsers use), because WebRTC switches its own off while it uses the phone's and
+     * some phones' cancellers do not cope with the loudspeaker. True for the phone's, as before 0.1.6.
+     */
     hardwareEchoCancellation?: boolean;
 }
 export interface VoltkitRtcIosProps {

package/plugin/build/options.js

@@ -28,7 +28,7 @@ const ANDROID_DEFAULTS = {
     callService: true,
     callServiceCamera: false,
     screenShare: false,
-    hardwareEchoCancellation: true,
+    hardwareEchoCancellation: false,
 };
 const IOS_DEFAULTS = { backgroundAudio: true, voip: false };
 const TOP_KEYS = ['cameraPermission', 'microphonePermission', 'android', 'ios'];

package/src/native.ts

@@ -10,7 +10,7 @@ import { iosUnsupported, logError, nativeMissing } from './errors';
 import type { AudioDeviceType, DeviceKind, MediaDevice } from '@voltkit-rtc/client';
 
 /** The version of this package: what getDiagnostics() reports, and what the native side was built from. */
-export const SDK_VERSION = '0.1.5';
+export const SDK_VERSION = '0.1.6';
 
 /** The native module, or null where there is none (iOS, Expo Go, an app not rebuilt). */
 export function nativeModule(): Spec | null {