_uc_MediaPlayer - Audio and Video Player

The _uc_MediaPlayer supports playing audio and video streams. In order to use the _uc_MediaPlayer with Qt (>=4.7 && <5.0) and the 'Phonon back end Plugins (QTDIR/plugins/phonon_backend)' have to be installed.

The data source for the player is a string property handle, which contains the complete file path to be played. The file path may contain option variables enclosed in %...%, which are resolved by the control. After changing the value in the control property handle, one may call ControlContext ::refresh() in order to signal that the property handle content has changed.

The media player control sends following string messages to the control context class:

• auto - is submitted after finishing an audio or video file. The context may decide, whether to continue with the next file or do any other action
• next - is a request for next video or audio file.
• previous - is a request to start the previous audio or video file.
• autoPlay - returns the current state of the auto play feature ( autoPlay:enable or autoPlay:disable ).
• metadata - returns metadata about artist and title as " metadata: artist ; title ". The message is send after starting to play a title, but also as reponse to a metadata question (see communication below).

• status - returns the current media status for the player as: " status:loading ". Values returned are:

• empty

• unknown

• loaded

• loading

• buffering

• buffered

• stalled

• end

• invalid

• state - returns the current player state as " status:play ". Values returned are:

• play

• pause

• stop

The application may send following commands to the media player:

• enable - enable feature passed as parameter ( enable:video or enable:audio )
• autoPlay - allows changing the current state of the auto play feature ( autoPlay:enable or autoPlay:disable ).
• playListAdd - add file to play list ( playListAdd:filename )
• playListClear - clear play list

• state - allows changing the player state. The new state is passed as parameter ( state:play , state:pause , state:stop )

Communication commands are used in order to send messages that require a reply from the media player. In order to communicate, the application has to send a command to the media player:

mplayer_ctx.message("state");

In case of communication command the player returns a message, which may be received by the doMessage() handler, which is a bit tricky, since the answer is not directly send to the one who is asking.

• status - returns the current media status via the doMessage() handler. For possible values see status message above.
• state - sending a state message without parameters to the media player returns the current media player state via the doMessage() handler. For possible values see state message above.
• autoPlay - sending an autoPlay message without parameters to the media player returns the current state of the auto play feature. For possible values see autoPlay message above.
• metadata - returns the current media metadata (title and artist) via the doMessage() handler. For possible values see metadata message above.
• playListAdd - add file to play list ( playListAdd:filename )
• playListClear - clear play list