空間オーディオの概要

Qt Spatial Audio APIは、3次元サウンドシーンを作成するためのさまざまなクラスを提供します。このサウンドシーンは、3D空間内に配置され音を発するオブジェクトと、1つまたは複数の部屋を用いてモデル化できる周囲のジオメトリによって定義されます。最後に、リスナーを指定された位置と向きでこのサウンドシーン内に配置することができます。

C++およびQMLの両方のAPIが利用可能です。

サウンドシーンの作成

サウンドシーンを作成するには、まずQAudioEngine をインスタンス化します。このエンジンは、入力されたサウンドデータとジオメトリを処理し、シーン内の特定の位置に配置された人が体験するような、リアルなサウンドシーンを再現します。

QAudioEngine::OutputMode プロパティを使用すると、バイノーラル（仮想 3D）レンダリングを使用したヘッドフォン向け、あるいはステレオやサラウンドスピーカー構成向けに、出力を最適化することができます。

出力デバイスは、QAudioEngine::outputDevice プロパティを使用して選択できます。

エンジンの設定が完了すると、QSpatialSound オブジェクトを作成し、QSpatialSound::source プロパティを使用してサウンドファイルへの URL を指定することで、シーン内にさまざまなサウンドオブジェクトを配置することができます。

QAudioListener を使用して、サウンドシーンを聞く人の位置や向きを定義できます。エンジンごとに最大 1 人のリスナーを使用できます。リスナーが指定されていない場合、エンジンは、リスナーが座標系の原点にあり、z 軸の正の方向を向いており、y 軸の正の方向が上向きであると想定します。

音源やリスナーに加え、一連のQAudioRoom オブジェクトを通じて、リスナーが音をどのように体験するかに影響を与えるジオメトリを定義することができます。 部屋は長方形で、各壁には多種多様な材質が設定可能であり、音の反射や残響の違いによって異なる体験をもたらします。リスナーが部屋の一つの中にいる場合、部屋の効果が適用されます。複数の部屋の中にいる場合は、幾何学的体積が最も小さい部屋が優先されます。

リスナーの位置や向きに依存しないステレオオーバーレイ（BGMやナレーションなど）が必要な場合は、QAmbientSound を使用してサウンドオーバーレイを作成できます。

QWidget ベースの簡単なサンプルで、室内を移動できる 1 つの音源を紹介している「Spacial Audio Panning Example」をご覧ください。

リファレンスドキュメント

C++ クラス

QML 型