AudioEngine QML Type

AudioEngine gère les objets sonores au sein d'une scène 3D. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• distanceScale : real (since 6.11)
• masterVolume : real
• outputDevice : QtMultimedia.AudioDevice
• outputMode : enumeration

Description détaillée

AudioEngine gère les objets sonores au sein d'une scène 3D. Vous pouvez ajouter des objets « SpatialSound » à la scène pour définir des sons qui se produisent à un emplacement précis dans l'espace 3D. L'option « AmbientSound » vous permet d'ajouter une superposition stéréo (par exemple, une voix off ou une bande-son).

Vous pouvez utiliser AudioListener pour définir la position de l’auditeur par rapport aux sources sonores. Les sources sonores seront moins audibles si l’auditeur est plus éloigné de la source. Elles seront également mappées vers les 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 l’acoustique (réflexions et réverbération) d’une pièce présentant certaines dimensions et différents types de murs.

AudioEngine propose un mode dans lequel Qt simule les effets de l’oreille à l’aide de fonctions de réponse impulsionnelle liées à la tête (voir également https://en.wikipedia.org/wiki/Sound_localization) afin de localiser le son dans l’espace 3D lors de l’utilisation d’un casque et de créer un effet audio spatial via ce dernier.

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

Documentation des 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 sur 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 générer le champ sonore.

outputDevice : QtMultimedia.AudioDevice

Définit ou renvoie le périphérique utilisé pour la sortie du champ sonore.

outputMode : enumeration

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