Home · All Classes · All Functions ·

QMediaService Class Reference

The QMediaService class provides a common base class for media service implementations. More...

    #include <QMediaService>

This class is under development and is subject to change.

Inherits QObject.


Public Functions

~QMediaService ()
virtual void releaseControl ( QMediaControl * control ) = 0
virtual QMediaControl * requestControl ( const char * interface ) = 0
T requestControl ()

Protected Functions

QMediaService ( QObject * parent )

Additional Inherited Members


Detailed Description

The QMediaService class provides a common base class for media service implementations.

Media services provide implementations of the functionality promised by media objects, and allow multiple providers to implement a QMediaObject.

To provide the functionality of a QMediaObject media services implement QMediaControl interfaces. Services typically implement one core media control which provides the core feature of a media object, and some number of additional controls which provide either optional features of the media object, or features of a secondary media object or peripheral object.

A pointer to media service's QMediaControl implementation can be obtained by passing the control's interface name to the requestControl() function.

    QMediaPlayerControl *control = qobject_cast<QMediaPlayerControl *>(
            service->requestControl("com.nokia.Qt.QMediaPlayerControl/1.0"));

Media objects can use services loaded dynamically from plug-ins or implemented statically within an applications. Plug-in based services should also implement the QMediaServiceProviderPlugin interface. Static services should implement the QMediaServiceProvider interface.

See also QMediaObject, QMediaControl, QMediaServiceProvider, and QMediaServiceProviderPlugin.


Member Function Documentation

QMediaService::QMediaService ( QObject * parent )   [protected]

Construct a media service with the given parent. This class is meant as a base class for Multimedia services so this constructor is protected.

QMediaService::~QMediaService ()

Destroys a media service.

void QMediaService::releaseControl ( QMediaControl * control )   [pure virtual]

Releases a control back to the service.

QMediaControl * QMediaService::requestControl ( const char * interface )   [pure virtual]

Returns a pointer to the media control implementing interface.

If the service does not implement the control, or if it is unavailable a null pointer is returned instead.

Controls must be returned to the service when no longer needed using the releaseControl() function.

T QMediaService::requestControl ()

Returns a pointer to the media control of type T implemented by a media service.

If the service does not implement the control, or if it is unavailable a null pointer is returned instead.

Controls must be returned to the service when no longer needed using the releaseControl() function.


Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.0.2