voxa_rtc_engine 0.3.3

Drop-in Agora-compatible RTC SDK for Flutter on your own servers: same classes, signatures, error codes and callback order as agora_rtc_engine 6.x.

0.3.3

• Fixed: video did not fill its widget. AgoraVideoView letterboxed the stream inside black bars instead of filling the space, so a migrated app's preview and seat tiles looked wrong at any aspect ratio that did not match the camera. Agora's VideoCanvas.renderMode defaults to renderModeHidden — scale to fill, crop the overflow — while the underlying renderer defaults to letterboxing, and the setting was never forwarded. renderMode now maps onto the renderer: renderModeHidden and renderModeAdaptive fill and crop, renderModeFit letterboxes.

0.3.2

• Fixed: on Android, audio mixing reached nobody in apps that run a foreground service — the music played on the host's own device while the room heard silence. The capture hook is reached through FlutterWebRTCPlugin.sharedSingleton, a process-global assigned in that plugin's constructor; a second FlutterEngine (a foreground service keeping the microphone alive, for instance) re-runs plugin registration and replaces it with an instance whose initialize() never ran, so the lookup found a plugin with no audio processing controller while the call carried on using the first one. The plugin is now captured when this module registers — before any second engine can exist — and the controller read from it later.

  This only showed up in real apps: a plain test app has one engine and always worked, which is why 0.3.0 and 0.3.1 claimed Android support that did not hold in practice.

• Diagnostics for the same area: the log now records plugin registration, which engine it bound to, and the underlying cause of a failed lookup rather than the reflection wrapper.

0.3.1

• Fixed: on Android the room could not hear the mixed music — it played on the host's own device only. The capture hook is reached through flutter_webrtc's audio processing controller, which is built as part of initialising its method-call handler and is not necessarily ready when a user presses play. Attaching once and giving up left the music local with no indication anything was wrong. It now retries for ten seconds, and the log names the actual reason rather than just reporting the hook missing.

0.3.0

• Audio mixing — play music into a call, as Agora does. startAudioMixing and the rest of the family now work on Android, iOS and macOS: a decoded file is summed into the outgoing microphone stream, so remote participants hear it as part of the publisher's audio rather than as a separate track. Implemented natively over the WebRTC capture path, with local playout, volume (combined, playout-only and publish-only), duration, position, seek, looping, and onAudioMixingStateChanged / onAudioMixingFinished.

  Verified from the receiving side on both platforms, not just locally: with loopback: false the remote audio level rises far above the mic-only baseline, and with loopback: true — same file, same volume — it returns to zero.

  setAudioMixingPitch, setAudioMixingPlaybackSpeed and setAudioMixingDualMonoMode remain unimplemented and throw AgoraRtcException(-4).

• The audio-mixing callbacks fire whether or not you are in a channel, as Agora's do. They previously routed through machinery that only exists between join and leave, so starting music before joining reported nothing.

• iOS and macOS now ship native code (a Swift Package, with a podspec for apps still on CocoaPods). Nothing to configure: no new permissions beyond the microphone usage description Agora already required.

0.2.8

• Documentation only, no code change: the README drops the internal architecture notes and the link to the (private) infrastructure repo, and points at https://voxa.zamansheikh.com/docs/ instead. The production-readiness note now reflects that the implemented surface is carrying real traffic, and the wakelock_plus section explains why win32 must not be pinned directly.

0.2.7

• Packaging polish only, no behavior change: shorter package description, a reachable homepage, pristine MIT LICENSE (the third-party attribution moved to THIRD_PARTY_LICENSES, where it no longer breaks license detection), dart format applied, and doc-comment lint headers on the files derived from agora_rtc_engine.

0.2.6

• Fixed: after switchCamera, the view kept showing the previous camera until the widget was recreated (e.g. leaving and re-entering the screen). A flip restarts the underlying media track in place, so the track object never changes and the renderer had no reason to rebind. AgoraVideoView now keys its renderer on the underlying media track, and a flip notifies the view layer.

0.2.5

• Fixed: onAudioVolumeIndication reported volumes far too low, so speaking indicators / mic-wave UIs never lit up. The media engine's audio level is linear amplitude derived from dBov, so ordinary speech landed near 8 on Agora's 0–255 scale; apps typically treat "> 30" as speaking and Agora itself reports ~100–200 for speech. Volumes are now mapped through dB, putting speech in Agora's usual range and silence at 0.
• Fixed: switchCamera did nothing on a pre-join preview. It targeted only published tracks, so flipping the camera on a "go live" preview screen was a silent no-op. It now also targets the preview track, and never targets a screen-share publication.

0.2.4

• Fixed: apps whose token server mints legacy 006 tokens could not connect (404 page not found, errJoinChannelRejected). The transport decided whether to exchange a token at the Compat Gateway by checking for a 007 prefix, so 006 tokens skipped the exchange and LiveKit signaling was sent straight at the gateway. The decision now keys on the configured server URL: http(s):// is a gateway (exchange), ws(s):// is a media server (connect directly) — token-format agnostic.

0.2.3

• Fixed: AgoraVideoView could stay black forever. Views built before joinChannel (preview tiles, seat widgets) subscribed to the transport's event stream, which does not exist yet at that point — so they never learned their track had arrived. Apps that cache their VideoViewControllers (the documented Agora pattern) never rebuilt, and the view stayed on its black placeholder. The engine now owns a long-lived event stream that exists before join and survives leave/rejoin, and views also refresh on remote track subscribe and participant join/leave.

0.2.2

• Android module is Java-only with no Kotlin plugin on the Gradle classpath. 0.2.1 pinned a kotlin-gradle-plugin version, which overrode the host app's Kotlin version and broke other plugins (e.g. wakelock_plus) at compile time.

0.2.1

• Fixed: camera/mic permission dialogs never appeared on Android. The package now ships an Android module whose manifest declares the RTC permissions (CAMERA, RECORD_AUDIO, MODIFY_AUDIO_SETTINGS, INTERNET, ACCESS_NETWORK_STATE, Bluetooth), mirroring what agora_rtc_engine contributes. Apps migrating from Agora often relied on that manifest merge and had no CAMERA entry of their own; Android denies undeclared permissions silently, so no dialog was shown. Deliberately not declared: READ_PHONE_STATE and ACCESS_WIFI_STATE (Agora declares both; neither is needed here, and READ_PHONE_STATE requires a Play Store declaration form).

0.2.0

• updateChannelMediaOptions — change role and publish state mid-session (the modern 6.x alternative to setClientRole). Behavior golden-recorded from the live Agora service: a role change fires onClientRoleChanged; publish-flag-only updates are silent.
• muteAllRemoteAudioStreams / muteAllRemoteVideoStreams — apply to current participants and to peers who join later.
• autoSubscribeAudio / autoSubscribeVideo in ChannelMediaOptions now drive remote subscriptions.
• Behavioral parity: 8/8 golden transcript scenarios.

0.1.1

• Rewrote the package README for pub.dev: migration guide, quickstart, implemented-surface overview, platform matrix, backend requirements.
• Clarified the package description.

0.1.0

Initial development release.

• Complete agora_rtc_engine 6.6.3 public API surface (import-only migration).
• Tier-1 + Tier-2 implemented over a LiveKit-based media engine: channel lifecycle, mute/roles/camera/routing, rendering, reconnection, token lifecycle, volume indication, encoder configuration, dual-stream, screen share, pre-join preview, in-call stats.
• Behavioral parity verified against recordings from production Agora (7/7 golden transcript scenarios).
• Unsupported APIs fail gracefully with AgoraRtcException(-4).