AudioEngine QML Type

AudioEngineは、3Dシーン内のサウンドオブジェクトを管理します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• distanceScale : real (since 6.11)
• masterVolume : real
• outputDevice : QtMultimedia.AudioDevice
• outputMode : enumeration

詳細な説明

AudioEngineは、3Dシーン内のサウンドオブジェクトを管理します。シーンにSpatialSound オブジェクトを追加することで、3D空間内の指定された位置で発生するサウンドを定義できます。AmbientSound を使用すると、ステレオオーバーレイ（ナレーションやサウンドトラックなど）を追加できます。

AudioListener を使用すると、音源に対する音場を聞く人の位置を定義できます。 リスナーが音源から離れるほど、音源の音は聞こえにくくなります。また、リスナーと音源間の方向に応じて、音源は対応するスピーカーにマッピングされます。多くの場合、AudioListener オブジェクトは、QtQuick3D.Cameraオブジェクトの子オブジェクトとして単純にインスタンス化できます。

AudioRoom オブジェクトを作成すると、特定の寸法とさまざまな種類の壁を持つ部屋の音響（反射音や残響）をシミュレートできます。

AudioEngineには、Qtが頭部関連インパルス応答関数（HRIR）（https://en.wikipedia.org/wiki/Sound_localizationも参照）を用いて耳の効果をシミュレートし、ヘッドフォン使用時に3D空間内で音源の位置を特定し、ヘッドフォンを通じて空間オーディオ効果を生み出すモードが用意されています。

Qt Quick の3D機能と同様に、オーディオエンジンはデフォルトでセンチメートル単位の座標系を使用しています。軸は、x軸の正の方向が右、y軸の正の方向が上、z軸の正の方向が後方となるように定義されています。

プロパティのドキュメント

distanceScale : real [since 6.11]

空間オーディオエンジンで使用される座標系のスケールを定義します。デフォルトでは、Qt Quick 3Dで使用されているデフォルトの単位に合わせて、すべての単位がセンチメートルで指定されます。

距離スケールを 100 に設定すると、単位がメートルになります。

このプロパティは Qt 6.11 で導入されました。

masterVolume : real

音場をレンダリングするために使用されている総音量を設定または取得します。

outputDevice : QtMultimedia.AudioDevice

音場を出力するために使用されているデバイスを設定または取得します。

outputMode : enumeration

エンジンの現在の出力モードを設定または取得します。