Présentation de l’audio spatial

L'API Qt Spatial Audio fournit un certain nombre de classes permettant la création d'une scène sonore en trois dimensions. Celle-ci est définie par des objets situés dans l'espace 3D qui émettent du son, ainsi que par la géométrie environnante pouvant être modélisée à l'aide d'une ou plusieurs pièces. Enfin, un auditeur peut être placé dans cette scène sonore à une position et selon une orientation spécifiées.

Des API C++ et QML sont disponibles.

Création d’une scène sonore

Pour créer la scène sonore, il faut d'abord instancier un objet ` QAudioEngine`. Ce moteur traite les données sonores et les géométries d'entrée afin de créer une représentation réaliste de la scène sonore telle qu'elle serait perçue par une personne placée à un emplacement spécifique au sein de la scène.

La propriété ` QAudioEngine::OutputMode ` permet d'optimiser la sortie soit pour un casque utilisant un rendu binaural (3D virtuel), soit pour une configuration de haut-parleurs stéréo ou surround.

Le périphérique de sortie peut être sélectionné à l’aide de la propriété ` QAudioEngine::outputDevice `.

Une fois le moteur configuré, il est possible de placer divers objets sonores dans la scène en créant des objets ` QSpatialSound ` et en spécifiant l’URL d’un fichier audio à l’aide de la propriété ` QSpatialSound::source `.

QAudioListener La propriété `listener` permet de définir la position et l’orientation d’une personne écoutant la scène sonore. Un moteur ne peut prendre en charge qu’un seul auditeur au maximum. Si aucun auditeur n’est spécifié, le moteur suppose que l’auditeur se trouve à l’origine du système de coordonnées, orienté dans la direction positive de l’axe z, l’axe y positif pointant vers le haut.

En plus des sources sonores et d’un auditeur, vous pouvez définir une géométrie qui influence la façon dont le son est perçu par l’auditeur grâce à un ensemble d’objets « QAudioRoom ». Les pièces sont rectangulaires et prennent en charge une grande variété de matériaux pour chaque mur, offrant ainsi une expérience différente grâce à des réflexions sonores et une réverbération variées. Les effets de pièce s’appliquent si l’auditeur se trouve à l’intérieur de l’une d’entre elles. S’il se trouve à l’intérieur de plusieurs pièces, c’est celle dont le volume géométrique est le plus petit qui prévaudra.

Si vous avez besoin d’une superposition stéréo indépendante de la position et de l’orientation de l’auditeur (comme une musique de fond ou une voix off), vous pouvez utiliser QAmbientSound pour créer cette superposition sonore.

Pour découvrir un petit exemple basé sur QWidget illustrant une source audio pouvant être déplacée dans une pièce, consultez l’exemple de panoramique audio spatial.

Documentation de référence

Classes C++

Types QML