En esta página

QAudioRoom Class

Encabezado: #include <QAudioRoom>
CMake: find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio)
qmake: QT += spatialaudio
Heredado de: QObject

Tipos públicos

enum Material { Transparent, AcousticCeilingTiles, BrickBare, BrickPainted, ConcreteBlockCoarse, …, UniformMaterial }
enum Wall { LeftWall, RightWall, Floor, Ceiling, FrontWall, BackWall }

Propiedades

Funciones públicas

QAudioRoom(QAudioEngine *engine)
virtual ~QAudioRoom() override
QVector3D dimensions() const
QVector3D position() const
float reflectionGain() const
float reverbBrightness() const
float reverbGain() const
float reverbTime() const
QQuaternion rotation() const
void setDimensions(QVector3D dim)
void setPosition(QVector3D pos)
void setReflectionGain(float factor)
void setReverbBrightness(float factor)
void setReverbGain(float factor)
void setReverbTime(float factor)
void setRotation(const QQuaternion &q)
void setWallMaterial(QAudioRoom::Wall wall, QAudioRoom::Material material)
QAudioRoom::Material wallMaterial(QAudioRoom::Wall wall) const

Señales

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 a 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 sobre tipos de miembros

enum QAudioRoom::Material

Define los distintos materiales que se pueden aplicar a las diferentes paredes de la habitación.

ConstanteValorDescripción
QAudioRoom::Transparent0El lateral de la sala está abierto y no contribuirá a las reflexiones ni a la reverberación.
QAudioRoom::AcousticCeilingTiles1Paneles acústicos que suprimen la mayor parte de los reflejos y la reverberación.
QAudioRoom::BrickBare2Pared de ladrillo visto.
QAudioRoom::BrickPainted3Pared de ladrillo pintada.
QAudioRoom::ConcreteBlockCoarse4Pared de hormigón en bruto
QAudioRoom::ConcreteBlockPainted5Pared de hormigón pintada
QAudioRoom::CurtainHeavy6Cortina gruesa. Reflejará principalmente las frecuencias bajas.
QAudioRoom::FiberGlassInsulation7Aislamiento de fibra de vidrio. Solo refleja las frecuencias muy bajas.
QAudioRoom::GlassThin8Pared de cristal fino
QAudioRoom::GlassThick9Pared de cristal grueso
QAudioRoom::Grass10Césped
QAudioRoom::LinoleumOnConcrete11Suelo de linóleo
QAudioRoom::Marble12Suelo de mármol
QAudioRoom::Metal13Metal
QAudioRoom::ParquetOnConcrete14Suelo de parqué sobre hormigón
QAudioRoom::PlasterRough15Enlucido rugoso
QAudioRoom::PlasterSmooth16Yeso liso
QAudioRoom::PlywoodPanel17Panel de madera contrachapada
QAudioRoom::PolishedConcreteOrTile18Hormigón pulido o baldosas
QAudioRoom::Sheetrock19Roca
QAudioRoom::WaterOrIceSurface20Agua o hielo
QAudioRoom::WoodCeiling21Techo de madera
QAudioRoom::WoodPanel22Panel de madera
QAudioRoom::UniformMaterial23Material artificial que produce reflejos uniformes en todas las frecuencias

enum QAudioRoom::Wall

Una enumeración que define las 6 paredes de la habitación

ConstanteValorDescripción
QAudioRoom::LeftWall0Pared izquierda (x negativo)
QAudioRoom::RightWall1Pared derecha (x positiva)
QAudioRoom::Floor2Pared inferior (y negativa)
QAudioRoom::Ceiling3Pared superior (y positiva)
QAudioRoom::FrontWall4Pared frontal (z negativo)
QAudioRoom::BackWall5Pared trasera (z positiva)

Documentación de la propiedad

dimensions : QVector3D

Define las dimensiones de la habitación en el espacio 3D. Por defecto, las unidades son centímetros.

Funciones de acceso:

QVector3D dimensions() const
void setDimensions(QVector3D dim)

Señal de notificación:

void dimensionsChanged()

Véase también position y QAudioEngine::distanceScale.

position : QVector3D

Define la posición del centro de la habitación en el espacio 3D. Las unidades son centímetros por defecto.

Funciones de acceso:

QVector3D position() const
void setPosition(QVector3D pos)

Señal de notificación:

void positionChanged()

Véase también dimensions y QAudioEngine::distanceScale.

reflectionGain : float

Un factor de ganancia para las reflexiones generadas en esta sala. Un valor entre 0 y 1 atenuará las reflexiones, mientras que un valor superior a 1 aplicará una ganancia a las reflexiones, lo que las hará más fuertes.

El valor por defecto es 1; un factor de 0 desactiva las reflexiones. Los valores negativos se asignan a 0.

Funciones de acceso:

float reflectionGain() const
void setReflectionGain(float factor)

Señal de notificación:

void reflectionGainChanged()

reverbBrightness : float

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 hará lo contrario.

El valor por defecto es 0.

Funciones de acceso:

float reverbBrightness() const
void setReverbBrightness(float factor)

Señal de notificación:

void reverbBrightnessChanged()

reverbGain : float

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.

Funciones de acceso:

float reverbGain() const
void setReverbGain(float factor)

Señal de notificación:

void reverbGainChanged()

reverbTime : float

El factor «A» se aplica a todos los tiempos de reverberación generados para esta sala. Cuanto mayor sea el valor, más largos serán los tiempos de reverberación, lo que hará que la sala suene más amplia.

El valor por defecto es 1. Los valores negativos se asignan a 0.

Funciones de acceso:

float reverbTime() const
void setReverbTime(float factor)

Señal de notificación:

void reverbTimeChanged()

rotation : QQuaternion

Define la orientación de la habitación en el espacio 3D.

Funciones de acceso:

QQuaternion rotation() const
void setRotation(const QQuaternion &q)

Señal de notificación:

void rotationChanged()

Documentación de funciones de miembro

[explicit] QAudioRoom::QAudioRoom(QAudioEngine *engine)

Crea un QAudioRoom para engine.

Nota: Debe llamarse con un QAudioEngine

[override virtual noexcept] QAudioRoom::~QAudioRoom()

Arruina el ambiente.

void QAudioRoom::setWallMaterial(QAudioRoom::Wall wall, QAudioRoom::Material material)

Establece wall en material.

Los distintos materiales de las paredes tienen diferentes propiedades de reflexión y reverberación que influyen en el sonido de la sala.

Véase también wallMaterial(), Material y QAudioRoom::Wall.

QAudioRoom::Material QAudioRoom::wallMaterial(QAudioRoom::Wall wall) const

Devuelve el material que se está utilizando para wall.

Véase también setWallMaterial(), Material y QAudioRoom::Wall.

[signal] void QAudioRoom::wallsChanged()

Indica cuándo cambia el material de la pared.

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