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 |
| 右 | 正 x |
| 后 | 负 z |
| 前 | 正 z |
| 地面 | 负 y |
| 天花板 | 正 y |
材料的有效值为
| 属性值 | 说明 |
|---|---|
| 透明 | 房间的一侧是开放的，不会产生反射或混响。 |
| 隔音天花板 | 可抑制大部分反射和混响的声学瓷砖。 |
| 裸砖 | 光秃秃的砖墙。 |
| 彩绘砖墙 | 涂漆的砖墙。 |
| 粗混凝土砖墙 | 未加工的混凝土墙 |
| 彩绘混凝土块 | 粉刷过的混凝土墙 |
| 重型窗帘 | 厚重的幕布。主要反射低频 |
| 玻璃纤维隔音 | 玻璃纤维隔热材料。只能反射极低频 |
| 薄玻璃墙 | 薄玻璃墙 |
| 厚玻璃墙 | 厚玻璃墙 |
| 草 | 草地 |
| 混凝土上的油毡 | 油毡地板 |
| 大理石 | 大理石地板 |
| 金属 | 金属 |
| 混凝土镶木地板 | 混凝土上的镶木地板 |
| 粗糙石膏 | 粗糙石膏 |
| 光滑石膏 | 光滑石膏 |
| 胶合板面板 | 胶合板 |
| 抛光混凝土或瓷砖 | 抛光混凝土或瓷砖 |
| 石膏板 | 岩石 |
| 水或冰表面 | 水或冰 |
| 木质天花板 | 木质天花板 |
| 木板 | 木质面板 |
| 均匀 | 对所有频率产生均匀反射的人造材料 |
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。
© 2025 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.
