volume

Specifies the speaking volume based on the Vocalizer volume scale.

Value

Integer: 0–100.

DEFAULT:

80 for the Vocalizer API

100 for Microsoft SAPI API

How to set

Shown in precedence order (see Configuration precedence):

Set in the session xml file for the application. Configure the <speechsynth> element located under <sessionparameters>, <speechserver>.

API—Set as TTS_PARAM_VOLUME.

Usage

Frequently used.

Specifies the amplitude of TTS audio, where lower values are lower volume levels.

Vocalizer’s default volume level is set to maximize voice quality by using the full resolution of the PCM samples it produces, and often needs adjustment for the application specific deployment environment. The volume requirements vary widely across application environments, but for optimal audio quality it is generally better to adjust the volume as close to the playback device as possible when there is a choice between modifying the Vocalizer volume or modifying the volume elsewhere.

This parameter can be set via the API while synthesis is in progress. The change takes effect quickly, but because Vocalizer typically delivers audio faster than real time, there may be a significant number of audio buffers waiting for playback at the audio device; there may be a lag before the end user hears the effects. Applications can avoid this lag by doing volume changes with the audio device instead of with Vocalizer, or by stopping and restarting synthesis, or by minimizing the number of audio buffers queued for the audio output device.

This value is overridden if the volume is set via the native API, or markup and has no effect for the Microsoft SAPI API where SAPI always specifies its own default volume.