#include <player/YiVestelVideoPlayer.h>

Inheritance diagram for CYIVestelVideoPlayer:

Public Member Functions
	CYIVestelVideoPlayer ()

virtual	~CYIVestelVideoPlayer ()

virtual CYIString	GetName_ () const override

virtual CYIString	GetVersion_ () const override

virtual Statistics	GetStatistics_ () const override

virtual bool	SupportsFormat_ (StreamingFormat eFormat, DRMScheme eDRMScheme) const override

virtual std::unique_ptr< CYIVideoSurface >	CreateSurface_ () override

virtual void	Prepare_ (const CYIUrl &videoURI, StreamingFormat eFormatHint) override

virtual void	Play_ () override

virtual void	Pause_ () override

virtual void	Stop_ () override

virtual std::vector< CYIAbstractVideoPlayer::SeekableRange >	GetLiveSeekableRanges_ () const override

virtual uint64_t	GetDurationMs_ () const override

virtual uint64_t	GetCurrentTimeMs_ () const override

virtual void	Seek_ (uint64_t uSeekPositionMS) override

virtual bool	IsMuted_ () const override

virtual void	Mute_ (bool bMute) override

virtual bool	SelectAudioTrack_ (uint32_t uID) override

virtual CYIAbstractVideoPlayer::AudioTrackInfo	GetActiveAudioTrack_ () const override

virtual std::vector< CYIAbstractVideoPlayer::AudioTrackInfo >	GetAudioTracks_ () const override

virtual void	DisableClosedCaptions_ () override

virtual bool	SelectClosedCaptionsTrack_ (uint32_t uID) override

virtual std::vector< ClosedCaptionsTrackInfo >	GetClosedCaptionsTracks_ () const override

virtual CYIAbstractVideoPlayer::ClosedCaptionsTrackInfo	GetActiveClosedCaptionsTrack_ () const override

virtual void	SetMaxBitrate_ (uint64_t uMaxBitrate) override

virtual void	SetUserAgent_ (const CYIString &userAgent) override

Public Member Functions inherited from CYIAbstractVideoPlayer
virtual	~CYIAbstractVideoPlayer ()

CYIString	GetName () const

CYIString	GetVersion () const

Statistics	GetStatistics () const

void	Init ()

void	Prepare (const CYIUrl &videoURI, StreamingFormat formatHint, CYIAbstractVideoPlayer::PlaybackState initialState=CYIAbstractVideoPlayer::PlaybackState::Paused, std::unique_ptr< DRMConfiguration > pDRMConfiguration=nullptr, uint64_t startTimeMs=0)

void	Prepare (const std::shared_ptr< CYIAssetVideo > &videoAsset, StreamingFormat formatHint, CYIAbstractVideoPlayer::PlaybackState initialState=CYIAbstractVideoPlayer::PlaybackState::Paused, std::unique_ptr< DRMConfiguration > pDRMConfiguration=nullptr, uint64_t startTimeMs=0)

void	Play ()

void	Pause ()

void	Stop ()

std::vector< SeekableRange >	GetLiveSeekableRanges () const

void	Seek (uint64_t seekPositionMs)

bool	SupportsFormat (StreamingFormat streamingFormat, DRMScheme drmScheme=DRMScheme::None)

uint64_t	GetDurationMs () const

uint64_t	GetCurrentTimeMs () const

CYIAbstractVideoPlayer::PlayerState	GetPlayerState () const

void	SetClosedCaptionsEnabled (bool enabled)

bool	AreClosedCaptionsTracksAvailable () const

bool	SelectClosedCaptionsTrack (uint32_t id)

std::vector< ClosedCaptionsTrackInfo >	GetClosedCaptionsTracks () const

ClosedCaptionsTrackInfo	GetActiveClosedCaptionsTrack () const

CYIClosedCaptionsDispatcher *	GetClosedCaptionsDispatcher () const

CYIVideoSurface *	GetSurface () const

bool	AreAudioTracksAvailable () const

bool	SelectAudioTrack (uint32_t id)

std::vector< AudioTrackInfo >	GetAudioTracks () const

AudioTrackInfo	GetActiveAudioTrack () const

bool	IsMuted () const

void	Mute (bool mute)

void	SetMaxBitrate (uint64_t maxBitrate)

