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.
Inherited by QAudioCaptureSource, QCamera, QMediaImageViewer, QMediaPlayer, and QRadioTuner.
Properties
Public Functions
Signals
Protected Functions
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:
int | notifyInterval () const |
void | setNotifyInterval ( int milliSeconds ) |
Notifier signal:
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]
Bind object to the QMediaObject instance.
This method establishes a relationship between the media object and a helper object. The nature of the relationship depends on both parties. This methods returns true if the helper was succesfully bound, false otherwise.
The object passed must implement the QMediaBindableInterface interface.
See also QMediaBindableInterface.
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
Returns true if there is meta-data associated with this media object, else false.
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]
Detach object from the QMediaObject instance.
Disconnect the help object from the media object.
See also QMediaBindableInterface.