IMediaPlayerSourceObserver

Provides callbacks for media players.

FOnAudioVolumeIndication

Reports the volume of the media player.

DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnAudioVolumeIndicationSource, int, volume);

The SDK triggers this callback every 200 milliseconds to report the current volume of the media player.

Parameters

volume
The volume of the media player. The value ranges from 0 to 255.

FOnMetaData

Occurs when the media metadata is received.

DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FOnMetaDataSource, int64, data, int, length);

The callback occurs when the player receives 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).

FOnPlayBufferUpdated

Reports the playback duration that the buffered data can support.

DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnPlayBufferUpdated, int64, playCachedBuffer);
When playing online media resources, the SDK triggers this callback every two seconds 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 SDK returns PLAYER_EVENT_BUFFER_LOW.
  • When the playback duration supported by the buffered data is greater than the threshold (0 by default), the SDK returns PLAYER_EVENT_BUFFER_RECOVER.

Parameters

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

FOnPlayerEvent

Reports the player events.

DECLARE_DYNAMIC_MULTICAST_DELEGATE_ThreeParams(FOnPlayerEvent, EMEDIA_PLAYER_EVENT, eventCode, int64, elapsedTime, const FString, message);
  • After calling the Seek method, the SDK triggers the callback to report the results of the seek operation.

Parameters

eventCode
The player events. See EMEDIA_PLAYER_EVENT.
elapsedTime
The time (ms) when the event occurs.
message
Information about the event.

FOnPlayerInfoUpdated

Occurs when information related to the media player changes.

DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnPlayerInfoUpdated, const FPlayerUpdatedInfo&, info);

When the information about the media player changes, the SDK triggers this callback. You can use this callback for troubleshooting.

Parameters

info
Information related to the media player. See FPlayerUpdatedInfo.

FOnPlayerSourceStateChanged

Reports the changes of playback state.

DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FOnPlayerSourceStateChanged, EMEDIA_PLAYER_STATE, state, FENUMWRAP_MEDIA_PLAYER_ERROR, ec);

When the state of the media player changes, the SDK triggers this callback to report the current playback state.

Parameters

state
The playback state. See EMEDIA_PLAYER_STATE.
reason
The reason for the changes in the media player status. See EENUMCUSTOM_MEDIA_PLAYER_ERROR.

FOnPlayerSrcInfoChanged

Occurs when the video bitrate of the media resource changes.

DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FOnPlayerSrcInfoChanged, const FSrcInfo&, from, const FSrcInfo&, to);

Parameters

from
Information about the video bitrate of the media resource being played. See FSrcInfo.
to
Information about the changed video bitrate of media resource being played. See FSrcInfo.

FOnPositionChanged

Reports the playback progress of the media file.

DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnPositionChanged, int64, position_ms);

When playing media files, the SDK triggers this callback every two second to report current playback progress.

Parameters

positionMs
The playback position (ms) of media files.
timeStampMs
The NTP timestamp (ms) of the current playback progress.

FOnPreloadEvent

Reports the events of preloaded media resources.

DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(FOnPreloadEvent, const FString, src, EPLAYER_PRELOAD_EVENT, event);

Parameters

src
The URL of the media resource.
event
Events that occur when media resources are preloaded. See EPLAYER_PRELOAD_EVENT.