QAudioOutput Class
Représente un canal de sortie pour l'audio. Plus d'informations...
| En-tête : | #include <QAudioOutput> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Multimedia)target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake : | QT += multimedia |
| En QML : | AudioOutput |
| Héritages : | QObject |
Propriétés
Fonctions publiques
Emplacements publics
Signaux
| void | deviceChanged() |
| void | mutedChanged(bool muted) |
| void | volumeChanged(float volume) |
Description détaillée
Cette classe représente un canal de sortie qui peut être utilisé avec QMediaPlayer ou QMediaCaptureSession. Elle permet de sélectionner le périphérique de sortie physique à utiliser, de mettre le canal en sourdine et de modifier le volume du canal.
Remarque : sur la plate-forme WebAssembly, en raison de sa nature asynchrone, le signal QMediaDevices::audioOutputsChanged() est émis lorsque la liste des sorties audio est prête. Les autorisations de l'utilisateur sont requises. Ne fonctionne que dans les contextes https sécurisés.
Documentation sur les propriétés
device : QAudioDevice
Cette propriété contient le dispositif audio connecté à cette sortie.
La propriété device représente le périphérique audio auquel cette sortie est connectée. Cette propriété peut être utilisée pour sélectionner un périphérique de sortie dans la liste QMediaDevices::audioOutputs(). Vous pouvez sélectionner la sortie audio par défaut du système en définissant cette propriété sur un objet QAudioDevice construit par défaut.
Fonctions d'accès :
| QAudioDevice | device() const |
| void | setDevice(const QAudioDevice &device) |
Signal de notification :
| void | deviceChanged() |
muted : bool
Cette propriété contient l'état de sourdine du média actuel.
La valeur sera true si la sortie est en sourdine, sinon false.
Fonctions d'accès :
| bool | isMuted() const |
| void | setMuted(bool muted) |
Signal de notification :
| void | mutedChanged(bool muted) |
volume : float
Cette propriété contient le volume actuel.
Le volume est échelonné de façon linéaire, de 0 (silence) à 1 (plein volume).
Remarque : les valeurs situées en dehors de cette plage seront bridées.
Par défaut, le volume est de 1.
Les commandes de volume de l'interface utilisateur doivent généralement être mises à l'échelle de manière non linéaire. Par exemple, l'utilisation d'une échelle logarithmique produira des changements linéaires dans l'intensité sonore perçue, ce qui correspond à ce qu'un utilisateur attend normalement d'un contrôle de volume.
Fonctions d'accès :
| float | volume() const |
| void | setVolume(float volume) |
Signal de notification :
| void | volumeChanged(float volume) |
Voir aussi QtAudio::convertVolume().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
