MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QMediaServiceProviderHint Class Reference

The QMediaServiceProviderHint class describes what is required of a QMediaService. More...

 #include <QMediaServiceProviderHint>

This class was introduced in Qt Mobility 1.0.

Public Types

enum Feature { LowLatencyPlayback, RecordingSupport, StreamPlayback, VideoSurface }
flags Features
enum Type { Null, ContentType, Device, SupportedFeatures }

Public Functions

QMediaServiceProviderHint ()
QMediaServiceProviderHint ( const QString & type, const QStringList & codecs )
QMediaServiceProviderHint ( const QByteArray & device )
QMediaServiceProviderHint ( Features features )
QMediaServiceProviderHint ( const QMediaServiceProviderHint & other )
~QMediaServiceProviderHint ()
QStringList codecs () const
QByteArray device () const
Features features () const
bool isNull () const
QString mimeType () const
Type type () const
bool operator!= ( const QMediaServiceProviderHint & other ) const
QMediaServiceProviderHint & operator= ( const QMediaServiceProviderHint & other )
bool operator== ( const QMediaServiceProviderHint & other ) const

Detailed Description

The QMediaServiceProviderHint class describes what is required of a QMediaService.

The QMediaServiceProvider class uses hints to select an appropriate media service.

Member Type Documentation

enum QMediaServiceProviderHint::Feature
flags QMediaServiceProviderHint::Features

Enumerates features a media service may provide.

Constant Value Description
QMediaServiceProviderHint::LowLatencyPlayback 0x01 The service is expected to play simple audio formats, but playback should start without significant delay. Such playback service can be used for beeps, ringtones, etc.
QMediaServiceProviderHint::RecordingSupport 0x02 The service provides audio or video recording functions.
QMediaServiceProviderHint::StreamPlayback 0x04 The service is capable of playing QIODevice based streams.
QMediaServiceProviderHint::VideoSurface 0x08 The service is capable of renderering to a QAbstractVideoSurface output.

The Features type is a typedef for QFlags<Feature>. It stores an OR combination of Feature values.

enum QMediaServiceProviderHint::Type

Enumerates the possible types of media service provider hint.

Constant Value Description
QMediaServiceProviderHint::Null 0 En empty hint, use the default service.
QMediaServiceProviderHint::ContentType 1 Select media service most suitable for certain content type.
QMediaServiceProviderHint::Device 2 Select media service which supports certain device.
QMediaServiceProviderHint::SupportedFeatures 3 Select media service supporting the set of optional features.

Member Function Documentation

QMediaServiceProviderHint::QMediaServiceProviderHint ()

Constructs an empty media service provider hint.

QMediaServiceProviderHint::QMediaServiceProviderHint ( const QString & type, const QStringList & codecs )

Constructs a ContentType media service provider hint.

This type of hint describes a service that is able to play content of a specific MIME type encoded with one or more of the listed codecs.

This function was introduced in Qt Mobility 1.0.

QMediaServiceProviderHint::QMediaServiceProviderHint ( const QByteArray & device )

Constructs a Device media service provider hint.

This type of hint describes a media service that utilizes a specific device.

This function was introduced in Qt Mobility 1.0.

QMediaServiceProviderHint::QMediaServiceProviderHint ( Features features )

Constructs a SupportedFeatures media service provider hint.

This type of hint describes a service which supports a specific set of features.

This function was introduced in Qt Mobility 1.0.

QMediaServiceProviderHint::QMediaServiceProviderHint ( const QMediaServiceProviderHint & other )

Constructs a copy of the media service provider hint other.

This function was introduced in Qt Mobility 1.0.

QMediaServiceProviderHint::~QMediaServiceProviderHint ()

Destroys a media service provider hint.

QStringList QMediaServiceProviderHint::codecs () const

Returns a list of codes a media service is expected to be able to decode.

This function was introduced in Qt Mobility 1.0.

QByteArray QMediaServiceProviderHint::device () const

Returns the name of a device a media service is expected to utilize.

This function was introduced in Qt Mobility 1.0.

Features QMediaServiceProviderHint::features () const

Returns a set of features a media service is expected to provide.

This function was introduced in Qt Mobility 1.0.

bool QMediaServiceProviderHint::isNull () const

Returns true if a media service provider is null.

This function was introduced in Qt Mobility 1.0.

QString QMediaServiceProviderHint::mimeType () const

Returns the mime type of the media a service is expected to be able play.

This function was introduced in Qt Mobility 1.0.

Type QMediaServiceProviderHint::type () const

Returns the type of a media service provider hint.

This function was introduced in Qt Mobility 1.0.

bool QMediaServiceProviderHint::operator!= ( const QMediaServiceProviderHint & other ) const

Identifies if other is not of equal value to a media service provider hint.

Returns true if the hints are not equal, and false if they are.

This function was introduced in Qt Mobility 1.0.

QMediaServiceProviderHint & QMediaServiceProviderHint::operator= ( const QMediaServiceProviderHint & other )

Assigns the value other to a media service provider hint.

This function was introduced in Qt Mobility 1.0.

bool QMediaServiceProviderHint::operator== ( const QMediaServiceProviderHint & other ) const

Identifies if other is of equal value to a media service provider hint.

Returns true if the hints are equal, and false if they are not.

This function was introduced in Qt Mobility 1.0.