void	SetInitialBandwidthHint (uint64_t initialBandwidthHint)

void	SetUserAgent (const CYIString &userAgent)

const DRMConfiguration *	GetDRMConfiguration () const

DRMConfiguration *	GetDRMConfiguration ()

BackgroundPlaybackInterface *	GetBackgroundPlaybackInterface () const

HeadphoneJackInterface *	GetHeadphoneJackInterface () const

BufferingInterface *	GetBufferingInterface () const

TimedMetadataInterface *	GetTimedMetadataInterface () const

VideoRequestHTTPHeadersInterface *	GetVideoRequestHTTPHeadersInterface ()

MediaPlaybackControlsInterface *	GetMediaPlaybackControlsInterface () const

void	SetRefreshDRMConfigurationCallback (RefreshDRMConfigurationCallback callback)

Public Member Functions inherited from CYISignalHandler
	CYISignalHandler ()

	CYISignalHandler (const CYISignalHandler &rSignalHandler)

virtual	~CYISignalHandler ()

CYISignalHandler &	operator= (const CYISignalHandler &rSignalHandler)

void	MoveToThread (CYIThread *pThread)
	This function allows the user to override the default thread affinity to any CYIThread that may or may not be running. More...

CYIThreadHandle	GetThreadAffinity () const

void	SetThreadAffinity (const CYIThreadHandle &rThreadAffinity)

virtual bool	IsConnected () const

virtual bool	IsConnected (const CYISignalBase &rSignal) const

void	Disconnect (CYISignalBase &rSignal)

void	DisconnectFromAllSignals ()

Public Member Functions inherited from CYIThread::Listener
	Listener ()

virtual	~Listener ()

virtual void	OnThreadStarted (CYIThread *)

virtual void	OnThreadTerminated (CYIThread *)

virtual void	OnThreadFinished (CYIThread *)

Additional Inherited Members
Public Types inherited from CYIAbstractVideoPlayer
enum	MediaState { MediaState::Unloaded, MediaState::Preparing, MediaState::Ready }

enum	PlaybackState { PlaybackState::Playing, PlaybackState::Paused, PlaybackState::Buffering }

enum	StreamingFormat { StreamingFormat::HLS = 0, StreamingFormat::Smooth, StreamingFormat::DASH, StreamingFormat::MP4 }

enum	DRMScheme { DRMScheme::None = 0, DRMScheme::FairPlay, DRMScheme::PlayReady, DRMScheme::WidevineModular, DRMScheme::WidevineModularCustomRequest }

enum	ErrorCode { ErrorCode::PlaybackError, ErrorCode::UnsupportedFormat, ErrorCode::StateTransitionError, ErrorCode::DRMError, ErrorCode::InitializationError, ErrorCode::Unknown }

using	RTTIInstantiatability = CYIRuntimeTypeInfo::NonInstantiableTag

using	RefreshDRMConfigurationCallback = std::function< std::unique_ptr< CYIAbstractVideoPlayer::DRMConfiguration >(std::unique_ptr< CYIAbstractVideoPlayer::DRMConfiguration >)>

Public Attributes inherited from CYIAbstractVideoPlayer
CYISignal	BufferingStarted

CYISignal	BufferingEnded

CYISignal< Error >	ErrorOccurred

CYISignal	Preparing

CYISignal	Ready

CYISignal	Playing

CYISignal	Paused

CYISignal	PlaybackComplete

CYISignal	Finalized

CYISignal< uint64_t >	CurrentTimeUpdated

CYISignal< uint64_t >	DurationChanged

CYISignal< bool, uint64_t >	SeekCompleted

CYISignal< const CYIAbstractVideoPlayer::PlayerState & >	PlayerStateChanged

CYISignal< std::vector< AudioTrackInfo > >	AvailableAudioTracksChanged

CYISignal< std::vector< ClosedCaptionsTrackInfo > >	AvailableClosedCaptionsTracksChanged

CYISignal< float >	TotalBitrateChanged

CYISignal< float >	VideoBitrateChanged

CYISignal< float >	AudioBitrateChanged

Protected Member Functions inherited from CYIAbstractVideoPlayer
	CYIAbstractVideoPlayer ()

const std::shared_ptr< CYIMaterial > &	GetVideoMaterial () const

void	SetVideoSurfaceSize (const glm::ivec2 &size)

