Qt Spatial Audio

Qt Spatial Audio は、3D空間に音場を実装するための豊富なQML型とC++クラスのセットを提供するアドオンモジュールです。空間にリスナーを配置したり、リスナーの周囲に局所的な音源を追加したり、リバーブや反射を使ったバーチャルルームをエミュレートしたりするための、使いやすいAPIが含まれています。

はじめに

Qt Spatial Audio を初めてお使いになる場合、.qml ファイルに次のように記述することで、QML タイプをアプリケーションにインポートすることができます。

import QtQuick3D.SpatialAudio

C++ ライブラリとリンクするには、プロジェクトのCMakeLists.txt ファイルに以下の記述を追加します。my_project はプロジェクト名で置き換えてください。

find_package(Qt6 REQUIRED COMPONENTS SpatialAudio)
target_link_libraries(my_project PRIVATE Qt6::SpatialAudio)

Spatial Audio Overview』では、以下の各クラスの使い方について、より詳しく説明 しています。

QMLタイプ

次の表は、いくつかの重要なQML型の概要です。

タイプ説明
AudioEngineオーディオシーンの処理を行うエンジン
SpatialSound3D空間に配置された音源。
AmbientSound場所に依存しないステレオサウンドトラック。
AudioRoomオーディオのリバーブや反射を生成する部屋の定義。

C++クラス

次の表に、重要なC++クラスの概要を示します。

クラス説明
QAudioEngineオーディオシーンの処理を行うエンジン
QSpatialSound3D空間に配置された音源。
QAmbientSound場所に依存しないステレオサウンドトラック。
QAudioRoomオーディオのリバーブや反射を生成する部屋の定義。

ライセンスと帰属

Qt Spatial Audio モジュールは、The Qt Company の商用ライセンスで利用できます。さらに、フリーソフトウェアライセンスでも利用可能です。これらのフリー・ソフトウェア・ライセンスは、GNU Lesser General Public License, version 3 またはGNU General Public License, version 3 です。詳細はQt ライセンスを参照してください。

なお、Qt Spatial AudioGNU General Public License, version 2 では利用できません。

さらに、Qt 6.8.4のQt Spatial Audio 、以下の寛容なライセンスのサードパーティモジュールが含まれています:

Eigen, version 3.4.0

Mozilla Public License 2.0 および BSD 3-Clause "New" または "Revised" ライセンス

Resonance Audio, version e225aedb5ec76ca6a0fe7079c0b84dbcbb490553

Apache ライセンス 2.0

pffft, version 02fe7715a5bf8bfd914681c53429600f94e0f536

BSD 3-条項「新規」または「改訂」ライセンス

リファレンスと例

© 2025 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.