Sur cette page

AudioEngine QML Type

L'AudioEngine gère les objets sonores à l'intérieur d'une scène 3D. Plus d'informations...

Import Statement: import QtQuick3D.SpatialAudio

Propriétés

Description détaillée

AudioEngine gère les objets sonores à l'intérieur d'une scène 3D. Vous pouvez ajouter des objets SpatialSound à la scène pour définir les sons qui se produisent à un endroit précis de l'espace 3D. AmbientSound vous permet d'ajouter une incrustation stéréo (par exemple une voix off ou une piste sonore).

Vous pouvez utiliser AudioListener pour définir la position de la personne qui écoute le champ sonore par rapport aux sources sonores. Les sources sonores seront moins audibles si l'auditeur est plus éloigné de la source. Elles seront également affectées aux haut-parleurs correspondants en fonction de la direction entre l'auditeur et la source. Dans de nombreux cas, l'objet AudioListener peut simplement être instancié en tant qu'objet enfant de l'objet QtQuick3D.Camera.

Créez des objets AudioRoom pour simuler le son (réflexions et réverbération) d'une pièce avec certaines dimensions et différents types de murs.

AudioEngine offre un mode dans lequel Qt utilise la simulation des effets de l'oreille en utilisant des fonctions de réponse d'impulsion liées à la tête (voir aussi https://en.wikipedia.org/wiki/Sound_localization) pour localiser le son dans l'espace 3D lors de l'utilisation d'un casque et créer un effet audio spatial par le biais d'un casque.

Comme le reste de Qt Quick 3D, le moteur audio utilise un système de coordonnées en centimètres par défaut. Les axes sont définis de telle sorte que les x positifs pointent vers la droite, les y positifs pointent vers le haut et les z positifs pointent vers l'arrière.

Documentation sur les propriétés

distanceScale : real [since 6.11]

Définit l'échelle du système de coordonnées utilisé par le moteur audio spatial. Par défaut, toutes les unités sont exprimées en centimètres, conformément aux unités par défaut utilisées par Qt Quick 3D.

Définissez l'échelle de distance à 100 pour obtenir des unités en mètres.

Cette propriété a été introduite dans Qt 6.11.

masterVolume : real

Définit ou renvoie le volume global utilisé pour le rendu du champ sonore.

outputDevice : QtMultimedia.AudioDevice

Définit ou renvoie le dispositif utilisé pour la sortie du champ sonore.

outputMode : enumeration

Définit ou récupère le mode de sortie actuel du moteur.

Propriété ValeurDescription de la propriété
SurroundCorrespond à la configuration des haut-parleurs de l'appareil de sortie. Il s'agit normalement d'une configuration de haut-parleurs stéréo ou surround.
StéréoAffecte les sons à la configuration stéréo des haut-parleurs de l'appareil de sortie. Cette configuration ignore les enceintes supplémentaires et n'utilise que les canaux gauche et droit pour créer un rendu stéréo du champ sonore.
CasqueUtilisez la spatialisation casque pour créer un effet audio 3D lorsque vous écoutez le champ sonore au casque.

© 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.