AudioEngine QML Type

AudioEngine gestiona objetos sonoros dentro de una escena 3D. Más...

• Lista de todos los miembros, incluyendo los heredados

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. Puede añadir objetos SpatialSound a la escena para definir sonidos que se producen en una ubicación específica del espacio 3D. AmbientSound permite añadir una superposición estéreo (por ejemplo, voz en off o una banda sonora).

Puede utilizar AudioListener para definir la posición de la persona que escucha el campo sonoro con respecto a las fuentes de sonido. Las fuentes sonoras serán menos audibles si el oyente está más lejos de la fuente. También 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 ser simplemente instanciado como un objeto hijo del objeto QtQuick3D.Camera.

Cree objetos AudioRoom para simular el sonido (reflexiones y reverberación) de una sala con ciertas dimensiones y diferentes tipos de paredes.

AudioEngine ofrece un modo en el que Qt utiliza la simulación de los efectos del oído mediante funciones de respuesta al impulso 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 los auriculares.

Como el resto de Qt Quick 3D, el motor de audio utiliza por defecto un sistema de coordenadas en centímetros. Los ejes están definidos de forma que x positivo apunta hacia la derecha, y positivo apunta hacia arriba y z positivo apunta hacia atrás.

Documentación de propiedades

distanceScale : real [since 6.11]

Define la escala del sistema de coordenadas utilizado por el motor de audio espacial. Por defecto, todas las unidades están en centímetros, en línea con las unidades por defecto utilizadas por Qt Quick 3D.

Establece la escala de distancia a 100 para obtener unidades en metros.

Esta propiedad se introdujo en Qt 6.11.

masterVolume : real

Establece o devuelve el volumen general que se utiliza para renderizar el campo sonoro.

outputDevice : QtMultimedia.AudioDevice

Establece o devuelve el dispositivo que se está utilizando para la salida del campo sonoro.

outputMode : enumeration

Establece o recupera el modo de salida actual del motor.