# 音视频观测器 (/zh-CN/api-reference/rtc/android/4.6.0/playback/media-player/mediaplayer-observer) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## registerAudioFrameObserver [#registeraudioframeobserver] 注册音频帧观测器对象。 ```java int registerAudioFrameObserver(IMediaPlayerAudioFrameObserver audioFrameObserver, int mode); ``` ### 参数 [#参数] #### `audioFrameObserver` [#audioframeobserver] 音频帧观测器对象,用于接收每一帧音频数据。详见 [IMediaPlayerAudioFrameObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayeraudioframeobserver)。 #### `mode` [#mode] 音频帧的使用模式: - RAW_AUDIO_FRAME_OP_MODE_READ_ONLY (0):(默认)只读模式。例如,你通过声网 SDK 获取音频数据后,再推送 RTMP 或 RTMPS 流。 - RAW_AUDIO_FRAME_OP_MODE_READ_WRITE (2):读写模式。你可以从 AudioFrame 中读取音频数据,修改后再播放。例如,你有自己的音频特效处理模块,并进行语音预处理,如变声。 ### 返回值 [#返回值] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [IMediaPlayer](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayer) ## registerPlayerObserver [#registerplayerobserver] 注册媒体播放器观察器。 ```java int registerPlayerObserver(IMediaPlayerObserver playerObserver); ``` 用于监听媒体播放器播放过程中的事件。 ### 调用时机 [#调用时机] 该方法可以在加入频道前或加入频道后调用。 ### 参数 [#参数-1] #### `playerObserver` [#playerobserver] 媒体播放器观察器,详见 [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver)。 ### 返回值 [#返回值-1] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [IMediaPlayer](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayer) ## registerVideoFrameObserver [#registervideoframeobserver] 注册视频帧观察者对象。 ```java int registerVideoFrameObserver(IMediaPlayerVideoFrameObserver videoFrameObserver); ``` 你需要实现 [IMediaPlayerVideoFrameObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayervideoframeobserver) 类,并注册回调。成功注册后,SDK 每次接收到视频帧时都会触发已注册的回调。 ### 参数 [#参数-2] #### `videoFrameObserver` [#videoframeobserver] 用于上报每一帧视频的接收情况。详见 [IMediaPlayerVideoFrameObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayervideoframeobserver)。 ### 返回值 [#返回值-2] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [IMediaPlayer](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayer) ## unRegisterPlayerObserver [#unregisterplayerobserver] 释放媒体播放器观察者。 ```java int unRegisterPlayerObserver(IMediaPlayerObserver playerObserver); ``` ### 参数 [#参数-3] #### `playerObserver` [#playerobserver-1] 用于监听播放过程中的事件的媒体播放器观察者。详见 [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver)。 ### 返回值 [#返回值-3] - 0:方法调用成功。 - < 0:方法调用失败。详见[错误码](/zh-CN/realtime-media/rtc/reference/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [IMediaPlayer](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayer) ## onAudioVolumeIndication [#onaudiovolumeindication] 报告媒体播放器音量的回调。 ```java @CalledByNative void onAudioVolumeIndication(int volume); ``` 该回调每 200 毫秒触发一次。 ### 触发时机 [#触发时机] 该回调每 200 毫秒触发一次,用于报告媒体播放器的当前音量。 ### 参数 [#参数-4] #### `volume` [#volume] 媒体播放器的音量,取值范围为 0 到 255。 ### 所属接口类 [#所属接口类-4] - [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver) ## onFrame [#onframe] 播放器接收到音频帧时触发的回调。 ```java @CalledByNative AudioFrame onFrame(AudioFrame frame); ``` 注册音频帧观察器后,该回调会在播放器每次接收到音频帧时触发。 ### 触发时机 [#触发时机-1] 该回调在播放器接收到音频帧时被触发。 ### 参数 [#参数-5] #### `frame` [#frame] 音频帧信息,详见 [AudioFrame](/zh-CN/api-reference/rtc/android/class-and-enum/classes/class-audioframe)。 ### 返回值 [#返回值-4] 在调用 [registerAudioFrameObserver](/zh-CN/api-reference/rtc/android/audio/audio-raw#api_irtcengine_registeraudioframeobserver) 并设置 `mode` 参数后传入的音频数据,用于处理音频数据。 ### 所属接口类 [#所属接口类-5] - [IMediaPlayerAudioFrameObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayeraudioframeobserver) ## onFrame [#onframe-1] 播放器接收到视频帧时触发的回调。 ```java @CalledByNative void onFrame(VideoFrame frame); ``` 注册视频帧观察器后,该回调在播放器接收到视频帧时被触发。 ### 触发时机 [#触发时机-2] 该回调在播放器接收到视频帧时被触发。 ### 参数 [#参数-6] #### `frame` [#frame-1] 视频帧信息。 ### 所属接口类 [#所属接口类-6] - [IMediaPlayerVideoFrameObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayervideoframeobserver) ## onMetaData [#onmetadata] 接收到媒体元数据时触发的回调。 ```java void onMetaData(Constants.MediaPlayerMetadataType type, byte[] data) ``` 该回调在播放器接收到媒体元数据时被触发。 ### 触发时机 [#触发时机-3] 该回调在播放器接收到媒体元数据时被触发。 ### 参数 [#参数-7] #### `type` [#type] 媒体元数据的类型,详见 [MediaPlayerMetadataType](/zh-CN/api-reference/rtc/android/class-and-enum/enums/enum-mediaplayermetadatatype)。 #### `data` [#data] 媒体元数据的详细内容。 ### 所属接口类 [#所属接口类-7] - [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver) ## onPlayBufferUpdated [#onplaybufferupdated] onPlayBufferUpdated 回调:报告缓冲数据可支持的播放时长。 ```java void onPlayBufferUpdated(long playCachedBuffer) ``` 该回调在播放在线媒体资源时每两秒触发一次。 - 当缓冲数据可支持的播放时长小于阈值(默认值为 0)时,SDK 返回 PLAYER_EVENT_BUFFER_LOW (6)。 - 当缓冲数据可支持的播放时长大于阈值(默认值为 0)时,SDK 返回 PLAYER_EVENT_BUFFER_RECOVER (7)。 ### 触发时机 [#触发时机-4] 该回调在播放在线媒体资源时每两秒被触发。 ### 参数 [#参数-8] #### `playCachedBuffer` [#playcachedbuffer] 缓冲数据可支持的播放时长,单位为毫秒。 ### 所属接口类 [#所属接口类-8] - [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver) ## onPlayerEvent [#onplayerevent] 播放器事件回调。 ```java void onPlayerEvent(Constants.MediaPlayerEvent eventCode, long elapsedTime, String message) ``` 调用 [seek](/zh-CN/api-reference/rtc/android/playback/rte-player#api_player_seek) 方法后,SDK 会触发该回调报告操作结果。 ### 参数 [#参数-9] #### `eventCode` [#eventcode] 播放器事件,详见 [MediaPlayerEvent](/zh-CN/api-reference/rtc/android/class-and-enum/enums/enum-mediaplayerevent)。 #### `elapsedTime` [#elapsedtime] 事件发生的时间,单位为毫秒。 #### `message` [#message] 关于该事件的补充信息。 ### 所属接口类 [#所属接口类-9] - [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver) ## onPlayerInfoUpdated [#onplayerinfoupdated] 媒体播放器相关信息发生变化时的回调。 ```java @CalledByNative void onPlayerInfoUpdated(PlayerUpdatedInfo info); ``` 你可以使用该回调进行故障排查。 ### 触发时机 [#触发时机-5] 该回调在媒体播放器相关信息发生变化时被触发。 ### 参数 [#参数-10] #### `info` [#info] 媒体播放器相关信息。详见 [PlayerUpdatedInfo](/zh-CN/api-reference/rtc/android/class-and-enum/classes/class-playerupdatedinfo)。 ### 所属接口类 [#所属接口类-10] - [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver) ## onPlayerStateChanged [#onplayerstatechanged] 播放状态发生改变回调。 ```java void onPlayerStateChanged(Constants.MediaPlayerState state, Constants.MediaPlayerReason reason); ``` 当媒体播放器的状态发生变化时,SDK 会触发该回调。 ### 参数 [#参数-11] #### `state` [#state] 播放状态,详见 [MediaPlayerState](/zh-CN/api-reference/rtc/android/class-and-enum/enums/enum-mediaplayerstate)。 #### `reason` [#reason] 播放状态变化的原因,详见 [MediaPlayerReason](/zh-CN/api-reference/rtc/android/class-and-enum/enums/enum-mediaplayerreason)。 ### 所属接口类 [#所属接口类-11] - [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver) ## onPlayerSrcInfoChanged [#onplayersrcinfochanged] 媒体资源视频码率发生变化回调。 ```java void onPlayerSrcInfoChanged(SrcInfo from, SrcInfo to) ``` ### 触发时机 [#触发时机-6] 该回调在媒体资源的视频码率发生变化时被触发。 ### 参数 [#参数-12] #### `from` [#from] 正在播放的媒体资源的视频码率信息。详见 [SrcInfo](/zh-CN/api-reference/rtc/android/class-and-enum/classes/class-srcinfo)。 #### `to` [#to] 变更后的视频码率信息。详见 [SrcInfo](/zh-CN/api-reference/rtc/android/class-and-enum/classes/class-srcinfo)。 ### 所属接口类 [#所属接口类-12] - [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver) ## onPositionChanged [#onpositionchanged] 播放进度回调。 ```java void onPositionChanged(long positionMs, long timestampMs) ``` 该回调用于报告媒体文件的播放进度。 ### 触发时机 [#触发时机-7] 该回调在播放媒体文件时每两秒被触发。 ### 参数 [#参数-13] #### `positionMs` [#positionms] 媒体文件的播放位置,单位为毫秒。 #### `timestampMs` [#timestampms] 当前播放进度对应的 NTP 时间戳,单位为毫秒。 :::info[注] 该参数仅在频道内生效。 ::: ### 所属接口类 [#所属接口类-13] - [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver) ## onPreloadEvent [#onpreloadevent] 预加载媒体资源事件回调。 ```java void onPreloadEvent(String src, Constants.MediaPlayerPreloadEvent event) ``` 该回调用于上报预加载媒体资源过程中发生的事件。 ### 参数 [#参数-14] #### `src` [#src] 媒体资源的 URL。 #### `event` [#event] 预加载媒体资源时发生的事件。详见 [MediaPlayerPreloadEvent](/zh-CN/api-reference/rtc/android/class-and-enum/enums/enum-playerpreloadevent)。 ### 所属接口类 [#所属接口类-14] - [IMediaPlayerObserver](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayersourceobserver) ## onReadData [#onreaddata] SDK 读取媒体资源数据时触发的回调。 ```java @CalledByNative int onReadData(ByteBuffer buffer, int bufferSize); ``` 当你调用 [openWithMediaSource](/zh-CN/api-reference/rtc/android/playback/media-player/mediaplayer-open#api_imediaplayer_openwithmediasource) 方法打开媒体资源时,SDK 会触发该回调,并请求你传入媒体资源数据的缓冲区。 ### 参数 [#参数-15] #### `buffer` [#buffer] 数据缓冲区。你需要将 SDK 请求的 `bufferSize` 字节数据写入该缓冲区。详见 `ByteBuffer`。 #### `bufferSize` [#buffersize] 数据缓冲区的长度,单位为字节。 ### 返回值 [#返回值-5] - 数据读取成功时,返回实际读取的数据长度(字节)。 - 数据读取失败时,返回 0。 ### 所属接口类 [#所属接口类-15] - [IMediaPlayerCustomDataProvider](/zh-CN/api-reference/rtc/android/full-sdk-api-list#class_imediaplayercustomdataprovider)