void	ChangeInitialPlaybackState (CYIAbstractVideoPlayer::PlaybackState initialState)

CYIAbstractVideoPlayer::PlaybackState	GetRequestedInitialPlaybackState () const

void	CheckAndNotifyMediaTracksChanged ()

void	UpdateCurrentTime ()

void	OnRefreshDRMConfiguration ()

virtual void	Init_ ()

virtual bool	HasNativeStartTimeHandling_ () const

virtual bool	HasNativeBitrateEventHandling_ () const

virtual bool	HasNativeSeekEventHandling_ () const

virtual bool	HasInitialBandwidthHintHandling_ () const

virtual void	GetClosedCaptionsDispatcher_ () const

virtual BackgroundPlaybackInterface *	GetBackgroundPlaybackInterface_ () const

virtual HeadphoneJackInterface *	GetHeadphoneJackInterface_ () const

virtual BufferingInterface *	GetBufferingInterface_ () const

virtual TimedMetadataInterface *	GetTimedMetadataInterface_ () const

virtual VideoRequestHTTPHeadersInterface *	GetVideoRequestHTTPHeadersInterface_ ()

virtual MediaPlaybackControlsInterface *	GetMediaPlaybackControlsInterface_ () const

Protected Attributes inherited from CYIAbstractVideoPlayer
CYISignal< Error >	NotifyErrorOccurred

CYISignal	NotifyPlaybackComplete

CYISignal< uint64_t >	NotifyDurationChanged

CYISignal< bool, uint64_t >	NotifySeekCompleted

std::unique_ptr< CYIVideoPlayerStateManager >	m_pStateManager

std::unique_ptr< CYIClosedCaptionsDispatcher >	m_pClosedCaptionsDispatcher

std::unique_ptr< DRMConfiguration >	m_pDRMConfiguration

uint64_t	m_maxBitrate

uint64_t	m_initialBandwidthHint

uint64_t	m_initialStartTimeMs

RefreshDRMConfigurationCallback	m_refreshDRMConfigurationCallback

Constructor & Destructor Documentation

◆ CYIVestelVideoPlayer()

CYIVestelVideoPlayer::CYIVestelVideoPlayer ( )

◆ ~CYIVestelVideoPlayer()

virtual CYIVestelVideoPlayer::~CYIVestelVideoPlayer ( )

virtual

Member Function Documentation

◆ CreateSurface_()

virtual std::unique_ptr<CYIVideoSurface> CYIVestelVideoPlayer::CreateSurface_ ( )

overridevirtual

Implements CYIAbstractVideoPlayer.

◆ DisableClosedCaptions_()

virtual void CYIVestelVideoPlayer::DisableClosedCaptions_ ( )

overridevirtual

Subclasses must implement this function to disable closed captions. This is called when captions are disabled by selecting a track with id ClosedCaptionsTrackInfo::OFF_TRACK_ID.

Implements CYIAbstractVideoPlayer.

◆ GetActiveAudioTrack_()

virtual CYIAbstractVideoPlayer::AudioTrackInfo CYIVestelVideoPlayer::GetActiveAudioTrack_ ( ) const

overridevirtual

Subclasses must implement this function to return information about the active audio track.

This function is only called if tracks are available, so a valid AudioTrackInfo instance must be returned.

See also: GetAudioTracks_; GetActiveAudioTrack

Implements CYIAbstractVideoPlayer.

◆ GetActiveClosedCaptionsTrack_()

virtual CYIAbstractVideoPlayer::ClosedCaptionsTrackInfo CYIVestelVideoPlayer::GetActiveClosedCaptionsTrack_ ( ) const

overridevirtual

Subclasses must implement this function to return information about the active closed captions track.

This function is only called if tracks are available, so a valid ClosedCaptionsTrackInfo instance must be returned. If captions are disabled then a default constructed ClosedCaptionsTrackInfo must be returned.

See also: GetClosedCaptionsTracks_; SelectClosedCaptionsTrack

Implements CYIAbstractVideoPlayer.

◆ GetAudioTracks_()

virtual std::vector<CYIAbstractVideoPlayer::AudioTrackInfo> CYIVestelVideoPlayer::GetAudioTracks_ ( ) const

overridevirtual

Subclasses must implement this function to return a vector of available audio tracks for the currently loaded media.

