QSpatialSound Class

プロパティ説明

autoPlay : bool

ソースが指定されたときに、サウンドが自動的に再生を開始するかどうかを決定する。

デフォルト値はtrue 。

アクセス関数

Notifier シグナル：

directivity : float

音源の指向性を定義します。0を指定すると音源は全方向に均等に音を発し、1を指定すると音源は主に前方向に音を発する。

有効な値は0から1で、デフォルトは0。

アクセス関数

通知信号：

directivityOrder : float

音源の指向性の次数を定義する。次数が高いほど、サウンドコーンの定位がシャープになる。

このプロパティの最小値およびデフォルトは1。

アクセス関数：

ノーティファイア信号：

distanceCutoff : float

音源からの音が遮断される距離を定義する。リスナーがサウンドオブジェクトからカットオフ距離以上離れると、聞こえなくなる。

アクセス関数

Notifier シグナル

distanceModel : DistanceModel

音源の距離モデルを定義。音量は、size からdistanceCutoff にスケールダウンし始める。音量は、サイズより小さい距離では一定で、カットオフ距離より大きい距離ではゼロになる。

アクセス関数：

通知シグナル：

QSpatialSound::DistanceModelも参照 。

loops : int

プレーヤーが停止するまでのサウンド再生回数を決定します。QSpatialSound::Infinite に設定すると、現在のサウンドを永遠にループ再生する。

デフォルト値は1 。

アクセス関数：

Notifierシグナル：

manualAttenuation : float

distanceModel がQSpatialSound::DistanceModel::ManualAttenuation に設定されている場合、手動減衰係数を定義します。

アクセス関数：

ノーティファイア・シグナル（Notifier signal）：

nearFieldGain : float

音源のニアフィールドゲインを定義します。ニアフィールドゲインを 1 に設定すると、リスナーに非常に近い距離のサウンド信号の音量が約 20 dB 上がります。

アクセス機能

ノティファイア信号：

occlusionIntensity : float

オブジェクトがどの程度隠されているかを定義します。0はオブジェクトが全くオクルードされていないことを意味し、1は音源が他のオブジェクトによって完全にオクルードされていることを意味します。

完全にオクルードされたオブジェクトはまだ聞こえますが、特に高い周波数は減衰します。さらに、オブジェクトは部屋の残響や反射の発生に関与します。

1より大きな値を設定すると、音源からの直接音をさらに減衰させることができます。

デフォルトは0です。

アクセス関数

Notifierシグナル：

position : QVector3D

3D空間における音源の位置を指定します。デフォルトの単位はセンチ。

アクセス関数

ノティファイア・シグナル：

QAudioEngine::distanceScaleも参照 。

rotation : QQuaternion

3D空間における音源の向きを定義する。

アクセス関数：

ノーティファイアシグナル：

size : float

音源のサイズを定義する。リスナーがサイズよりもサウンドオブジェクトに近ければ、音量は一定に保たれる。このサイズはオクルージョンの計算にも使用され、大きな音源が壁によって部分的にオクルージョンされることがあります。

アクセス関数

ノティファイアシグナル

source : QUrl

再生するサウンドのソースファイル。

アクセス機能：

通知シグナル

volume : float

サウンドの音量を設定します。

0から1の間の値は音を減衰させ、1以上の値はさらにゲインを上げます。

アクセス機能

ノティファイアシグナル：