AudioEngine QML Type

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

Import Statement: import QtQuick3D.SpatialAudio

プロパティ

詳細説明

AudioEngineは、3Dシーン内のサウンドオブジェクトを管理します。SpatialSound オブジェクトをシーンに追加して、3D空間の指定位置で発生するサウンドを定義できます。AmbientSound を使えば、ステレオオーバーレイ(ボイスオーバーやサウンドトラックなど)を追加できます。

AudioListener を使って、サウンドフィールドを聞く人の音源に対する相対位置を定義でき ます。リスナーが音源から離れると、音源は聞き取りにくくなります。また、リスナーと音源の方向によって、対応するラウドスピーカーにマッピングされます。多くの場合、AudioListener オブジェクトは、QtQuick3D.Camera オブジェクトの子オブジェクトとしてインスタンス化するだけです。

AudioRoom オブジェクトを作成して、特定の寸法と異なるタイプの壁を持つ部屋のサウンド(反射とリバーブ)をシミュレートします。

AudioEngineは、ヘッドフォン使用時に3D空間で音を定位させ、ヘッドフォンを通した空間的なオーディオ効果を作成するために、頭部に関連するインパルス応答関数(https://en.wikipedia.org/wiki/Sound_localization も参照)を使用して、Qtが耳の効果をシミュレートするモードを提供しています。

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

プロパティの説明

masterVolume : float

音場のレンダリングに使用される全体の音量を設定または返す。


outputDevice : QtMultimedia.AudioDevice

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


outputMode : enumeration

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

プロパティ値説明
サラウンドサウンドを出力デバイスのラウドスピーカー設定にマッピングする。これは通常、ステレオまたはサラウンドスピーカー設定である。
ステレオサウンドを出力デバイスのステレオラウドスピーカー設定にマッピングする。この場合、追加のスピーカーは無視され、左右のチャンネルだけを使用して音場のステレオレンダリングが作成されます。
ヘッドフォンヘッドフォンで音場を聴く時に、3Dオーディオエフェクトを作成するためにヘッドフォン空間化を使います。

©2024 The Qt Company Ltd. 本書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。