AudioRecordingConfiguration

  • HarmonyOS

更新时间不可用

录音配置。

TypeScript
export class AudioRecordingConfiguration{

  public filePath:string;

  public sampleRate:number;

  public codec:boolean;

  public fileRecordOption:number;

  public quality:number;

  public recordingChannel:number;

  public constructor(filepath:string) {
    this.filePath = filepath;
    this.sampleRate = 32000;
    this.codec = true;
    this.fileRecordOption = Constants.AudioRecordingType.MIXED;
    this.quality = Constants.AudioRecordingQuality.MEDIUM;
    this.recordingChannel = 1;
  }
}

参数名描述
filePath

录音文件在本地保存的绝对路径,需精确到文件名及格式。例如:/sdcard/emulated/0/audio.aac。

注意:

请确保你指定的路径存在并且可写。

codec

设置是否编码音频数据:

  • true: 将音频数据用 AAC 编码。
  • false:(默认)不编码音频数据,直接保存录制的音频数据。
sampleRate

录音采样率(Hz)。

  • 16000
  • 32000 (默认)
  • 44100
  • 48000

注意:

如果把该参数设为 44100 或 48000,为保证录音效果,建议录制 WAV 文件或 quality 为 MEDIUM 或 HIGH 的 AAC 文件。

录音内容:

  • MIC (1):仅录制本地用户的音频。
  • PLAYBACK (2):仅录制所有远端用户的音频。
  • MIXED (3): (默认)录制本地和所有远端用户混音后的音频。
quality

录音音质:

  • LOW (0):低音质。例如,采样率为 32000 Hz,录音时长为 10 分钟的 AAC 文件大小约为 1.2 MB。
  • MEDIUM (1):(默认)中音质。例如,采样率为 32000 Hz,录音时长为 10 分钟的 AAC 文件大小约为 2 MB。
  • HIGH (2):高音质。例如,采样率为 32000 Hz,录音时长为 10 分钟的 AAC 文件大小约为 3.75 MB。
  • ULTRA_HIGH(3):超高音质。例如,采样率为 32000 Hz,录制 10 分钟的文件大小约为 7.5 M 左右。

注意:

该参数仅适用于 AAC 文件。

recordingChannel

录制的音频声道。目前支持如下取值:

  • 1:(默认)单声道。
  • 2: 双声道。

注:

实际录制的音频声道与你采集的音频声道有关:

  • 如果采集的音频为单声道,recordingChannel 设为 2, 则录制的音频为经过单声道数据拷贝后的双声道数据,而不是立体声。
  • 如果采集的音频为双声道,recordingChannel 设为 1,则录制的音频为经过双声道数据混合后的单声道数据。

此外,集成方案也会影响最终录制的音频声道。因此,如果你希望录制立体声,请联系技术支持协助。

表格内容超出当前宽度,可横向滚动查看更多列。

这个页面有帮助吗?