小程序
取消
开发
中文
EN
取消
  • API
    • 媒体 /录音 /RecorderManager /RecorderManager.start /

    # RecorderManager.start(Object object)

    小程序插件：支持

    # 功能描述

    开始录音

    # 参数

    # Object object

    属性 类型 默认值 必填 说明 最低版本
    duration number 60000 否 录音的时长，单位 ms，最大值 600000（10 分钟）
    sampleRate number 8000 否 采样率（pc不支持）
    合法值 说明
    8000 8000 采样率
    11025 11025 采样率
    12000 12000 采样率
    16000 16000 采样率
    22050 22050 采样率
    24000 24000 采样率
    32000 32000 采样率
    44100 44100 采样率
    48000 48000 采样率
    numberOfChannels number 2 否 录音通道数
    合法值 说明
    1 1 个通道
    2 2 个通道
    encodeBitRate number 48000 否 编码码率，有效值见下表格
    format string aac 否 音频格式
    合法值 说明
    mp3 mp3 格式
    aac aac 格式
    wav wav 格式
    PCM pcm 格式
    frameSize number 否 指定帧大小，单位 KB。传入 frameSize 后，每录制指定帧大小的内容后，会回调录制的文件内容，不指定则不会回调。暂仅支持 mp3、pcm 格式。
    audioSource string auto 否 指定录音的音频输入源，可通过 wx.getAvailableAudioSources() 获取当前可用的音频源 2.1.0
    合法值 说明
    auto 自动设置，默认使用手机麦克风，插上耳麦后自动切换使用耳机麦克风，所有平台适用
    buildInMic 手机麦克风，仅限 iOS
    headsetMic 有线耳机麦克风，仅限 iOS
    mic 麦克风（没插耳麦时是手机麦克风，插耳麦时是耳机麦克风），仅限 Android
    camcorder 同 mic，适用于录制音视频内容，仅限 Android
    voice_communication 同 mic，适用于实时沟通，仅限 Android
    voice_recognition 同 mic，适用于语音识别，仅限 Android

    # 采样率与编码码率限制

    每种采样率有对应的编码码率范围有效值，设置不合法的采样率或编码码率会导致录音失败，具体对应关系如下表。

    采样率 编码码率
    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