AudioEngine QML Type
AudioEngine gestiona los objetos de sonido dentro de una escena 3D. Más información...
| Import Statement: | import QtQuick3D.SpatialAudio |
Propiedades
- distanceScale : real
(since 6.11) - masterVolume : real
- outputDevice : QtMultimedia.AudioDevice
- outputMode : enumeration
Descripción detallada
AudioEngine gestiona objetos de sonido dentro de una escena 3D. Puedes añadir objetos « SpatialSound » a la escena para definir sonidos que se producen en una ubicación específica del espacio 3D. « AmbientSound » te permite añadir una superposición estéreo (por ejemplo, una voz en off o una banda sonora).
Puedes utilizar AudioListener para definir la posición de la persona que escucha el campo sonoro en relación con las fuentes de sonido. Las fuentes de sonido serán menos audibles cuanto más lejos se encuentre el oyente de la fuente. Además, se asignarán a los altavoces correspondientes en función de la dirección entre el oyente y la fuente. En muchos casos, el objeto « AudioListener » puede instanciarse simplemente como un objeto secundario del objeto « QtQuick3D.Camera».
Crea objetos ` AudioRoom ` para simular el sonido (reflejos y reverberación) de una sala con determinadas dimensiones y diferentes tipos de paredes.
AudioEngine ofrece un modo en el que Qt simula los efectos del oído mediante funciones de respuesta impulsional relacionadas con la cabeza (véase también https://en.wikipedia.org/wiki/Sound_localization) para localizar el sonido en el espacio 3D cuando se utilizan auriculares y crear un efecto de audio espacial a través de ellos.
Al igual que el resto de Qt Quick 3D, el motor de audio utiliza un sistema de coordenadas que, por defecto, está en centímetros. Los ejes están definidos de tal forma que el eje x positivo apunta hacia la derecha, el eje y positivo apunta hacia arriba y el eje z positivo apunta hacia atrás.
Documentación de propiedades
distanceScale : real [since 6.11]
Define la escala del sistema de coordenadas que utiliza el motor de audio espacial. Por defecto, todas las unidades están expresadas en centímetros, en consonancia con las unidades predeterminadas que utiliza el Qt Quick 3D.
Establece la escala de distancia en 100 para obtener unidades en metros.
Esta propiedad se introdujo en Qt 6.11.
masterVolume : real
Establece o devuelve el volumen total que se utiliza para reproducir el campo sonoro.
outputDevice : QtMultimedia.AudioDevice
Establece o devuelve el dispositivo que se está utilizando para emitir el campo sonoro.
outputMode : enumeration
Establece o recupera el modo de salida actual del motor.
| Valor de la propiedad | Descripción |
|---|---|
| Surround | Asigna los sonidos a la configuración de altavoces del dispositivo de salida. Normalmente se trata de una configuración de altavoces estéreo o envolvente. |
| Estéreo | Asigna los sonidos a la configuración de altavoces estéreo del dispositivo de salida. De este modo, se ignorarán los altavoces adicionales y solo se utilizarán los canales izquierdo y derecho para crear una reproducción estéreo del campo sonoro. |
| Auriculares | Utiliza la espacialización para auriculares para crear un efecto de audio 3D al escuchar el campo sonoro a través de los auriculares. |
© 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.