This page contains recommendations on how to provide speech data to the Google Assistant API. These guidelines are designed for greater efficiency and accuracy as well as reasonable response times from the service.
It's best to provide audio that is as clean as possible by using a good quality and well-positioned microphone. However, applying noise-reduction signal processing to the audio before sending it to the service typically reduces recognition accuracy. The service is designed to handle noisy audio.
For best results:
- Position the microphone as close to the user as possible, particularly when background noise is present.
- Avoid audio clipping.
- Do not use automatic gain control (AGC).
- All noise reduction processing should be disabled.
- The audio level should be calibrated so that the input signal does not clip, and peak speech audio levels reach approximately -20 to -10 dBFS.
- The device should exhibit approximately "flat" amplitude versus frequency characteristics (+- 3 dB 100 Hz to 8000 Hz).
- Total harmonic distortion should be less than 1% from 100 Hz to 8000 Hz at 90 dB SPL input level.
If possible, set the sampling rate of the audio source to 16000 Hz. Otherwise,
sample_rate_hertz to match the native sample rate of the audio source (instead
The Google Assistant recognizes live audio as it is captured from a microphone.
The audio stream must be split into frames and sent in consecutive
AssistRequest messages. Any frame size is acceptable. Larger frames are more
efficient, but add latency. A 100-millisecond frame size is recommended as a
good tradeoff between latency and efficiency.