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 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
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.