SpatialSound QML Type
Un objeto sonoro en el espacio 3D. Más...
| Import Statement: | import QtQuick3D.SpatialAudio |
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
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 propiedad | Descripción |
|---|---|
| Logarítmico | El volumen disminuye de forma logarítmica con la distancia. |
| Lineal | El volumen disminuye linealmente con la distancia. |
| Atenuación manual | La 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.