The iDs of the returned tracks must be compatible with CYIAbstractVideoPlayer::SelectAudioTrack_.

This function is called each 1000 ms to check for updates to the available audio tracks.

Implements CYIAbstractVideoPlayer.

◆ GetClosedCaptionsTracks_()

virtual std::vector<ClosedCaptionsTrackInfo> CYIVestelVideoPlayer::GetClosedCaptionsTracks_ ( ) const

overridevirtual

Subclasses must implement this function to return a vector of available closed captions tracks for the currently loaded media. The "off" track is added by CYIAbstractVideoPlayer and must not be returned in this list.

The iDs of the returned tracks must be compatible with CYIAbstractVideoPlayer::SelectClosedCaptionsTrack_.

This function is called each 1000 ms to check for updates to the available audio tracks.

Implements CYIAbstractVideoPlayer.

◆ GetCurrentTimeMs_()

virtual uint64_t CYIVestelVideoPlayer::GetCurrentTimeMs_ ( ) const

overridevirtual

Subclasses must implement this function to report the current time of the video.

See also: GetCurrentTimeMs

Implements CYIAbstractVideoPlayer.

◆ GetDurationMs_()

virtual uint64_t CYIVestelVideoPlayer::GetDurationMs_ ( ) const

overridevirtual

Subclasses must implement this function to report the duration of the video.

See also: GetDurationMs

Implements CYIAbstractVideoPlayer.

◆ GetLiveSeekableRanges_()

virtual std::vector<CYIAbstractVideoPlayer::SeekableRange> CYIVestelVideoPlayer::GetLiveSeekableRanges_ ( ) const

overridevirtual

Subclasses must implement this function to report the live seekable ranges.

See also: GetLiveSeekableRanges

Implements CYIAbstractVideoPlayer.

◆ GetName_()

virtual CYIString CYIVestelVideoPlayer::GetName_ ( ) const

overridevirtual

Returns the name of the player.

Reimplemented from CYIAbstractVideoPlayer.

◆ GetStatistics_()

virtual Statistics CYIVestelVideoPlayer::GetStatistics_ ( ) const

overridevirtual

Returns the latest statistics from the player.

Reimplemented from CYIAbstractVideoPlayer.

◆ GetVersion_()

virtual CYIString CYIVestelVideoPlayer::GetVersion_ ( ) const

overridevirtual

Returns the version of the player.

Note: The default implementation simply returns the version of You.i Engine.

Reimplemented from CYIAbstractVideoPlayer.

◆ IsMuted_()

virtual bool CYIVestelVideoPlayer::IsMuted_ ( ) const

overridevirtual

Subclasses must implement this function, and return true if and only if the player is muted.

See also: Mute

Implements CYIAbstractVideoPlayer.

◆ Mute_()

virtual void CYIVestelVideoPlayer::Mute_ ( bool mute )

overridevirtual

Subclasses must implement this function to mute the player when mute is true, and unmute when mute is false.

Implements CYIAbstractVideoPlayer.

◆ Pause_()

virtual void CYIVestelVideoPlayer::Pause_ ( )

overridevirtual

Subclasses must implement this function to pause the video. When the underlying player notifies that playback has paused the player must be transitioned into the CYIAbstractVideoPlayer::PlaybackState::Paused state as follows:

m_pStateManager->TransitionToPlaybackPaused();

See also: Pause

Implements CYIAbstractVideoPlayer.

◆ Play_()

virtual void CYIVestelVideoPlayer::Play_ ( )

overridevirtual

Subclasses must implement this function to play the video. When the underyling player notifies that playback has began the player must be transitioned into the CYIAbstractVideoPlayer::PlaybackState::Playing state as follows:

m_pStateManager->TransitionToPlaybackPlaying();

See also: Play

Implements CYIAbstractVideoPlayer.

◆ Prepare_()

virtual void CYIVestelVideoPlayer::Prepare_	(	const CYIUrl &	videoURI,
		StreamingFormat	format
	)

overridevirtual

Subclasses must implement this function to prepare the video.

When a video is preparing, the player must be transitioned into the CYIAbstractVideoPlayer::MediaState::Preparing state as follows:

m_pStateManager->TransitionToMediaPreparing();

This transition typically occurs when the underlying video player notifies that it has begun preparing the media. If the underlying player does not report that media is preparing making this transition at the start of Prepare_ is recommended.

