QSpatialSound Class

プロパティのドキュメント

autoPlay : bool

ソースが指定された際に、音声を自動的に再生するかどうかを指定します。

デフォルト値はtrue です。

アクセス関数：

通知シグナル：

directivity : float

音源の指向性を定義します。値が 0 の場合は音が全方向に均等に放射されることを意味し、値が 1 の場合は音源が主に前方に向けて音を放射することを意味します。

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

アクセス関数：

通知信号：

directivityOrder : float

音源の指向性の次数を定義します。次数が高いほど、音錐の位置特定がより鮮明になります。

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

アクセス関数：

通知信号：

distanceCutoff : float

音源から発せられる音が、この距離を超えると途切れるように設定します。リスナーが音源からこのカットオフ距離よりも遠くにいる場合、その音は聞こえなくなります。

アクセス関数：

通知シグナル:

distanceModel : DistanceModel

この音源の距離モデルを定義します。音量は、size からdistanceCutoff へと段階的に減少していきます。距離が size 未満の場合は音量は一定であり、カットオフ距離を超える場合は音量はゼロになります。

アクセス関数：

通知信号：

QSpatialSound::DistanceModelも参照してください 。

loops : int

プレイヤーが停止するまでに、サウンドが何回再生されるかを指定します。QSpatialSound::Infinite に設定すると、現在のサウンドが無限ループで再生されます。

デフォルト値は `1` です。

アクセス関数：

通知シグナル：

manualAttenuation : float

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

アクセス機能：

通知信号：

nearFieldGain : float

音源の近距離ゲインを定義します。有効な値は 0 から 1 の範囲です。近距離ゲインを 1 に設定すると、リスナーに非常に近い距離において、音声信号の音量が約 20 dB 上昇します。

アクセス機能：

通知信号：

occlusionIntensity : float

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

完全に遮蔽されたオブジェクトの音も聞こえますが、特に高周波数帯域の音が減衰します。また、そのオブジェクトは、室内での残響や反射音の生成にも引き続き寄与します。

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

デフォルト値は 0 です。

アクセス関数：

通知信号：

position : QVector3D

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

アクセス関数：

通知信号:

関連項目： QAudioEngine::distanceScale 。

rotation : QQuaternion

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

アクセス関数：

通知信号：

size : float

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

アクセス関数：

通知シグナル：

source : QUrl

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

アクセス関数：

通知シグナル：

volume : float

音量を設定します。

0 から 1 までの値では音量が減衰し、1 を超える値では音量がさらに増幅されます。

アクセス機能：

通知信号：