En esta página

SpatialSound QML Type

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

Import Statement: import QtQuick3D.SpatialAudio

Propiedades

Métodos

Descripción detallada

Un SpatialSound representa un objeto audible en el espacio 3D. Se puede definir su posición y orientación en el espacio, establecer el sonido que reproduce y definir el volumen del objeto.

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

Documentación de propiedades

autoPlay : bool

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

El valor por defecto 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 hacia delante.

Los valores válidos están comprendidos 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 precisa del cono sonoro.

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

distanceCutoff : real

Define una distancia más allá de la cual el sonido procedente de la fuente se cortará. Si el oyente se encuentra más lejos del objeto sonoro que la distancia de corte, ya no se oirá.

distanceModel : enumeration

Define cómo varía el volumen del sonido en función de la distancia al oyente. El volumen comienza a reducirse desde size hasta distanceCutoff. El volumen es constante para distancias inferiores a «size» y es cero para distancias superiores a la «distancia de corte».

Valor de la propiedadDescripción
LogarítmicoEl volumen disminuye de forma logarítmica con la distancia.
LinealEl volumen disminuye linealmente con la distancia.
Atenuación manualLa atenuación se define manualmente mediante la propiedad « manualAttenuation ».

loops : int

Determina cuántas veces se reproduce el sonido antes de que el reproductor se detenga. Establece el valor en SpatialSound::Infinite para que el sonido actual se reproduzca en bucle indefinidamente.

El valor por defecto es « 1 ».

manualAttenuation : real

Define un factor de atenuación manual si la opción « distanceModel » está configurada en « SpatialSound.ManualAttenuation».

nearFieldGain : real

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

occlusionIntensity : real

Define el grado de oclusión del objeto. Un valor de 0 significa que el objeto no está ocluido en absoluto, mientras que un valor elevado indica una oclusión importante.

El valor por defecto es 0.

size : real

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

source : url

El archivo fuente del sonido que se va a reproducir.

volume : real

Define el volumen general de esta fuente de sonido.

Los valores entre 0 y 1 atenúan el sonido, mientras que los valores superiores a 1 proporcionan un aumento de ganancia adicional.

Documentación del método

void pause()

Detiene la reproducción del sonido en la posición actual. Al llamar a play(), se reanudará la reproducción.

void play()

Comienza a reproducir el 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 el recuento de repeticiones a 0. Al llamar a ` play()` se iniciará la reproducción desde el principio del archivo de sonido.

© 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.