本页内容

AudioRoom QML Type

Import Statement: import QtQuick3D.SpatialAudio

属性

详细说明

为空间音频引擎定义一个房间。

如果听众位于房间内,系统将根据房间特性对声场应用一阶声反射和混响效果。

房间始终为正方形,由其中心位置、朝向和尺寸定义。房间的 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.