MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QMediaPlaylistSourceControl Class Reference

The QMediaPlaylistSourceControl class provides access to the playlist playback functionality of a QMediaService. More...

 #include <QMediaPlaylistSourceControl>

Inherits: QMediaControl.

This class was introduced in Qt Mobility 1.0.

Public Functions

virtual ~QMediaPlaylistSourceControl ()
virtual QMediaPlaylist * playlist () const = 0
virtual void setPlaylist ( QMediaPlaylist * playlist ) = 0
  • 29 public functions inherited from QObject

Signals

void playlistChanged ( QMediaPlaylist * playlist )

Protected Functions

QMediaPlaylistSourceControl ( QObject * parent = 0 )
  • 7 protected functions inherited from QObject

Macros

QMediaPlaylistSourceControl_iid

Additional Inherited Members

  • 1 property inherited from QObject
  • 1 public slot inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QMediaPlaylistSourceControl class provides access to the playlist playback functionality of a QMediaService.

This control allows QMediaPlaylist to be passed directly to the service instead of playing media sources one by one. This control should be implemented if backend benefits from knowing the next media source to be played, for example for preloading, cross fading or gap-less playback.

If QMediaPlaylistSourceControl is provided, the backend must listen for current playlist item changes to load corresponding media source and advance the playlist with QMediaPlaylist::next() when playback of the current media is finished.

The interface name of QMediaPlaylistSourceControl is com.nokia.Qt.QMediaPlaylistSourceControl/1.0 as defined in QMediaPlaylistSourceControl_iid.

See also QMediaService::requestControl() and QMediaPlayer.

Member Function Documentation

QMediaPlaylistSourceControl::QMediaPlaylistSourceControl ( QObject * parent = 0 ) [protected]

Create a new playlist source control object with the given parent.

QMediaPlaylistSourceControl::~QMediaPlaylistSourceControl () [virtual]

Destroys the playlist control.

QMediaPlaylist * QMediaPlaylistSourceControl::playlist () const [pure virtual]

Returns the current playlist. Should return a null pointer if no playlist is assigned.

This function was introduced in Qt Mobility 1.0.

See also setPlaylist().

void QMediaPlaylistSourceControl::playlistChanged ( QMediaPlaylist * playlist ) [signal]

Signal emitted when the playlist has changed to playlist.

This function was introduced in Qt Mobility 1.0.

void QMediaPlaylistSourceControl::setPlaylist ( QMediaPlaylist * playlist ) [pure virtual]

Set the playlist of this media player to playlist. If a null pointer is passed, the playlist source should be disabled.

The current media should be replaced with the current item of the media playlist.

This function was introduced in Qt Mobility 1.0.

See also playlist().

Macro Documentation

QMediaPlaylistSourceControl_iid

com.nokia.Qt.QMediaPlaylistSourceControl/1.0

Defines the interface name of the QMediaPlaylistSourceControl class.