Implementing Voice Functionality in WeChat Mini Programs

WeChat Mini Program voice functionality allows developers to capture spoken input, send it to WeChat's speech‑recognition service, and obtain the transcribed text.

1. Import the API

In a Mini Program JavaScript file, import the recorder and audio contexts:

const recorderManager = wx.getRecorderManager();
const innerAudioContext = wx.createInnerAudioContext();

recorderManager

handles recording and speech recognition, while innerAudioContext is used for audio playback.

2. Recording

Start recording with the desired format (e.g., MP3):

recorderManager.start({
  format: 'mp3'
});

The recorder can be configured with additional parameters such as sample rate. When recording stops, the onStop callback provides a temporary file path.

3. Speech Recognition

Upload the recorded file to WeChat's voice‑to‑text API and handle the response:

recorderManager.onStop((res) => {
  const { tempFilePath } = res;
  wx.uploadFile({
    url: 'https://api.weixin.qq.com/cgi-bin/media/voice/addvoicetorecofortextaccess_token=' + token + '&format=mp3&voice_id=123',
    filePath: tempFilePath,
    name: 'voice',
    success(res) {
      console.log(res.data);
    }
  });
});

tempFilePath

is the temporary location of the recorded audio. wx.uploadFile sends an HTTP request to the voice recognition endpoint; the result is returned in the success callback.

4. Playback

Play the recognized or any audio file using the inner audio context:

innerAudioContext.autoplay = true;
innerAudioContext.src = 'http://example.com/example.mp3';

Setting autoplay to true starts playback automatically, and src specifies the audio file URL.

The above steps outline the main workflow and API usage for voice features in WeChat Mini Programs; detailed comments and further implementation can be found in the official documentation.