Tencent Cloud Super App as a Service
- Release Notes and Announcements
- Purchasing Guide
- Plan Management
- Branded Configurations
- Introduction to Platform Functions
- Commercialization
- Virtual Payment
- Guidelines for Code Integration
- Android
- Android SDK Description
- Android API
- Mini Program Management APIs
- Custom Mini Program Capabilities
- Custom SDK Capabilities
- iOS
- iOS SDK Description
- iOS API
- Mini Program Management APIs
- Customize Mini Program Capabilities
- Customised SDK Capabilities
- Flutter
- Flutter SDK Description
- Flutter API
- Mini Program Management API
- Mini Program Capabilities Customization
- Plugin Customization
- App Server
- Payment Development Notes
- Mini Program Payment: Parameter Application and Configuration
- Mini Game Payment: Parameter Application and Configuration
- Mini Program Payment: Signature and Verification
- Guildlines for Mini Program Development
- Mini Program Code Composition
- Guidance
- Learn About Mini Programs
- Configuring Mini Program
- Mini Program Framework
- Basic Competencies
- Open Capabilities
- Framework
- Mini Program Configuration
- Framework Interface
- WXML Syntax Reference
- WXS Syntax Reference
- Components
- API
- Interface
- Media
- Device
- JS SDK
- IDE Operation Instructions
- Guildlines for Mini Game Development
- Guide
- Game Engine
- Basic Capability
- Open Capabilities
- API
- Interface
- Rendering
- Device
- Practice Tutorial
- API Documentation
- Making API Requests
- User Management APIs
- Team Management APIs
- Sensitive API-Related APIs
- Role Management APIs
- Platform Management APIs
- Other Console APIs
- Mini Program APIs
- Management-Sensitive APIs
- Global Domain Management APIs
- Application APIs
DocumentationTencent Cloud Super App as a ServiceGuildlines for Mini Program DevelopmentAPIMediaAudio Recording
Audio Recording
Last updated: 2024-11-28 10:40:04
startRecord
This API is used via wx.startRecord(Object object).
Feature Description: Starts audio recording. The audio recording will automatically cease when wx.stopRecord is actively invoked, or when the audio recording exceeds one minute. This interface cannot be invoked when the user exits the mini program.
Parameter and Description: Object.
Attribute | Type | Default value | Required | Description |
success | function | - | No | Callback Function of Successful Interface Call |
fail | function | - | No | Callback Function of Failing Interface Call |
complete | function | - | No | Callback function executed upon the completion of the interface invocation (both successful and unsuccessful invocations) |
Parameters for object.success callback function: Object res.
Attribute | Type | Description |
tempFilePath | string | Temporary path of audio recording file (local path) |
Sample Code
wx.startRecord({success (res) {const tempFilePath = res.tempFilePath}})setTimeout(function () {wx.stopRecord() // Stop audio recording}, 10000)
stopRecord
This API is used via wx.stopRecord(Object object).
Feature Description: Stops audio recording.
Parameter and Description: Object.
Attribute | Type | Default value | Required | Description |
success | function | - | No | Callback Function of Successful Interface Call |
fail | function | - | No | Callback Function of Failing Interface Call |
complete | function | - | No | Callback function executed upon the completion of the interface invocation (both successful and unsuccessful invocations) |
Sample Code
wx.startRecord({success (res) {const tempFilePath = res.tempFilePath}})setTimeout(function () {wx.stopRecord() // Stop audio recording}, 10000)
getRecorderManager
This API is used via RecorderManager wx.getRecorderManager().
Feature Description: Gets the globally unique RecorderManager.
Return Value: RecorderManager.
RecorderManager
.onError
This method is used via RecorderManager.onError(function listener).
Feature Description: Monitors audio recording error events.
Parameter and Description: function listener, the listener function for audio recording error events.
Attribute | Type | Description |
errMsg | string | Error Message |
.onFrameRecorded
This method is used via RecorderManager.onFrameRecorded(function listener).
Feature Description: Monitors events where files have been recorded to a specified frame size. If frameSize is set, this event will be called back.
Parameter and Description: function listener, the listener function for events where files have been recorded to a specified frame size.
Attribute | Type | Description |
frameBuffer | ArrayBuffer | Audio recording shard data |
isLastFrame | boolean | Is the current frame the last one before the normal end of the audio recording? |
.onInterruptionBegin
This method is used via RecorderManager.onInterruptionBegin(function listener).
Feature Description: Monitors events where audio recording is interrupted due to system occupation. WeChat voice chat and WeChat video chat scenarios will trigger such events, and subsequently the audio recording will pause.
Parameter and Description: function listener, the listener function for events where audio recording is interrupted due to system occupation.
.onInterruptionEnd
This method is used via RecorderManager.onInterruptionEnd(function listener).
Feature Description: Monitors audio recording interruption ending events. After receiving the interruptionBegin event, all audio recordings within the mini program will pause, and only after receiving this event can audio recording be successfully resumed.
Parameter and Description: function listener, the listener function for audio recording interruption ending events.
.onPause
This method is used via RecorderManager.onPause(function listener).
Feature Description: Monitors audio recording pause events.
Parameter and Description: function listener, the listener function for audio recording pause events.
.onResume
This method is used via RecorderManager.onResume(function listener).
Feature Description: Monitors audio recording continuation events.
Parameter and Description: function listener, the listener function for audio recording continuation events.
.onStart
This method is used via RecorderManager.start(Object object).
Feature Description: Monitors audio recording start events.
Parameter and Description: function listener, the listener function for audio recording start events.
.onStop
This method is used via RecorderManager.onStop(function listener).
Feature Description: Monitors audio recording ending events.
Parameters and Description: function listener, the listener function for audio recording ending events. Object res parameter.
Attribute | Type | Description |
tempFilePath | string | Temporary path of audio recording file (local path) |
duration | number | Total audio recording duration, in milliseconds. |
fileSize | number | Audio recording file size, in bytes. |
.pause
This method is used via RecorderManager.pause().
Feature Description: Pauses audio recording.
.resume
This method is used via RecorderManager.resume().
Feature Description: Continues audio recording.
.start
This method is used via RecorderManager.start(Object object).
Feature Description: Starts audio recording.
Parameter and Description: Object
Attribute | Type | Default value | Required | Description |
duration | number | 60000 | No | The duration of the audio recording, measured in milliseconds (ms), with a maximum value of 600,000 (equivalent to 10 minutes). |
sampleRate | number | 80000 | No | Sampling rate (not supported on PC) |
numberOfChannels | number | 2 | No | Number of audio recording channels |
encodeBitRate | number | 48000 | No | Encoding bitrate, with valid values provided in the table below. |
format | string | aac | No | Audio Format |
frameSize | number | - | No | Specify the frame size in kilobytes (KB). Upon passing in the frameSize, the content of the files recorded to the specified frame size will be called back. If not specified, no callback will occur. Currently, only mp3 and pcm formats are supported. |
audioSource | string | auto | No | Specify the audio input source for audio recording. |
object.numberOfChannels Legal values
Legal value | Description |
1 | 1 channel |
2 | 2 channel |
object.format Legal values
Legal value | Description |
mp3 | mp3 |
aac | aac |
wav | wav |
PCM | pcm |
object.audioSource Legal values
Legal value | Description |
auto | Automatically set up, the default use of cell phone microphone, plug in the headset automatically switch to use the headset microphone, all platforms applicable |
buildInMic | Cellular microphone, iOS only |
headsetMic | Wired headset microphone, iOS only |
mic | Microphone (phone microphone when headset is not plugged in, headset microphone when headset is plugged in), Android only |
camcorder | Same as mic for recording audio and video content, Android only |
voice_communication | Same as mic, for real-time communication, Android only |
voice_recognition | Same as mic, for speech recognition, Android only |
Sampling rate and encoding bitrate limits
Each sampling rate corresponds to a valid range of encoding bitrates. Setting an invalid sampling rate or encoding bitrate will result in audio recording failure. The specific correspondences are as follows in the table.
Sampling rate. | Encoding bitrate |
8000 | 16000 ~ 48000 |
11025 | 16000 ~ 48000 |
12000 | 24000 ~ 64000 |
16000 | 24000 ~ 96000 |
22050 | 32000 ~ 128000 |
24000 | 32000 ~ 128000 |
32000 | 48000 ~ 192000 |
44100 | 64000 ~ 320000 |
48000 | 64000 ~ 320000 |
.stop
This method is used via RecorderManager.stop().
Feature Description: Stop audio recording.
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No