このページでは

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の正方向

このマテリアルで有効な値は次のとおりです:

プロパティ値説明
透明部屋の側面が開いており、反射や残響の原因にはなりません。
AcousticCeilingTilesほとんどの反射音や残響を抑制する吸音タイル。
むき出しのレンガむき出しのレンガ壁。
BrickPainted塗装されたレンガ壁。
ConcreteBlockCoarse粗面コンクリートの壁
塗装済みコンクリートブロック塗装されたコンクリートの壁
厚手のカーテン厚手のカーテン。主に低周波を反射する
グラスウール断熱材グラスウール断熱材。極めて低周波数のみを反射する
薄いガラス薄いガラスの壁
厚いガラス厚いガラスの壁
草Grass
コンクリート上のリノリウムリノリウムの床
大理石大理石の床
金属金属
コンクリート上の寄木張りコンクリート上の寄木張りの床
粗仕上げの漆喰粗仕上げの漆喰
滑らかな漆喰滑らかな漆喰
合板パネル合板パネル
研磨済みコンクリートまたはタイル研磨仕上げのコンクリートまたはタイル
シートロック岩
水または氷の表面水または氷
木製天井木製の天井
木製パネル木製パネル
均一すべての周波数において均一な反射をもたらす人工素材

dimensions : vector3D

3D空間における部屋の寸法を定義します。単位はデフォルトでセンチメートルです。

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.