Release notes
Review the latest Vivox Core release notes and updates.
Read time 12 minutesLast updated 8 days ago
Version 5.29.0
Release overview
The 5.29.0 release adds native text-to-speech on Android, iOS, Windows, and Xbox, delivers a user's own directed messages back to them, introduces text translation, and adds support for the PS5 14.00 SDK and Xbox GDK 260400. It also contains various bug fixes and improvements.
For further technical details on all the changes included in this release, refer to the file within the SDK.
CHANGELOG.mdKey features and bugs addressed
Added
- Native text-to-speech engine (), which uses the operating system's installed voices and languages, on:
tts_engine_native_default- Android, using the device's text-to-speech engine (). Voices are the device's installed offline voices. Requires
android.speech.tts. Android finishes initializing text-to-speech on the main thread, so calls made from the main thread before it's ready see no voices; call from another thread to wait for them.JniHelpers.init() - iOS 13 and later, using . On iOS 11 and 12,
AVSpeechSynthesizerreturnsvx_tts_initializefor the native engine.tts_error_not_supported - Windows 10 and later (desktop builds), using . On Windows 7 and 8.1,
Windows.Media.SpeechSynthesisreturnsvx_tts_initializefor the native engine. UWP builds are unchanged.tts_error_not_supported - Xbox One and Xbox Series X|S (GDK), using the console speech synthesizer ().
XSpeechSynthesizer
- Android, using the device's text-to-speech engine (
- , which returns a text-to-speech voice's BCP-47 language tag (for example
vx_tts_get_voice_info), oren-USif the engine doesn't report one. The existing Flite voices reportund.en-US - Directed messages sent by the logged-in account are now echoed back to that account through , with
vx_evt_user_to_user_messageset andis_current_useridentifying the original recipient. This is controlled byto_uri, which is enabled by default; set it to 0 for the previous behavior.vx_sdk_config_t.enable_dm_send_confirmation - Text translation of incoming directed messages, their edits, and chat history results for a logged-in account, with either a fixed source and target language or languages resolved per message. Voice is never translated. Contact your Vivox representative to enable this feature, which is not yet generally available.
- On-request translation of one or more texts into a target language. Contact your Vivox representative to enable this feature.
- Support for PS5 14.00 SDK.
- Support for Xbox GDK 260400.
Changed
- Android: The minimum supported version is Android 6.0 (API 23), which the native library already required. The AAR manifest still declares 14 so that existing app builds aren't affected. A future release will raise it to 23.
minSdkVersion
Fixed
- Directed messages sent by the logged-in account are now delivered back to that account, so the sender receives the server-assigned that is required to edit or delete the message later.
message_id - Blocking with now applies in both directions for channel text messages in text-only channels and when only one of the two users is connected to audio, including blocks set before a user joins the channel.
vx_req_account_control_communications - Account-level text mutes (or
mute_scope_text) now hide the muted user's channel text in channels joined after the mute was set.mute_scope_all - Logout with more than one session group, including empty ones created with , no longer reports completion early or fails to complete. Empty session groups now also receive
vx_req_sessiongroup_createat logout.vx_evt_sessiongroup_removed - When presence is enabled, logout now sends unavailable presence before disconnecting.
- Automatic Connection Recovery (ACR) now reports the text connection as recovered only when the server confirms it, and ends as soon as the server rejects the resume instead of waiting out the full 30-second recovery timeout.
- is now populated. It was previously always NULL.
vx_evt_account_edit_message.language - Fixed a crash in , most often seen on Windows after audio device changes, caused by the default memory pool returning NULL for some allocations of about 2 MB or larger when no custom allocator is supplied.
MessageQueue::Enqueue - Fixed a crash (in
SIGABRT, most often seen on Android) when an account was logged out or released while ACR was still attempting to reconnect.StroConnection::~StroConnection - Fixed a rare crash after text-to-speech playback, most often with queued local playback.
- Fixed a crash in the XMPP connection's timer handling, most often seen on Nintendo Switch™, caused by a data race on the connection's internal timer collections.
- Fixed apps failing to link against the static (for example on iOS) with
libvivoxsdk.a, which caused duplicate symbol errors since 5.26.0.-all_load - Fixed builds with Clang on Windows (, or Clang targeting MSVC) failing with
clang-clon-Werrorinunknown pragma ignored [-Wunknown-pragmas]. MSVC builds are unchanged.Vxc.h - Android: now returns
JniHelpers.init()instead of crashing the app when the native library can't be loaded. On devices older than Android 6.0 (API 23), it logs that the SDK requires API 23 or later and returnsfalse.false - Android: Disabling platform AEC () on Android 12 (API 31) and later no longer leaves the device on the speakerphone communication route.
vx_set_platform_aec_enabled(0) - Android: Opening or switching the audio input device no longer initializes the microphone twice, so switching devices during a session is faster, by about 200 to 500 ms on tested devices.
- Nintendo Switch™ 2: Fixed duplicate-symbol link errors in titles that also link another WebRTC-based library, such as Nintendo NPLN's .
libnn_npln_p2p_middleware.a - PlayStation® 5 and PlayStation® 4: Fixed a TLS connection leak that could exhaust the SSL pool and cause XMPP login failures (error 5046) over time.
- Xbox (GDK): Fixed audio device hotswap not switching to the new device on the first try while in a channel.
Public API Changes
- New function: , returning a
vx_tts_get_voice_info.vx_tts_voice_info_tandvx_tts_voice_tare unchanged.vx_tts_get_voices - is now supported on Android, iOS 13 and later, Windows 10 and later (desktop builds), and Xbox (GDK).
tts_engine_native_default - New configuration field: (enabled by default).
vx_sdk_config_t.enable_dm_send_confirmation - Event changes: now contains
vx_evt_user_to_user_messageandis_current_user.to_uri - Event changes: ,
vx_evt_user_to_user_message, andvx_evt_account_edit_messagenow containvx_evt_account_archive_message. When set, the message text is the translation andis_translatedis the language it was translated into.language - New request: , with
vx_req_account_translation_controlandsource_language, ortarget_language(mutually exclusive with them), which takes the target from the first language supplied at login and the source from each incoming message.auto_languages - New request: , given a target language and optionally a source language. The response carries one
vx_req_account_translate_textper text, in request order.vx_translated_text_t
Known Issues
None.
Version 5.28.0
Release overview
The 5.28.0 release includes new features, introduces support for Linux arm64 and Nintendo SDK 22.2.0, and it contains various bug fixes and improvements.
For further technical details on all the changes included in this release, refer to the file within the SDK.
CHANGELOG.mdKey features and bugs addressed
Added
- Ability to synchronize custom metadata between participants in sessions, a.k.a. "session presence custom metadata".
- New noise reduction algorithm, RNNoise, for removing keystrokes, mouse clicks and other environmental transient noises.
- Jitter compensation API.
- Enumeration of audio devices on Linux.
- Namespace and Body fields added to session and user-to-user message events.
- New audio callbacks that separate local audio processing from voice session audio processing.
- Support for Linux arm64.
- Support for Nintendo SDK 22.2.0.
Changed
- Local loopback audio has noise reduction applied in the same way that voice session audio does.
Fixed
- Various minor bug fixes.
Public API Changes
- New request: .
vx_req_session_set_presence_custom_metadata - New event: .
vx_evt_participant_presence_custom_metadata_updated - Event changes: and
vx_evt_session_archive_messagenow containvx_evt_account_archive_messageandapplication_stanza_namespace.application_stanza_body - Callback change: callback signature has changed.
pf_on_audio_unit_before_capture_audio_sentis now anis_speakingin/out parameter (wasint *), and a newintparameter has been added.int *fade_speech_transition_ms - New noise reduction API: ,
vx_noise_reduction_rnnoise_set_enabled,vx_noise_reduction_rnnoise_get_enabled,vx_noise_reduction_rnnoise_set_strength,vx_noise_reduction_rnnoise_get_strength,vx_noise_reduction_webrtcns_set_enabled,vx_noise_reduction_webrtcns_get_enabled,vx_noise_reduction_webrtcns_set_level.vx_noise_reduction_webrtcns_get_level - Deprecated: ,
vx_get_noise_suppression_enabled,vx_set_noise_suppression_enabled, andvx_get_noise_suppression_level. Use the newvx_set_noise_suppression_levelfunctions instead.vx_noise_reduction_webrtcns_* - New jitter compensation API: and
vx_set_jitter_compensation_periods.vx_get_jitter_compensation_periods - New audio callbacks: ,
pf_on_local_audio_unit_before_signal_processing, andpf_on_local_audio_unit_after_signal_processing.pf_on_local_audio_unit_before_render
Known Issues
None.
Version 5.27.3
Release overview
The 5.27.3 release introduces support for the PlayStation® 5 13.00 SDK and Linux x64, and it contains various bug fixes and improvements.
For further technical details on all the changes included in this release, refer to the file within the SDK.
CHANGELOG.mdKey features and bugs addressed
Added
- Support for PS5 13.00 SDK.
- Support for Linux x64.
Changed
- Improved login latency.
- Android: Disabled the default pooled allocator to avoid a rare memory alignment issue on ARM64.
- Android: Bluetooth microphone devices now have software Acoustic Echo Cancellation enabled.
Fixed
- Android: Fixed a race condition so that switching between devices doesn't stop Bluetooth microphones from streaming.
- PlayStation: Increased TLS SSL pool size to prevent crashes at login under certain network conditions.
Public API Changes
- Android: added to allow for re-enabling the pooled allocator.
vx_set_force_pooled_allocator(int enable)
Known Issues
None.
Version 5.27.1
Release overview
The 5.27.1 release contains various bug fixes and improvements.
For further technical details on all the changes included in this release, refer to the file within the SDK.
CHANGELOG.mdKey features and bugs addressed
Added
- Vivox clients now reconnect automatically when Vivox servers make live upgrades.
Changed
- Windows: Only audio input devices now have the AudioCategory specified by default due to Windows forcing some Bluetooth devices into a low quality mode when
AudioCategory_GameChatwas specified for an audio output device. UseAudioCategory_GameChatto change the capture audio stream category at initialization.vx_sdk_config_t.capture_audio_stream_category
Fixed
- Android: Building the SDKSampleApp from source is now achievable in modern Android Studio versions without major build file changes.
Version 5.27.0
Release overview
Version 5.27.0 introduces support for the Nintendo Switch™ 2 and fixes bugs related to Android and Automatic Connection Recovery (ACR).
For further technical details on all the changes included in this release, refer to the file within the SDK.
CHANGELOG.mdKey features and bugs addressed
- Android armeabi/armeabi-v7a: Fixed a crash that would occur on certain SoCs at the time of Vivox login when custom allocators were not specified.
- Fixed layered service provider debug log spam from Automatic Connection Recovery (ACR).
- All time-dependent operations within the Vivox SDK are now immune to system clock changes.
Windows
- Audio devices opened by the Vivox SDK now have their AudioCategory marked as for client applications that have declared compatibility with Windows 10 and 11 in their manifest.
AudioCategory_GameChat
Platform-specific changes
- Added support for Nintendo Switch™ 2.
Public API Changes
New error codes
- Added
VxErrorJobDependencyFailed (5111) - Added
VxErrorFailed (1004)
Known Issues
- Some Bluetooth audio devices on Windows have reduced audio quality because the operating system forces them into Handsfree Telephony mode. This will be fixed in the next hotfix release.
Version 5.26.3
Release overview
Version 5.26.3 officially provides support for Nintendo Switch™ 2.
Key features and bugs addressed
- Added support for Nintendo Switch™ 2.
API changes
None.
Known issues
None.
Version 5.26.0
Release overview
Version 5.26.0 introduces comprehensive audio processing improvements with enhanced noise suppression, expanded platform support for audio processing features, and significant performance optimizations.
This release focuses on improving voice quality while optimizing resource usage across all supported platforms.
For further technical details on all the changes included in this release, refer to the file within the SDK.
CHANGELOG.mdKey Features and Bugs Addressed
- Updated license and third-party notices.
- Vivox log levels were off-by-one. There may be more Vivox log statements now if initial_log_level was set for your application.
Audio Processing Improvements
- Noise suppression now applied to capture audio by default.
- Extended Acoustic Echo Cancellation (AEC) and Automatic Gain Control (AGC) support to Nintendo Switch™, PlayStation®, XBOX, visionOS, and UWP.
- New AEC implementation prevents microphone dropouts in the presence of echo on mobile platforms.
- AGC enabled by default with improved microphone capture loudness.
- Optimized voice codec for reduced packet loss and jitter.
Performance Optimizations
-
Existing AEC/AGC platforms:
- 11 MB reduction in memory usage during active sessions.
- Improved CPU efficiency in Release configuration.
-
New AEC/AGC platforms:
- 44% increase in audio thread CPU usage.
- 6 MB additional memory usage during sessions.
-
Memory allocator improvements reducing heap memory requests.
Platform-Specific Changes
- Android: Added 16KB page size support for native libraries
- Android: Proguard rules now included in AAR libraries
- iOS: Removed support for ARMV7 architecture
- iOS: Removed bitcode
- Android/iOS: Improved platform AEC control independent of DVPS
Implementation Considerations
- Consider adjusting application volume presets due to new AGC behavior.
Public API Changes
New APIs
vx_get_noise_suppression_enabledvx_get_noise_suppression_levelvx_set_noise_suppression_enabledvx_set_noise_suppression_levelon_audio_unit_requesting_final_mix_for_echo_canceller_analysis
Modified APIs
- - Now functions independently of Dynamic Voice Processing Switching (DVPS) status.
vx_set_platform_aec_enabled
New Error Code
- Added
VxXmppErrorChannelAtCapacity (20507)
Known Issues
- Android sample applications do not yet support 16KB page size despite native library support.