agora::rtc::IMediaPlayerSourceObserver Class Reference

Public Member Functions
virtual	~IMediaPlayerSourceObserver ()=default
virtual void	onPlayerSourceStateChanged (media::base::MEDIA_PLAYER_STATE state, media::base::MEDIA_PLAYER_ERROR ec)=0
virtual void	onPositionChanged (int64_t position_ms)=0
virtual void	onPlayerEvent (media::base::MEDIA_PLAYER_EVENT event)=0
virtual void	onMetaData (const void *data, int length)=0
virtual void	onPlayBufferUpdated (int64_t playCachedBuffer)=0
virtual void	onPreloadEvent (const char *src, media::base::PLAYER_PRELOAD_EVENT event)=0

Constructor & Destructor Documentation

~IMediaPlayerSourceObserver()

virtual agora::rtc::IMediaPlayerSourceObserver::~IMediaPlayerSourceObserver ( )

virtualdefault

Member Function Documentation

onPlayerSourceStateChanged()

virtual void agora::rtc::IMediaPlayerSourceObserver::onPlayerSourceStateChanged ( media::base::MEDIA_PLAYER_STATE  state, media::base::MEDIA_PLAYER_ERROR  ec  )

pure virtual

Triggered when the player state changes.

Parameters

state	New player state
ec	Player error message

onPositionChanged()

virtual void agora::rtc::IMediaPlayerSourceObserver::onPositionChanged ( int64_t  position_ms )

pure virtual

Reports current playback progress.

The callback occurs once every one second during the playback and reports current playback progress.

Parameters

position

Current playback progress (ms).

onPlayerEvent()

virtual void agora::rtc::IMediaPlayerSourceObserver::onPlayerEvent ( media::base::MEDIA_PLAYER_EVENT  event )

pure virtual

Reports the playback event.

• After calling the seek method, the MediaPlayer Kit occurs the callback to report the results of the seek operation.
• After calling the selectAudioTrack method, the MediaPlayer Kit occurs the callback to report that the audio track changes.

Parameters

event

The playback event. See MEDIA_PLAYER_EVENT for details.

onMetaData()

virtual void agora::rtc::IMediaPlayerSourceObserver::onMetaData ( const void *  data, int  length  )

pure virtual

Reports the reception of the media metadata.

The callback occurs when the player receivers the media metadata and reports the detailed information of the media metadata.

Parameters

data	The detailed data of the media metadata.
length	The data length (bytes).

onPlayBufferUpdated()

virtual void agora::rtc::IMediaPlayerSourceObserver::onPlayBufferUpdated ( int64_t  playCachedBuffer )

pure virtual

Reports the playback duration that the buffered data can support.

In the process of playing online media resources, the mediaplayer kit triggers this callback every one second to report the playback duration that the currently buffered data can support.

• When the playback duration supported by the buffered data is less than the threshold (0 by default), the mediaplayer kit returns PLAYER_EVENT_BUFFER_LOW(6).
• When the playback duration supported by the buffered data is greater than the threshold (0 by default), the mediaplayer kit returns PLAYER_EVENT_BUFFER_RECOVER(7).

  Parameters

  playCachedBuffer

  The playback duration (ms) that the buffered data can support.

onPreloadEvent()

virtual void agora::rtc::IMediaPlayerSourceObserver::onPreloadEvent ( const char *  src, media::base::PLAYER_PRELOAD_EVENT  event  )

pure virtual

Triggered when the player addPreloadSrc.

Parameters

event