AudioRoom QML Type
| Import Statement: | import QtQuick3D.SpatialAudio |
属性
- 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
详细说明
为空间音频引擎定义一个房间。
如果听众位于房间内,系统将根据房间特性对声场应用一阶声反射和混响效果。
房间始终为正方形,由其中心位置、朝向和尺寸定义。房间的 6 面墙壁可以由不同的材料构成,这些材料将影响听众身处房间内时所体验到的计算出的反射声和混响。
如果有多个房间覆盖同一位置,引擎将使用体积最小的那个房间。
属性文档
backMaterial : AudioRoom::Material
ceilingMaterial : AudioRoom::Material
floorMaterial : AudioRoom::Material
frontMaterial : AudioRoom::Material
leftMaterial : AudioRoom::Material
rightMaterial : AudioRoom::Material
设置房间各面要使用的材质。属性与坐标对应关系如下:
| 属性 | 坐标 |
|---|---|
| 左 | 负x |
| right | 正x |
| 后 | 负 z |
| 前 | z轴正方向 |
| 地板 | 负y |
| 天花板 | 正 y |
该材质的有效值为:
| 属性值 | 描述 |
|---|---|
| 透明 | 房间的一侧是开放的,不会产生反射或混响。 |
| 声学天花板板 | 吸音天花板,可抑制大部分反射和混响。 |
| 裸露砖墙 | 裸露的砖墙。 |
| BrickPainted | 涂漆的砖墙。 |
| 粗糙混凝土砌块 | 粗糙的混凝土墙 |
| 涂漆混凝土砌块 | 一堵涂过漆的混凝土墙 |
| 厚重窗帘 | 厚重的窗帘。主要会反射低频 |
| 玻璃纤维隔热材料 | 玻璃纤维隔热材料。仅反射极低频 |
| 薄玻璃 | 一堵薄玻璃墙 |
| 厚玻璃 | 厚玻璃墙 |
| 草 | 草 |
| 混凝土上的油毡 | 油毡地板 |
| 大理石 | 大理石地板 |
| 金属 | 金属 |
| 铺设在混凝土上的拼花木地板 | 铺设在混凝土上的拼花木地板 |
| 粗糙石膏层 | 粗糙抹灰 |
| 光滑抹灰 | 光滑抹灰 |
| 胶合板面板 | 胶合板 |
| 抛光混凝土或瓷砖 | 抛光混凝土或瓷砖 |
| 石膏板 | 岩石 |
| 水或冰表面 | 水或冰 |
| 木质天花板 | 木质天花板 |
| 木质面板 | 木质面板 |
| 均匀 | 一种在所有频率下都能产生均匀反射的人造材料 |
dimensions : vector3D
定义房间在三维空间中的尺寸。默认单位为厘米。
另请参阅 QtQuick3D::Node::position 。
reflectionGain : real
该房间内产生的反射声的增益系数。0 到 1 之间的数值会衰减反射声,而大于 1 的数值会对反射声进行增益处理,使其声音更响。
默认值为 1,系数为 0 时将禁用反射声。负值将被映射为 0。
reverbBrightness : real
应用于生成的混响的亮度系数。正值会增强高频混响并削弱低频混响,负值则效果相反。
默认值为 0。
reverbGain : real
此房间中生成的混响的增益系数。0 到 1 之间的数值会减弱混响,而大于 1 的数值会对混响进行增益处理,使其音量增大。
默认值为 1,系数为 0 时将禁用混响。负值将被映射为 0。
reverbTime : real
该因子适用于为该房间生成的所有混响时长。数值越大,混响时长越长,使房间听起来更宽敞。
默认值为 1。负值将被映射为 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.