# AudioRecordingConfiguration (/zh-CN/api-reference/rtc/harmonyos/class-audiorecordingconfiguration)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="class_audiorecordingconfiguration__prototype"></a>

```ts
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;
  }
}
```

<a id="class_audiorecordingconfiguration__parameters"></a>

##

<ParameterList>
<a id="filepath"></a>
<Parameter name="filePath">

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

<a id="class_audiorecordingconfiguration__note_scm_klz_mqb"></a>

:::caution
注意：

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

</Parameter>
<a id="codec"></a>
<Parameter name="codec">

设置是否编码音频数据：

<a id="class_audiorecordingconfiguration__ul_bnv_mlz_mqb"></a>

- `true`: 将音频数据用 AAC 编码。
- `false`:（默认）不编码音频数据，直接保存录制的音频数据。

</Parameter>
<a id="samplerate"></a>
<Parameter name="sampleRate">

录音采样率（Hz）。

<a id="class_audiorecordingconfiguration__ul_pqs_slz_mqb"></a>

- 16000
- 32000 （默认）
- 44100
- 48000

<a id="class_audiorecordingconfiguration__note_gdq_zlz_mqb"></a>

:::caution
注意：

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

录音内容：

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

</Parameter>
<a id="quality"></a>
<Parameter name="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 左右。

<a id="class_audiorecordingconfiguration__note_hrx_mmz_mqb"></a>

:::caution
注意：

该参数仅适用于 AAC 文件。
:::

</Parameter>
<a id="recordingchannel"></a>
<Parameter name="recordingChannel">

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

- 1:（默认）单声道。
- 2: 双声道。

:::note
注：

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

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

此外，集成方案也会影响最终录制的音频声道。因此，如果你希望录制立体声，请[联系技术支持](https://ticket.shengwang.cn/)协助。
:::

</Parameter>
</ParameterList>