Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

Capabilities Example

Files:

The Backend Capabilities example shows how to check which MIME types, audio devices, and audio effects are available.

Phonon does not implement the multimedia functionality itself, but relies on a backend to manage this. The backends do not manage the hardware directly, but use intermediate technologies: QuickTime on Mac, GStreamer on Linux, and DirectShow (which requires DirectX) on Windows.

The user may add support for new MIME types and effects to these systems, and the systems abilities may also be different. The support for multimedia MIME types, and audio effects in Phonon will therefore vary from system to system.

Backends informs the programmer about current capabilities through an implementation of the Phonon::BackendCapabilities namespace. The backend reports which MIME types can be played back, which audio effects are available, and which sound devices are available on the system. When the capabilities of a backend changes, it will emit the capabilitiesChanged() signal.

The example consists of one class, Window, which displays capabilities information from the current backend used by Phonon.

See the Phonon Overview for a high-level introduction to Phonon.

Window Class Definition

The Window class queries the Phonon backend for its capabilities. The results are presented in a GUI consisting of standard Qt widgets. We will now take a tour of the Phonon related parts of both the definition and implementation of the Window class.

 private slots:
     void updateWidgets();

 private:
     void setupUi();
     void setupBackendBox();

     QGroupBox *backendBox;

     QLabel *devicesLabel;
     QLabel *mimeTypesLabel;
     QLabel *effectsLabel;

     QListWidget *mimeListWidget;
     QListView *devicesListView;
     QTreeWidget *effectsTreeWidget;

We need the slot to notice changes in the backends capabilities.

mimeListWidget and devicesListView lists MIME types and audio devices. The effectsTreeWidget lists audio effects, and expands to show their parameters.

The setupUi() and setupBackendBox() private utility functions create the widgets and lays them out. We skip these functions while discussing the implementation because they do not contain Phonon relevant code.

Window Class Implementation

Our examination starts with a look at the constructor:

 Window::Window()
 {
     setupUi();
     updateWidgets();

     connect(Phonon::BackendCapabilities::notifier(),
             SIGNAL(capabilitiesChanged()), this, SLOT(updateWidgets()));
     connect(Phonon::BackendCapabilities::notifier(),
             SIGNAL(availableAudioOutputDevicesChanged()), SLOT(updateWidgets()));
 }

After creating the user interface, we call updateWidgets(), which will fill the widgets with the information we get from the backend. We then connect the slot to the capabilitiesChanged() and availableAudioOutputDevicesChanged() signals in case the backend's abilities changes while the example is running. The signal is emitted by a Phonon::BackendCapabilities::Notifier object, which listens for changes in the backend.

In the updateWidgets() function, we query the backend for information it has about its abilities and present it in the GUI of Window. We dissect it here:

 void Window::updateWidgets()
 {
     devicesListView->setModel(new QStandardItemModel());
     Phonon::ObjectDescriptionModel<Phonon::AudioOutputDeviceType> *model =
             new Phonon::ObjectDescriptionModel<Phonon::AudioOutputDeviceType>();
     model->setModelData(Phonon::BackendCapabilities::availableAudioOutputDevices());
     devicesListView->setModel(model);

The availableAudioOutputDevicesChanged() function is a member of the Phonon::BackendCapabilities namespace. It returns a list of AudioOutputDevices, which gives us information about a particular device, e.g., a sound card or a USB headset.

Note that AudioOutputDevice and also EffectDescription, which is described shortly, are typedefs of ObjectDescriptionType.

The ObjectDescriptionModel is a convenience model that displays the names of the devices. Their descriptions are shown as tooltips and disabled devices are shown in gray.

     mimeListWidget->clear();
     QStringList mimeTypes =
             Phonon::BackendCapabilities::availableMimeTypes();
     foreach (QString mimeType, mimeTypes) {
         QListWidgetItem *item = new QListWidgetItem(mimeListWidget);
         item->setText(mimeType);
     }

The MIME types supported are given as strings in a QStringList. We can therefore create a list widget item with the string, and append it to the mimeListWidget, which displays the available MIME types.

     effectsTreeWidget->clear();
     QList<Phonon::EffectDescription> effects =
         Phonon::BackendCapabilities::availableAudioEffects();
     foreach (Phonon::EffectDescription effect, effects) {
         QTreeWidgetItem *item = new QTreeWidgetItem(effectsTreeWidget);
         item->setText(0, tr("Effect"));
         item->setText(1, effect.name());
         item->setText(2, effect.description());

As before we add the description and name to our widget, which in this case is a QTreeWidget. A particular effect may also have parameters, which are inserted in the tree as child nodes of their effect.

         Phonon::Effect *instance = new Phonon::Effect(effect, this);
         QList<Phonon::EffectParameter> parameters = instance->parameters();
         for (int i = 0; i < parameters.size(); ++i) {
                 Phonon::EffectParameter parameter = parameters.at(i);

             QVariant defaultValue = parameter.defaultValue();
             QVariant minimumValue = parameter.minimumValue();
             QVariant maximumValue = parameter.maximumValue();

             QString valueString = QString("%1 / %2 / %3")
                     .arg(defaultValue.toString()).arg(minimumValue.toString())
                     .arg(maximumValue.toString());

             QTreeWidgetItem *parameterItem = new QTreeWidgetItem(item);
             parameterItem->setText(0, tr("Parameter"));
             parameterItem->setText(1, parameter.name());
             parameterItem->setText(2, parameter.description());
             parameterItem->setText(3, QVariant::typeToName(parameter.type()));
             parameterItem->setText(4, valueString);
         }
     }

The parameters are only accessible through an instance of the Effect class. Notice that an effect is created with the effect description.

The EffectParameter contains information about one of an effects parameters. We pick out some of the information to describe the parameter in the tree widget.

The main() function

Because Phonon uses D-Bus on Linux, it is necessary to give the application a name. You do this with setApplicationName().

 int main(int argv, char **args)
 {
     QApplication app(argv, args);
     app.setApplicationName("Phonon Capabilities Example");

     Window window;
     window.show();

     return app.exec();
 }

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 94
  2. Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
  3. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  4. Pourquoi les programmeurs sont-ils moins payés que les gestionnaires de programmes ? Manquent-ils de pouvoir de négociation ? 42
  5. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  6. 2017 : un quinquennat pour une nouvelle version du C++ ? Possible, selon Herb Sutter 9
  7. Qt Commercial : Digia organise un webinar gratuit le 27 mars sur la conception d'interfaces utilisateur et d'applications avec le framework 0
Page suivante

Le Qt Developer Network au hasard

Logo

Une application d'ingénierie

Le Qt Developer Network est un réseau de développeurs Qt anglophone, où ils peuvent partager leur expérience sur le framework. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt qtextended4.4
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
 
 
 
 
Partenaires

Hébergement Web