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

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

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

```cpp
struct AudioRecordingConfiguration {
  const char* filePath;
  bool encode;
  int sampleRate;
  AUDIO_FILE_RECORDING_TYPE fileRecordingType;
  AUDIO_RECORDING_QUALITY_TYPE quality;
  int recordingChannel;

  AudioRecordingConfiguration()
    : filePath(NULL),
      encode(false),
      sampleRate(32000),
      fileRecordingType(AUDIO_FILE_RECORDING_MIXED),
      quality(AUDIO_RECORDING_QUALITY_LOW),
      recordingChannel(1) {}

  AudioRecordingConfiguration(const char* file_path, int sample_rate, AUDIO_RECORDING_QUALITY_TYPE quality_type)
    : filePath(file_path),
      encode(false),
      sampleRate(sample_rate),
      fileRecordingType(AUDIO_FILE_RECORDING_MIXED),
      quality(quality_type),
      recordingChannel(channel) {}

  AudioRecordingConfiguration(const char* file_path, bool enc, int sample_rate, AUDIO_FILE_RECORDING_TYPE type, AUDIO_RECORDING_QUALITY_TYPE quality_type)
    : filePath(file_path),
      encode(enc),
      sampleRate(sample_rate),
      fileRecordingType(type),
      quality(quality_type),
      recordingChannel(channel) {}

  AudioRecordingConfiguration(const AudioRecordingConfiguration &rhs)
    : filePath(rhs.filePath),
      encode(rhs.encode),
      sampleRate(rhs.sampleRate),
      fileRecordingType(rhs.fileRecordingType),
      quality(rhs.quality),
      recordingChannel(rhs.recordingChannel) {}
};
```

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

## 属性 [#属性]

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

录音文件在本地保存的绝对路径，需精确到文件名及格式。例如：`C:\music\audio.aac`。

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

:::caution
注意：

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

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

设置是否编码音频数据：

<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 为 AUDIO_RECORDING_QUALITY_MEDIUM 或 AUDIO_RECORDING_QUALITY_HIGH 的 AAC 文件。
:::

</Parameter>
<a id="filerecordingtype"></a>
<Parameter name="fileRecordingType">

录音内容。详见 [AUDIO_FILE_RECORDING_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-audiofilerecordingtype)。

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

录音音质。详见 [AUDIO_RECORDING_QUALITY_TYPE](/zh-CN/api-reference/rtc/unreal-cpp/enum-audiorecordingqualitytype)。

<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>