AudioRoom QML Type
| Import Statement: | import QtQuick3D.SpatialAudio |
Propiedades
- backMaterial : AudioRoom::Material
- ceilingMaterial : AudioRoom::Material
- dimensions : vector3D
- floorMaterial : AudioRoom::Material
- frontMaterial : AudioRoom::Material
- leftMaterial : AudioRoom::Material
- reflectionGain : real
- reverbBrightness : real
- reverbGain : real
- reverbTime : real
- rightMaterial : AudioRoom::Material
Descripción detallada
Define una sala para el motor de audio espacial.
Si el oyente se encuentra dentro de una sala, se aplicarán al campo sonoro reflexiones de primer orden y una reverberación acordes con las propiedades de la sala.
Una sala es siempre cuadrada y se define por su posición central, su orientación y sus dimensiones. Cada una de las seis paredes de la sala puede estar compuesta por materiales diferentes que contribuirán a las reflexiones y la reverberación calculadas que experimentará el oyente mientras se encuentre dentro de la sala.
Si varias salas ocupan la misma posición, el motor utilizará la sala con menor volumen.
Documentación de propiedades
backMaterial : AudioRoom::Material
ceilingMaterial : AudioRoom::Material
floorMaterial : AudioRoom::Material
frontMaterial : AudioRoom::Material
leftMaterial : AudioRoom::Material
rightMaterial : AudioRoom::Material
Establece el material que se utilizará en las diferentes paredes de la habitación. Las propiedades se corresponden con las coordenadas de la siguiente manera:
| Propiedad | Coordenada |
|---|---|
| izquierda | x negativa |
| derecha | x positiva |
| Atrás | z negativo |
| delantero | Z positivo |
| suelo | y negativo |
| techo | y positivo |
Los valores válidos para el material son:
| Valor de la propiedad | Descripción |
|---|---|
| Transparente | El lateral de la sala está abierto y no contribuirá a los reflejos ni a la reverberación. |
| Placas acústicas de techo | Paneles acústicos que suprimen la mayor parte de los reflejos y la reverberación. |
| Ladrillo sin revestimiento | Una pared de ladrillo visto. |
| Ladrillo pintado | Una pared de ladrillo pintada. |
| Bloque de hormigón rugoso | Una pared de hormigón sin acabar |
| Bloque de hormigón pintado | Una pared de hormigón pintada |
| CortinaPesada | Una cortina pesada. Reflejará principalmente las frecuencias bajas |
| Aislamiento de fibra de vidrio | Aislamiento de fibra de vidrio. Solo refleja frecuencias muy bajas |
| Cristal fino | Una pared de cristal fino |
| GlassThick | Una pared de cristal gruesa |
| Césped | Césped |
| Linóleo sobre hormigón | Un suelo de linóleo |
| Mármol | Un suelo de mármol |
| Metal | Metal |
| Parqué sobre hormigón | Suelo de parqué sobre hormigón |
| Yeso en bruto | Yeso rugoso |
| Yeso liso | Yeso liso |
| Contrachapado | Panel de madera contrachapada |
| Hormigón pulido o baldosas | Hormigón pulido o baldosas |
| Placas de yeso | Roca |
| Superficie de agua o hielo | Agua o hielo |
| Techo de madera | Un techo de madera |
| Panel de madera | Panel de madera |
| Uniforme | Material artificial que proporciona reflexiones uniformes en todas las frecuencias |
dimensions : vector3D
Define las dimensiones de la habitación en el espacio 3D. Las unidades son centímetros por defecto.
Véase también QtQuick3D::Node::position.
reflectionGain : real
Un factor de ganancia para los reflejos generados en esta sala. Un valor entre 0 y 1 atenuará los reflejos, mientras que un valor superior a 1 aplicará una ganancia a los reflejos, lo que los hará más fuertes.
El valor por defecto es 1; un factor de 0 desactiva las reflexiones. Los valores negativos se asignan a 0.
reverbBrightness : real
Un factor de brillo que se aplicará a la reverberación generada. Un valor positivo aumentará la reverberación en las frecuencias más altas y la atenuará en las más bajas; un valor negativo hace lo contrario.
El valor por defecto es 0.
reverbGain : real
Un factor de ganancia para la reverberación generada en esta sala. Un valor entre 0 y 1 atenuará la reverberación, mientras que un valor superior a 1 aplicará una ganancia a la reverberación, aumentando su volumen.
El valor por defecto es 1; un factor de 0 desactiva la reverberación. Los valores negativos se asignan a 0.
reverbTime : real
El factor «A» se aplica a todos los tiempos de reverberación generados para esta sala. Unos valores más altos darán lugar a tiempos de reverberación más largos, lo que hará que la sala suene más amplia.
El valor por defecto es 1. Los valores negativos se asignan a 0.
© 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.