Once the video has completed preparing the player must be transitioned into the CYIAbstractVideoPlayer::MediaState::Ready state as follows:

m_pStateManager->TransitionToMediaReady();

This transition typically occurs when the underlying video player notifies that it has completed preparing the media. If the underlying player does not report that the media is ready making this transition at the end of Prepare_ is recommended.

See also: Prepare

Implements CYIAbstractVideoPlayer.

◆ Seek_()

virtual void CYIVestelVideoPlayer::Seek_ ( uint64_t seekPositionMS )

overridevirtual

Subclasses must implement this function to seek the video to a specific seekPositionMS in the video media. When seeking backwards from playback complete, the player must remain paused.

See also: Seek

Implements CYIAbstractVideoPlayer.

◆ SelectAudioTrack_()

virtual bool CYIVestelVideoPlayer::SelectAudioTrack_ ( uint32_t id )

overridevirtual

Subclasses must implement this function to switch the video player's current audio track to the one referenced by id.

CYIAbstractVideoPlayer::SelectAudioTrack will validate the id prior to this function being called.

See also: GetAudioTracks_; SelectAudioTrack

Implements CYIAbstractVideoPlayer.

◆ SelectClosedCaptionsTrack_()

virtual bool CYIVestelVideoPlayer::SelectClosedCaptionsTrack_ ( uint32_t id )

overridevirtual

Subclasses must implement this function to switch the video player's current closed captions track to the one referenced by id. Selecting a track must initiate the rendering of the subtitles to screen.

CYIAbstractVideoPlayer::SelectClosedCaptionsTrack will validate the id prior to this function being called. This function will not be called when disabling closed captions, id is guaranteed not to be ClosedCaptionsTrackInfo::OFF_TRACK_ID.

See also: GetClosedCaptionsTracks_; SelectClosedCaptionsTrack

Implements CYIAbstractVideoPlayer.

◆ SetMaxBitrate_()

virtual void CYIVestelVideoPlayer::SetMaxBitrate_ ( uint64_t maxBitrate )

overridevirtual

Subclasses may implement this function to set the maximum bitrate, in bits per second, which an adaptive media source will reach.

Reimplemented from CYIAbstractVideoPlayer.

◆ SetUserAgent_()

virtual void CYIVestelVideoPlayer::SetUserAgent_ ( const CYIString & userAgent )

overridevirtual

Subclasses may implement this function to set the user agent.

Reimplemented from CYIAbstractVideoPlayer.

◆ Stop_()

virtual void CYIVestelVideoPlayer::Stop_ ( )

overridevirtual

Subclasses must implement this function to stop the video and clean-up any resources related to the video media as the player will be transitioned into the CYIAbstractVideoPlayer::MediaState::Unloaded after this function executes.

See also: Stop

Implements CYIAbstractVideoPlayer.

◆ SupportsFormat_()

virtual bool CYIVestelVideoPlayer::SupportsFormat_	(	StreamingFormat	streamingFormat,
		DRMScheme	drmScheme
	)		const

overridevirtual

Subclasses must implement this function to indicate that they support a given format.

See also: SupportsFormat

Implements CYIAbstractVideoPlayer.

The documentation for this class was generated from the following file:

player/YiVestelVideoPlayer.h

Public Member Functions

Additional Inherited Members

Constructor & Destructor Documentation

◆ CYIVestelVideoPlayer()

◆ ~CYIVestelVideoPlayer()

Member Function Documentation

◆ CreateSurface_()

◆ DisableClosedCaptions_()

◆ GetActiveAudioTrack_()

◆ GetActiveClosedCaptionsTrack_()

◆ GetAudioTracks_()

◆ GetClosedCaptionsTracks_()

◆ GetCurrentTimeMs_()

◆ GetDurationMs_()

◆ GetLiveSeekableRanges_()

◆ GetName_()

◆ GetStatistics_()

◆ GetVersion_()

◆ IsMuted_()

◆ Mute_()

◆ Pause_()

◆ Play_()

◆ Prepare_()

◆ Seek_()

◆ SelectAudioTrack_()

◆ SelectClosedCaptionsTrack_()

◆ SetMaxBitrate_()

◆ SetUserAgent_()

◆ Stop_()

◆ SupportsFormat_()