Weekly releases

The SDK versions listed on this page are stable out-of-band releases. They may contain targeted bug fixes and features not yet available in the standard GA release cycle. To download, select the desired version on the SDKs page.

Note

Starting from v4.5.0, both Video SDK and Signaling SDK (v2.2.0 and above) include the libaosl.so library. If you manually integrate Video SDK via CDN and also use the Signaling SDK, delete the earlier version of the libaosl.so library to avoid conflicts.

Released on April 7, 2026.

info

The libaosl.so library version in v4.5.3 is 1.3.7.

This release includes the following new features.

• Audio buffer delay query in Media Player

  To resolve audio sync issues between lead vocals and accompaniment in karaoke scenarios, this release adds the getAudioBufferDelay method to the Media Player module to retrieve millisecond-level audio buffer delay during media playback.

• Multipath network transmission

  This release introduces multipath transmission for devices with multiple network interfaces (for example, 5G, Wi-Fi, and LAN), effectively reducing or eliminating quality degradation under poor network conditions. This feature is suitable for stable real-time audio and video communication in complex environments such as vehicles, IoT, trains, and highways.

  Enable multipath transmission by setting enableMultipath to true in ChannelMediaOptions. Two transmission modes are supported:

  • Dynamic mode (default): Dynamically selects the optimal path based on network conditions. Suitable for traffic-sensitive, high-experience scenarios such as meetings and education. You can specify a preferred network type using preferMultipathType.
  • Full redundancy mode: Transmits data simultaneously over all available paths. Suitable for traffic-insensitive, ultra-high-experience scenarios such as outdoor broadcasting and remote control. This mode incurs additional charges; contact technical support to enable it.

  When enabled, the SDK reports real-time transmission statistics for each path through the onMultipathStats callback, including traffic usage for monitoring and optimization.

• Single-app screen sharing

  Starting from Android 14, the system allows users to share the entire screen or a single app during screen sharing, enhancing privacy and multitasking. This release adapts to this system capability by adding single-app screen sharing alongside full-screen sharing. The new onLocalVideoEvent callback reports local video events, particularly those related to screen sharing.

• Beauty filter refactoring

  The beauty filter module has been completely refactored and upgraded, expanding features, improving effects and performance, and resolving issues such as complex parameter configuration, high integration costs, and network-dependent beauty resources. Key improvements include:

  • New beauty features: Teeth whitening, nasolabial fold removal, dark circle removal, and eye brightening; new makeup effects including eye bags and facial highlights; face shaping features increased from 11 to 29; new sticker functionality.
  • Simplified APIs: Basic beauty, face shaping, makeup, and filters are consolidated into three core nodes — BEAUTY, STYLE_MAKEUP, and FILTER — plus the new STICKER node. These are managed uniformly via IVideoEffectObject for lifecycle and parameter control, reducing performance overhead from frequent API calls.
  • Ready-to-use presets: Multiple preset style templates (for example, Natural Beauty, Campus Makeup, and Cool White Filter) simplify integration without requiring manual tuning of individual parameters.
  • Dynamic parameter control: Supports real-time reading and modification of fine-grained beauty parameters via key-value pairs, applying presets, saving custom configurations, and resetting to defaults.
  • Local beauty resources: All beauty resources (effects, filters, and makeup) are packaged as local bundle files, eliminating failures caused by network download issues.

• Asynchronous engine destruction

  This release adds a new overloaded destroy [2/2] method that supports both synchronous and asynchronous engine destruction via configuration parameters. When destroyed asynchronously, the SDK triggers the onEngineReleased callback.

• Additional features

  • Local snapshot upload now supports setting the video observation position via the new position member in ContentInspectModule, allowing snapshots of raw video or processed video streams.
  • Added preloadEffectEx to preload audio effect files (local or online) to a specified channel for fast playback in multi-channel scenarios.
  • Added playEffectEx to play audio effect files in a specified channel, with support for loop count, pitch, spatial position, and volume.
  • Added error codes ERR_PCMSEND_FORMAT (200) and ERR_PCMSEND_BUFFEROVERFLOW (201) to report PCM data transmission errors.

This release includes the following enhancements.

• Device compatibility

  This release adapts to Android 14, 15, and 16, improves stability on various devices, and optimizes video codec strategies based on device capabilities.

