Qt Spatial Audio
Qt Spatial Audio には、3D空間における音場を実現するための豊富なQML型およびC++クラスを提供するアドオンモジュールが掲載されています。このモジュールには、空間内にリスナーを配置したり、リスナーの周囲に局所的な音源を追加したり、残響や反射音を用いて仮想の部屋をエミュレートしたりするための、使いやすいAPIが含まれています。
はじめに
Qt Spatial Audio を初めてご利用になる場合は、.qml ファイルに以下の記述を追加することで、QMLタイプをアプリケーションにインポートできます。
import QtQuick3D.SpatialAudioC++ライブラリをリンクするには、プロジェクトのCMakeLists.txt ファイルに以下を追加してください。「mytarget 」をプロジェクト名に置き換えてください。
find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(mytarget PRIVATE Qt6::SpatialAudio)「Spatial Audioの概要」では、以下に挙げる各クラスの使用方法について、より詳細な説明が提供されています。
QML 型
以下の表は、重要な QML 型の一部をまとめたものです。
| 型 | 説明 |
|---|---|
| AudioEngine | オーディオシーンの処理を行うエンジン |
| SpatialSound | 3D空間に位置する音源。 |
| AmbientSound | 位置に依存しないステレオサウンドトラック。 |
| AudioRoom | オーディオリバーブや反射音を生成する部屋を定義します。 |
C++ クラス
以下の表は、重要な C++ クラスの概要を示しています。
| クラス | 説明 |
|---|---|
| QAudioEngine | オーディオシーンの処理を行うエンジン |
| QSpatialSound | 3D空間上に位置する音源。 |
| QAmbientSound | 位置に依存しないステレオサウンドトラック。 |
| QAudioRoom | オーディオリバーブや反射音を生成する部屋を定義します。 |
ライセンスおよび帰属表示
Qt Spatial Audio モジュールは、The Qt Companyから商用ライセンスで提供されています。また、フリーソフトウェアライセンスの下でも利用可能です。これらのフリーソフトウェアライセンスは、GNU Lesser General Public License バージョン3、 またはGNU General Public License バージョン3です。詳細については、「Qtのライセンス」を参照してください。
なお、Qt Spatial Audio はGNU General Public Licenseバージョン2の下では利用できません。
さらに、Qt 6.12.0に含まれるQt Spatial Audio には、以下の寛容なライセンスに基づくサードパーティ製モジュールが含まれています。
Mozilla Public License 2.0 および BSD 3条項「New」または「Revised」ライセンス | |
Resonance Audio, version e225aedb5ec76ca6a0fe7079c0b84dbcbb490553 | Apache License 2.0 |
BSD 3条項「New」または「Revised」ライセンス |
参考資料と例
© 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.