# FAudioRecordingConfiguration (/zh-CN/api-reference/rtc/unreal-blueprint/class-audiorecordingconfiguration)

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

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

```cpp
USTRUCT(BlueprintType)
struct FAudioRecordingConfiguration
{
	GENERATED_BODY()
public:
	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|AudioRecordingConfiguration")
	FString filePath = "";
	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|AudioRecordingConfiguration")
	bool encode = false;
	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|AudioRecordingConfiguration")
	int sampleRate = 0;
	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|AudioRecordingConfiguration")
	EAUDIO_FILE_RECORDING_TYPE fileRecordingType = EAUDIO_FILE_RECORDING_TYPE::AUDIO_FILE_RECORDING_MIXED;
	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|AudioRecordingConfiguration")
	EAUDIO_RECORDING_QUALITY_TYPE quality = EAUDIO_RECORDING_QUALITY_TYPE::AUDIO_RECORDING_QUALITY_LOW;
	UPROPERTY(VisibleAnywhere, BlueprintReadWrite, Category = "Agora|AudioRecordingConfiguration")
	int recordingChannel = 0;
	FAudioRecordingConfiguration(){}
	FAudioRecordingConfiguration(const agora::rtc::AudioRecordingConfiguration & AgoraData){
		filePath = UTF8_TO_TCHAR(AgoraData.filePath);
		encode = AgoraData.encode;
		sampleRate = AgoraData.sampleRate;
		fileRecordingType = static_cast<EAUDIO_FILE_RECORDING_TYPE>(AgoraData.fileRecordingType);
		quality = static_cast<EAUDIO_RECORDING_QUALITY_TYPE>(AgoraData.quality);
		recordingChannel = AgoraData.recordingChannel;
	}
	agora::rtc::AudioRecordingConfiguration CreateAgoraData() const {
		agora::rtc::AudioRecordingConfiguration AgoraData;
		SET_UABT_FSTRING_TO_CONST_CHAR___MEMALLOC(AgoraData.filePath, this->filePath)
		AgoraData.encode = encode;
		AgoraData.sampleRate = sampleRate;
		AgoraData.fileRecordingType = static_cast<agora::rtc::AUDIO_FILE_RECORDING_TYPE>(fileRecordingType);
		AgoraData.quality = static_cast<agora::rtc::AUDIO_RECORDING_QUALITY_TYPE>(quality);
		AgoraData.recordingChannel = recordingChannel;
		return AgoraData;
	}
	void FreeAgoraData(agora::rtc::AudioRecordingConfiguration& AgoraData) const {
		SET_UABT_FSTRING_TO_CONST_CHAR___MEMFREE(AgoraData.filePath)
	}
};
```

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

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

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

录音音质。详见 [EAUDIO_RECORDING_QUALITY_TYPE](/zh-CN/api-reference/rtc/unreal-blueprint/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>