• Usability improvements

  • Improves face detection accuracy on some devices.
  • Enhances stability when loading the SDK using mNativeLibPath.

• Experience improvements

  • Improves video interaction on some devices, reducing flickering and blurry preview issues.
  • Optimizes video capture delay estimation for better audio-video sync and lower latency.
  • Improves hardware codec capability query to reduce engine initialization time and enhance compatibility.
  • Adapts Android hardware encoding color space processing for more accurate color reproduction.
  • Optimizes create execution speed to reduce occasional ANRs caused by long initialization delays.

• Package size

  • Audio SDK package size reduced by 27% (compressed arm64 single architecture).
  • Up to 38.5% total size reduction when stripping the ffmpeg library.

• Performance

  Reduces CPU usage for video host and 1v1 audio call scenarios.

• End-to-end latency

  • Video end-to-end latency reduced by 20–30 ms in 1v1 calls.
  • Video end-to-end latency reduced by 100–600 ms (20%–45%) under restricted bandwidth.
  • First-frame display time shortened by 130–240 ms on MediaTek and Samsung devices.
  • Audio end-to-end latency reduced by 50–200 ms in interactive live streaming under jitter-buffered poor networks.

This release introduces the following compatibility changes.

• ffmpeg library renamed: The libagora-ffmpeg.so library is renamed to libaosl_ffmpeg_extension.so. Additionally, the libaosl_ffmpeg_extension.so library in the Android Audio SDK supports stripping from this version. Contact technical support if you need this feature.

  Behavior changes when stripping the ffmpeg library

  If you integrate the Audio SDK and strip the libaosl_ffmpeg_extension.so library, the following behavior changes apply:

  • When playing media files, the app uses the device's native player. Supported formats depend on the device's capabilities.

  • The SDK's built-in media player (IMediaPlayer) only supports the following APIs:

    • Initialization
      • createMediaPlayer
      • destroyMediaPlayer
    • Opening media resources
      • open
      • openWithMediaSource
    • Playback control
      • selectAudioTrack
      • setAudioDualMonoMode
      • setAudioPitch
      • setLoopCount
      • setPlaybackSpeed
    • Player control
      • adjustPlayoutVolume
      • adjustPublishSignalVolume
      • mute
      • pause
      • play
      • resume
      • seek
      • stop
    • Playback information
      • getAudioBufferDelay
      • getDuration
      • getMediaPlayerId
      • getMute
      • getPlayoutVolume
      • getPlayPosition
      • getPlaySrc
      • getPublishSignalVolume
      • getState
      • getStreamCount
      • getStreamInfo
    • Observers
      • registerAudioFrameObserver
      • registerPlayerSourceObserver
      • onAudioVolumeIndication
      • onPlayerEvent (full support not guaranteed)
      • onPlayerSourceStateChanged (full support not guaranteed)
      • onPositionChanged
      • onCompleted

• Changes to makeup feature implementation: Due to the refactoring of the beauty filter module, calling setExtensionProperty to enable makeup effects is no longer supported. Use the STYLE_MAKEUP node instead.

This release fixed the following issues.

• Occasional muffled audio and noise during audio chat live streaming on Android emulators.
• Occasional desync between vocals and accompaniment when recording using startAudioRecording in a channel.
• Occasional failure to hear remote audio when a broadcaster uses a Bluetooth headset.

New APIs

• getAudioBufferDelay
• onMultipathStats
• PathStats
• MultipathStats
• Added enableMultipath, preferMultipathType to ChannelMediaOptions
• MultipathType
• MultipathMode
• addOrUpdateVideoEffect
• removeVideoEffect
• performVideoEffectAction
• setVideoEffectFloatParam
• setVideoEffectIntParam
• setVideoEffectBoolParam
• getVideoEffectFloatParam
• getVideoEffectIntParam
• getVideoEffectBoolParam
• IVideoEffectObject
• VIDEO_EFFECT_NODE_ID
• VIDEO_EFFECT_ACTION
• onLocalVideoEvent
• destroy [2/2]
• Added position to ContentInspectModule
• preloadEffectEx
• playEffectEx
• ERR_PCMSEND_FORMAT (200)
• ERR_PCMSEND_BUFFEROVERFLOW (201)