# 原始音频数据 (/zh-CN/api-reference/rtc/react-native/audio/audio-raw)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## registerAudioFrameObserver [#registeraudioframeobserver]
注册音频观测器对象。
```ts
abstract registerAudioFrameObserver(observer: IAudioFrameObserver): number;
```
该方法用于注册音频观测器对象,即注册回调。当需要 SDK 触发 [onMixedAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onmixedaudioframe)、[onRecordAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onrecordaudioframe)、[onPlaybackAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onplaybackaudioframe)、[onPlaybackAudioFrameBeforeMixing](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserver_onplaybackaudioframebeforemixing) 和 [onEarMonitoringAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onearmonitoringaudioframe) 回调时,需要调用该方法注册回调。
### 调用时机 [#调用时机]
该方法需要在加入频道前调用。
### 参数 [#参数]
接口对象实例。详见 [IAudioFrameObserver](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_iaudioframeobserver)。建议在收到 [onLeaveChannel](/zh-CN/api-reference/rtc/react-native/channel#callback_irtcengineeventhandler_onleavechannel) 后调用,来释放音频观测器对象。
### 返回值 [#返回值]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类]
- [IMediaEngine](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_imediaengine)
## setEarMonitoringAudioFrameParameters [#setearmonitoringaudioframeparameters]
设置耳返的音频数据格式。
```ts
abstract setEarMonitoringAudioFrameParameters(
sampleRate: number,
channel: number,
mode: RawAudioFrameOpModeType,
samplesPerCall: number
): number;
```
该方法用于设置 [onEarMonitoringAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onearmonitoringaudioframe) 回调的耳返音频数据格式。
:::note
注:
- 调用该方法前,你需要先调用 [enableInEarMonitoring](/zh-CN/api-reference/rtc/react-native/audio/audio-capture#api_irtcengine_enableinearmonitoring2),将 `includeAudioFilters` 设置为 `EarMonitoringFilterBuiltInAudioFilters` 或 `EarMonitoringFilterNoiseSuppression`。
- SDK 会通过该方法中的 `samplesPerCall`、`sampleRate` 和 `channel` 参数计算出采样间隔,计算公式为采样间隔 = `samplesPerCall`/(`sampleRate` × `channel`)。请确保采样间隔不小于 0.01 秒。SDK 会根据该采样间隔触发 [onEarMonitoringAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onearmonitoringaudioframe) 回调。
:::
### 参数 [#参数-1]
[onEarMonitoringAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onearmonitoringaudioframe) 中报告音频的采样率 (Hz),可设置为 8000、 16000、 32000、44100 或 48000。
[onEarMonitoringAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onearmonitoringaudioframe) 中报告音频的声道数,可设置为 1 或 2:
- 1: 单声道。
- 2: 双声道。
音频帧的使用模式,详见 [RawAudioFrameOpModeType](/zh-CN/api-reference/rtc/react-native/enum-rawaudioframeopmodetype)。
[onEarMonitoringAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onearmonitoringaudioframe) 中报告的音频的采样点数,如旁路推流应用中通常为 1024。
### 返回值 [#返回值-1]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-1]
- [IRtcEngine](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_irtcengine)
## setMixedAudioFrameParameters [#setmixedaudioframeparameters]
设置采集和播放音频混音后的原始音频数据格式。
```ts
abstract setMixedAudioFrameParameters(
sampleRate: number,
channel: number,
samplesPerCall: number
): number;
```
SDK 会通过该方法中的 `samplesPerCall`、`sampleRate` 和 `channel` 参数计算出采样间隔,计算公式为采样间隔 = `samplesPerCall`/(`sampleRate` × `channel`)。请确保采样间隔不小于 0.01 秒。SDK 会根据该采样间隔触发 [onMixedAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onmixedaudioframe) 回调。
### 调用时机 [#调用时机-1]
该方法需要在加入频道前调用。
### 参数 [#参数-2]
音频数据的采样率 (Hz),可设置为 8000、 16000、 32000、44100 或 48000。
音频数据的声道数,可设置为 1 或 2:
- 1: 单声道。
- 2: 双声道。
音频数据的采样点数,如旁路推流应用中通常为 1024。
### 返回值 [#返回值-2]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-2]
- [IRtcEngine](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_irtcengine)
## setPlaybackAudioFrameBeforeMixingParameters [#setplaybackaudioframebeforemixingparameters]
设置混音前的原始音频播放数据格式。
```ts
abstract setPlaybackAudioFrameBeforeMixingParameters(
sampleRate: number,
channel: number
samplesPerCall: number
): number;
```
SDK 会根据该采样间隔触发 [onPlaybackAudioFrameBeforeMixing](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserver_onplaybackaudioframebeforemixing) 回调。
### 调用时机 [#调用时机-2]
该方法需要在加入频道前调用。
### 参数 [#参数-3]
音频数据的采样率 (Hz),可设置为 8000、 16000、 32000、44100 或 48000。
音频数据的声道数,可设置为 1 或 2:
- 1: 单声道。
- 2: 双声道。
设置 [onPlaybackAudioFrameBeforeMixing](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserver_onplaybackaudioframebeforemixing) 回调中返回音频数据的采样点数。在 RTMP 推流场景中,建议设置为 1024。
### 返回值 [#返回值-3]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-3]
- [IRtcEngine](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_irtcengine)
## setPlaybackAudioFrameParameters [#setplaybackaudioframeparameters]
设置播放的原始音频数据格式。
```ts
abstract setPlaybackAudioFrameParameters(
sampleRate: number,
channel: number,
mode: RawAudioFrameOpModeType,
samplesPerCall: number
): number;
```
SDK 会通过该方法中的 `samplesPerCall`、`sampleRate` 和 `channel` 参数计算出采样间隔,计算公式为采样间隔 = `samplesPerCall`/(`sampleRate` × `channel`)。请确保采样间隔不小于 0.01 秒。SDK 会根据该采样间隔触发 [onPlaybackAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onplaybackaudioframe) 回调。
### 调用时机 [#调用时机-3]
该方法需要在加入频道前调用。
### 参数 [#参数-4]
音频数据的采样率 (Hz),可设置为 8000、 16000、 24000、 32000、44100 或 48000。
音频数据的声道数,可设置为 1 或 2:
- 1: 单声道。
- 2: 双声道。
音频帧的使用模式,详见 [RawAudioFrameOpModeType](/zh-CN/api-reference/rtc/react-native/enum-rawaudioframeopmodetype)。
音频数据的采样点数,如旁路推流应用中通常为 1024。
### 返回值 [#返回值-4]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-4]
- [IRtcEngine](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_irtcengine)
## setRecordingAudioFrameParameters [#setrecordingaudioframeparameters]
设置采集的原始音频数据格式。
```ts
abstract setRecordingAudioFrameParameters(
sampleRate: number,
channel: number,
mode: RawAudioFrameOpModeType,
samplesPerCall: number
): number;
```
SDK 会通过该方法中的 `samplesPerCall`、`sampleRate` 和 `channel` 参数计算出采样间隔,计算公式为采样间隔 = `samplesPerCall`/(`sampleRate` × `channel`)。请确保采样间隔不小于 0.01 秒。SDK 会根据该采样间隔触发 [onRecordAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onrecordaudioframe) 回调。
### 调用时机 [#调用时机-4]
该方法需要在加入频道前调用。
### 参数 [#参数-5]
音频数据的采样率 (Hz),可设置为 8000、 16000、 32000、44100 或 48000。
音频数据的声道数,可设置为 1 或 2:
- 1: 单声道。
- 2: 双声道。
音频帧的使用模式,详见 [RawAudioFrameOpModeType](/zh-CN/api-reference/rtc/react-native/enum-rawaudioframeopmodetype)。
音频数据的采样点数,如旁路推流应用中通常为 1024。
### 返回值 [#返回值-5]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-5]
- [IRtcEngine](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_irtcengine)
## unregisterAudioFrameObserver [#unregisteraudioframeobserver]
取消注册音频帧观测器。
```ts
abstract unregisterAudioFrameObserver(observer: IAudioFrameObserver): number;
```
### 参数 [#参数-6]
音频帧观测器,观测每帧音频的接收,详见 [IAudioFrameObserver](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_iaudioframeobserver)。
### 返回值 [#返回值-6]
- 0: 方法调用成功。
- < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-6]
- [IMediaEngine](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_imediaengine)
## onEarMonitoringAudioFrame [#onearmonitoringaudioframe]
获得耳返的原始音频数据。
```ts
onEarMonitoringAudioFrame?(audioFrame: AudioFrame): void;
```
为保证耳返的音频数据格式符合预期,你可以使用如下方法设置耳返音频数据格式:调用 [setEarMonitoringAudioFrameParameters](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#api_irtcengine_setearmonitoringaudioframeparameters) 设置音频数据格式后,调用 [registerAudioFrameObserver](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#api_imediaengine_registeraudioframeobserver) 注册音频观测器对象,SDK 会根据该方法中的参数计算采样间隔,并根据该采样间隔触发 [onEarMonitoringAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onearmonitoringaudioframe) 回调。
### 参数 [#参数-7]
音频原始数据。详见 [AudioFrame](/zh-CN/api-reference/rtc/react-native/class-audioframe)。
### 所属接口类 [#所属接口类-7]
- [IAudioFrameObserverBase](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_iaudioframeobserverbase)
## onMixedAudioFrame [#onmixedaudioframe]
获取采集和播放音频混音后的数据。
```ts
onMixedAudioFrame?(channelId: string, audioFrame: AudioFrame): void;
```
为保证采集和播放混音后的音频数据格式符合预期,你可以在如下方法设置音频的数据格式:调用 [setMixedAudioFrameParameters](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#api_irtcengine_setmixedaudioframeparameters) 设置音频数据格式后,调用 [registerAudioFrameObserver](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#api_imediaengine_registeraudioframeobserver) 注册音频观测器对象,SDK 会根据该方法中的参数计算采样间隔,并根据该采样间隔触发 [onMixedAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onmixedaudioframe) 回调。
### 参数 [#参数-8]
音频原始数据。详见 [AudioFrame](/zh-CN/api-reference/rtc/react-native/class-audioframe)。
频道 ID。
### 所属接口类 [#所属接口类-8]
- [IAudioFrameObserverBase](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_iaudioframeobserverbase)
## onPlaybackAudioFrame [#onplaybackaudioframe]
获得播放的原始音频数据。
```ts
onPlaybackAudioFrame?(channelId: string, audioFrame: AudioFrame): void;
```
为保证播放的音频数据格式符合预期,你可以在如下方法设置音频的数据格式:调用 [setPlaybackAudioFrameParameters](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#api_irtcengine_setplaybackaudioframeparameters) 设置音频数据格式后,调用 [registerAudioFrameObserver](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#api_imediaengine_registeraudioframeobserver) 注册音频观测器对象,SDK 会根据该方法中的参数计算采样间隔,并根据该采样间隔触发 [onPlaybackAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onplaybackaudioframe) 回调。
### 参数 [#参数-9]
音频原始数据。详见 [AudioFrame](/zh-CN/api-reference/rtc/react-native/class-audioframe)。
频道 ID。
### 所属接口类 [#所属接口类-9]
- [IAudioFrameObserverBase](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_iaudioframeobserverbase)
## onPlaybackAudioFrameBeforeMixing [#onplaybackaudioframebeforemixing]
获取所订阅的远端用户混音前的声音。
```ts
onPlaybackAudioFrameBeforeMixing?(
channelId: string,
uid: number,
audioFrame: AudioFrame
): void;
```
:::note
注: 由于框架的限制,该回调不支持将处理后的音频数据发送回 SDK。
:::
### 参数 [#参数-10]
频道 ID。
订阅的远端用户的 ID。
音频原始数据。详见 [AudioFrame](/zh-CN/api-reference/rtc/react-native/class-audioframe)。
### 所属接口类 [#所属接口类-10]
- [IAudioFrameObserver](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_iaudioframeobserver)
## onRecordAudioFrame [#onrecordaudioframe]
获得采集的原始音频数据。
```ts
onRecordAudioFrame?(channelId: string, audioFrame: AudioFrame): void;
```
为保证采集的音频数据格式符合预期,你可以在如下方法设置音频的数据格式:调用 [setRecordingAudioFrameParameters](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#api_irtcengine_setrecordingaudioframeparameters) 设置音频数据格式后,调用 [registerAudioFrameObserver](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#api_imediaengine_registeraudioframeobserver) 注册音频观测器对象,SDK 会根据该方法中的参数计算采样间隔,并根据该采样间隔触发 [onRecordAudioFrame](/zh-CN/api-reference/rtc/react-native/audio/audio-raw#callback_iaudioframeobserverbase_onrecordaudioframe) 回调。
### 参数 [#参数-11]
音频原始数据。详见 [AudioFrame](/zh-CN/api-reference/rtc/react-native/class-audioframe)。
频道 ID。
### 所属接口类 [#所属接口类-11]
- [IAudioFrameObserverBase](/zh-CN/api-reference/rtc/react-native/rtc-interface-class#class_iaudioframeobserverbase)