QAudioOutput Class
Correspond à un canal de sortie audio. En savoir plus...
| 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érite de : | 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 pouvant être utilisé conjointement avec QMediaPlayer ou QMediaCaptureSession. Elle permet de sélectionner le périphérique de sortie physique à utiliser, de couper le son du canal et de régler le volume de celui-ci.
Remarque : sur la plateforme WebAssembly, en raison de sa nature asynchrone, le signal QMediaDevices::audioOutputsChanged() est émis lorsque la liste des sorties audio est prête. Des autorisations utilisateur sont requises. Ne fonctionne que dans des contextes https sécurisés.
Voir également QAudioInput.
Documentation sur les propriétés
device : QAudioDevice
Cette propriété indique le périphérique 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 » créé 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é indique si le son du média actuel est coupé.
La valeur sera « true » si le son est coupé ; 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 mis à l'échelle de manière linéaire, allant de 0 (silence) à 1 (volume maximal).
Remarque : les valeurs situées en dehors de cette plage seront limité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 variations linéaires du niveau sonore perçu, ce qui correspond à ce qu’un utilisateur attend normalement d’une commande de volume.
Fonctions d’accès :
| float | volume() const |
| void | setVolume(float volume) |
Signal de notification :
| void | volumeChanged(float volume) |
Voir également 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.
