Voice activity detection
Understand voice activity detection in Vivox.
Read time 1 minuteLast updated 7 months ago
Voice activity detection detects the presence or absence of speech in an application. In most cases, customers do not need to adjust the default voice activity detection (VAD) settings of the Vivox SDK.
Tip
Before manually tuning the VAD settings, test your setup using Automatically Adjusted VAD. Automatically Adjusted VAD is better at detecting a player speaking than the default VAD settings.
The Automatically Adjusted VAD can be enabled using . This will allow the SDK to automatically configure the VoiceActivityDetection settings. This will override any manual settings from .
VivoxService.Instance.EnableAutoVoiceActivityDetectionAsync()VivoxService.Instance.SetVoiceActivityDetectionPropertiesAsync()If the Automatically Adjusted VAD has been disabled using , then can be called to either set the properties specifically, or to reset them to the default levels.
VivoxService.Instance.DisableAutoVoiceActivityDetectionAsync()VivoxService.Instance.SetVoiceActivityDetectionPropertiesAsync(int hangover, int noiseFloor, int sensitivity)Parameter specifics
The parameter defines the amount of time (in milliseconds) it takes for the VAD to switch from speech mode back to silence after the last frame of speech is detected. The default setting is 2000.
hangoverThe parameter is a dimensionless value between 0 and 20000 that controls how the VAD separates speech from background noise. Lower values assume the user is in a quieter environment where the audio is only speech. Higher values assume a noisy background environment. The default value is 576.
noiseFloorNote
Changes to the VAD noiseFloor settings do not affect currently joined channels. If the ability to change VAD settings is available to the end-user, indicate that noise floor changes only take effect in the next voice session or only allow changing the noise floor channel when the client is not in a channel.
The parameter is a dimensionless value between 0 and 100 that indicates the sensitivity of the VAD. Increasing this value corresponds to decreasing the sensitivity of the VAD (0 is the most sensitive, and 100 is the least sensitive). Higher values of sensitivity require louder audio to trigger the VAD. The default value is 43.
sensitivityApplications that use the default VAD and expose vad_sensitivity as a slider should limit the possible settings between zero (transmit all mic activity) and 70 (very selective).