# AgoraAudioParams (/zh-CN/api-reference/rtc/ios/class-audioparams)

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

<a id="class_audioparams__prototype"></a>

```objc
@interface AgoraAudioParams : NSObject
@property (assign, nonatomic) NSInteger sampleRate;
@property (assign, nonatomic) NSInteger channel;
@property (assign, nonatomic) AgoraAudioRawFrameOperationMode mode;
@property (assign, nonatomic) NSInteger samplesPerCall;
@end
```

<a id="class_audioparams__detailed_desc"></a>

你可以在以下 API 中传入 [AgoraAudioParams](/zh-CN/api-reference/rtc/ios/class-audioparams) 对象，以设置对应回调的音频数据格式：

- [getRecordAudioParams](/zh-CN/api-reference/rtc/ios/audio/audio-raw#api_iaudioframeobserver_getrecordaudioparams)：设置 [onRecordAudioFrame\:channelId:](/zh-CN/api-reference/rtc/ios/audio/audio-raw#callback_iaudioframeobserver_onrecordaudioframe) 回调的音频数据格式。
- [getPlaybackAudioParams](/zh-CN/api-reference/rtc/ios/audio/audio-raw#api_iaudioframeobserver_getplaybackaudioparams)：设置 `onPlaybackAudioFrame:` 回调的音频数据格式。
- [getMixedAudioParams](/zh-CN/api-reference/rtc/ios/audio/audio-raw#api_iaudioframeobserver_getmixedaudioparams)：设置 [onMixedAudioFrame\:channelId:](/zh-CN/api-reference/rtc/ios/audio/audio-raw#callback_iaudioframeobserver_onmixedaudioframe) 回调的音频数据格式。
- [getEarMonitoringAudioParams](/zh-CN/api-reference/rtc/ios/audio/audio-raw#api_iaudioframeobserver_getearmonitoringaudioparams)：设置 [onEarMonitoringAudioFrame:](/zh-CN/api-reference/rtc/ios/audio/audio-raw#callback_iaudioframeobserver_onearmonitoringaudioframe) 回调的音频数据格式。

:::note
注： SDK 会通过 [AgoraAudioParams](/zh-CN/api-reference/rtc/ios/class-audioparams) 中的 `samplesPerCall`、`sampleRate` 和 `channel` 参数计算采样间隔，并根据采样间隔触发 [onRecordAudioFrame\:channelId:](/zh-CN/api-reference/rtc/ios/audio/audio-raw#callback_iaudioframeobserver_onrecordaudioframe)、`onPlaybackAudioFrame:`、[onMixedAudioFrame\:channelId:](/zh-CN/api-reference/rtc/ios/audio/audio-raw#callback_iaudioframeobserver_onmixedaudioframe) 和 [onEarMonitoringAudioFrame:](/zh-CN/api-reference/rtc/ios/audio/audio-raw#callback_iaudioframeobserver_onearmonitoringaudioframe) 回调。
采样间隔（秒） = `samplesPerCall` / (`sampleRate` × `channel`)。
请确保采样间隔 ≥ 0.01 秒。
:::

<a id="class_audioparams__parameters"></a>

## 属性 [#属性]

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

音频采样率（Hz），可设置为以下值之一：

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

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

音频声道数，可设置为以下值之一：

- 1：（默认）单声道。
- 2：立体声。

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

音频数据的使用模式。详见 [AgoraAudioRawFrameOperationMode](/zh-CN/api-reference/rtc/ios/enum-rawaudioframeopmodetype)。

</Parameter>
<a id="samplespercall"></a>
<Parameter name="samplesPerCall">

每次回调的采样点数量，例如媒体推流时为 1024。

</Parameter>
</ParameterList>