Home · All Classes · All Functions ·

QMediaObject Class Reference

The QMediaObject class provides a common base for multimedia objects. More...

    #include <QMediaObject>

This class is under development and is subject to change.

Inherits QObject.

Inherited by QAudioCaptureSource, QMediaImageViewer, QMediaPlayer, and QRadioTuner.

Properties

Public Functions

Signals

Protected Functions

Additional Inherited Members


Detailed Description

The QMediaObject class provides a common base for multimedia objects.

QMediaObject derived classes provide access to the functionality of a QMediaService. Each media object hosts a QMediaService and uses the QMediaControl interfaces implemented by the service to implement its API. Most media objects when constructed will request a new QMediaService instance from a QMediaServiceProvider, but some like QMediaRecorder will share a service with another object.

QMediaObject itself provides an API for accessing a media service's meta-data and a means of connecting other media objects, and peripheral classes like QVideoWidget and QMediaPlaylist.

See also QMediaService and QMediaControl.


Property Documentation

notifyInterval : int

The interval at which notifiable properties will update.

The interval is expressed in milliseconds, the default value is 1000.

Access functions:

See also addPropertyWatch() and removePropertyWatch().


Member Function Documentation

QMediaObject::QMediaObject ( QObject * parent, QMediaService * service )   [protected]

Constructs a media object which uses the functionality provided by a media service.

The parent is passed to QObject.

This class is meant as a base class for Multimedia objects so this constructor is protected.

QMediaObject::~QMediaObject ()

Destroys a media object.

void QMediaObject::addPropertyWatch ( QByteArray const & name )   [protected]

Watch the property name. The property's notify signal will be emitted once every notifyInterval milliseconds.

See also notifyInterval.

void QMediaObject::availabilityChanged ( bool available )   [signal]

Signal emitted when the availability state has changed to available

QtMultimediaKit::AvailabilityError QMediaObject::availabilityError () const   [virtual]

Returns the service availability error state.

QStringList QMediaObject::availableExtendedMetaData () const

Returns a list of keys there is extended meta-data available for.

QList<QtMultimediaKit::MetaData> QMediaObject::availableMetaData () const

Returns a list of keys there is meta-data available for.

bool QMediaObject::bind ( QObject * object )   [virtual]

QVariant QMediaObject::extendedMetaData ( const QString & key ) const

Returns the value associated with a meta-data key.

The naming and type of extended meta-data is not standardized, so the values and meaning of keys may vary between backends.

bool QMediaObject::isAvailable () const   [virtual]

Returns true if the service is available for use.

bool QMediaObject::isMetaDataAvailable () const

QVariant QMediaObject::metaData ( QtMultimediaKit::MetaData key ) const

Returns the value associated with a meta-data key.

void QMediaObject::metaDataAvailableChanged ( bool available )   [signal]

Signals that the available state of a media object's meta-data has changed.

void QMediaObject::metaDataChanged ()   [signal]

Signals that a media object's meta-data has changed.

void QMediaObject::notifyIntervalChanged ( int milliseconds )   [signal]

Signal a change in the notify interval period to milliseconds.

void QMediaObject::removePropertyWatch ( QByteArray const & name )   [protected]

Remove property name from the list of properties whose changes are regularly signaled.

See also notifyInterval.

QMediaService * QMediaObject::service () const   [virtual]

Returns the media service that provides the functionality of a multimedia object.

void QMediaObject::unbind ( QObject * object )   [virtual]


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