# 已编码音频数据 (/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-encoded)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## registerAudioEncodedFrameObserver [#registeraudioencodedframeobserver]
注册编码音频数据的观察器。
```cpp
virtual int registerAudioEncodedFrameObserver(const AudioEncodedFrameObserverConfig& config, IAudioEncodedFrameObserver *observer) = 0;
```
:::note
注: 你需要在加入频道后调用该方法。你可以调用该方法或 `startAudioRecording` 来设置音频文件的录制类型和质量,但声网不建议同时使用这两个方法。只有后调用的方法会生效。
:::
### 参数 [#参数]
编码音频的观察器配置。详见 [AudioEncodedFrameObserverConfig](/zh-CN/api-reference/rtc/cpp-all-platforms/class-audioencodedframeobserverconfig)。
编码音频数据的观察器。详见 [IAudioEncodedFrameObserver](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_iaudioencodedframeobserver)。
### 返回值 [#返回值]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类]
- [IRtcEngine](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_irtcengine)
## onMixedAudioEncodedFrame [#onmixedaudioencodedframe]
本地和所有远端用户的混音编码音频数据回调。
```cpp
virtual void onMixedAudioEncodedFrame(const uint8_t* frameBuffer, int length, const EncodedAudioFrameInfo& audioEncodedFrameInfo) = 0;
```
调用 [registerAudioEncodedFrameObserver](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-encoded#api_irtcengine_registeraudioencodedframeobserver) 并将音频配置设置为 `AUDIO_ENCODED_FRAME_OBSERVER_POSITION_MIXED` 后,可以通过该回调获取本地和所有远端用户的混音编码音频数据。
### 参数 [#参数-1]
音频数据缓冲区。
音频数据的字节长度。
编码后的音频帧信息。详见 [EncodedAudioFrameInfo](/zh-CN/api-reference/rtc/cpp-all-platforms/class-encodedaudioframeinfo)。
### 所属接口类 [#所属接口类-1]
- [IAudioEncodedFrameObserver](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_iaudioencodedframeobserver)
## onPlaybackAudioEncodedFrame [#onplaybackaudioencodedframe]
获取所有远端用户编码音频数据的回调。
```cpp
virtual void onPlaybackAudioEncodedFrame(const uint8_t* frameBuffer, int length, const EncodedAudioFrameInfo& audioEncodedFrameInfo) = 0;
```
调用 [registerAudioEncodedFrameObserver](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-encoded#api_irtcengine_registeraudioencodedframeobserver) 并将编码音频位置设置为 `AUDIO_ENCODED_FRAME_OBSERVER_POSITION_PLAYBACK` 后,可以通过该回调获取所有远端用户的编码音频数据。
### 参数 [#参数-2]
音频数据缓冲区。
音频数据的长度,单位为字节。
编码后的音频帧信息。详见 [EncodedAudioFrameInfo](/zh-CN/api-reference/rtc/cpp-all-platforms/class-encodedaudioframeinfo)。
### 所属接口类 [#所属接口类-2]
- [IAudioEncodedFrameObserver](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_iaudioencodedframeobserver)
## onRecordAudioEncodedFrame [#onrecordaudioencodedframe]
本地用户编码后音频数据回调。
```cpp
virtual void onRecordAudioEncodedFrame(const uint8_t* frameBuffer, int length, const EncodedAudioFrameInfo& audioEncodedFrameInfo) = 0;
```
调用 [registerAudioEncodedFrameObserver](/zh-CN/api-reference/rtc/cpp-all-platforms/audio/audio-encoded#api_irtcengine_registeraudioencodedframeobserver) 并将编码后音频位置设置为 `AUDIO_ENCODED_FRAME_OBSERVER_POSITION_RECORD` 后,可以通过该回调获取本地用户的编码后音频数据。
### 参数 [#参数-3]
音频数据缓冲区。
音频数据的字节长度。
编码后的音频帧信息。详见 [EncodedAudioFrameInfo](/zh-CN/api-reference/rtc/cpp-all-platforms/class-encodedaudioframeinfo)。
### 所属接口类 [#所属接口类-3]
- [IAudioEncodedFrameObserver](/zh-CN/api-reference/rtc/cpp-all-platforms/rtc-interface-class#class_iaudioencodedframeobserver)