SpatialSound QML Type

Un objeto sonoro en el espacio 3D. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• autoPlay : bool
• directivity : real
• directivityOrder : real
• distanceCutoff : real
• distanceModel : enumeration
• loops : int
• manualAttenuation : real
• nearFieldGain : real
• occlusionIntensity : real
• size : real
• source : url
• volume : real

Métodos

• void pause()
• void play()
• void stop()

Descripción detallada

Un SpatialSound representa un objeto audible en el espacio 3D. Puede definir su posición y orientación en el espacio, establecer el sonido que está reproduciendo y definir un volumen para el objeto.

El objeto puede tener diferentes comportamientos de atenuación, emitir sonido principalmente en una dirección o esféricamente, y comportarse como si estuviera ocluido por algún otro objeto.

Documentación de propiedades

autoPlay : bool

Determina si el sonido debe empezar a reproducirse automáticamente cuando se especifica una fuente.

El valor predeterminado es true.

directivity : real

Define la directividad de la fuente de sonido. Un valor de 0 implica que el sonido se emite por igual en todas las direcciones, mientras que un valor de 1 implica que la fuente emite sonido principalmente en la dirección hacia delante.

Los valores válidos están entre 0 y 1, el valor por defecto es 0.

directivityOrder : real

Define el orden de la directividad de la fuente sonora. Un orden más alto implica una localización más nítida del cono sonoro.

El valor mínimo y por defecto de esta propiedad es 1.

distanceCutoff : real

Define una distancia a partir de la cual el sonido procedente de la fuente se corta. Si el oyente está más lejos del objeto sonoro que la distancia de corte, éste dejará de ser audible.

distanceModel : enumeration

Define cómo escala el volumen del sonido con la distancia al oyente. El volumen empieza a descender desde size hasta distanceCutoff. El volumen es constante para distancias menores que el tamaño y cero para distancias mayores que la distancia de corte.

loops : int

Determina la frecuencia con la que se reproduce el sonido antes de que el reproductor se detenga. Establézcalo a SpatialSound::Infinite para reproducir en bucle el sonido actual para siempre.

El valor predeterminado es 1.

manualAttenuation : real

Define un factor de atenuación manual si distanceModel está configurado como SpatialSound.ManualAttenuation.

nearFieldGain : real

Define la ganancia de campo cercano para la fuente de sonido. Los valores válidos están entre 0 y 1. Una ganancia de campo cercano de 1 aumentará el volumen de la señal de sonido en aproximadamente 20 dB para distancias muy cercanas al oyente.

occlusionIntensity : real

Define el grado de oclusión del objeto. 0 implica que el objeto no está ocluido en absoluto, mientras que un número grande implica una gran oclusión.

El valor predeterminado es 0.

size : real

Define el tamaño de la fuente sonora. Si el oyente está más cerca del objeto sonoro que el tamaño, el volumen se mantendrá constante. El tamaño también se utiliza para los cálculos de oclusión, en los que las fuentes grandes pueden quedar parcialmente ocluidas por una pared.

source : url

El archivo fuente del sonido a reproducir.

volume : real

Define un volumen general para esta fuente de sonido.

Los valores entre 0 y 1 atenuarán el sonido, mientras que los valores por encima de 1 proporcionan un aumento adicional de la ganancia.

Documentación del método

void pause()

Detiene la reproducción del sonido en la posición actual. Llamando a play() continuará la reproducción.

void play()

Inicia la reproducción del sonido. No hace nada si el sonido ya se está reproduciendo.

void stop()

Detiene la reproducción del sonido y restablece la posición actual y la cuenta de bucles a 0. Si se llama a play(), la reproducción comenzará al principio del archivo de sonido.