SpatialSound QML Type

3D空間内のサウンドオブジェクト。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• autoPlay : bool
• directivity : real
• directivityOrder : real
• distanceCutoff : real
• distanceModel : enumeration
• loops : int
• manualAttenuation : real
• nearFieldGain : real
• occlusionIntensity : real
• size : real
• source : url
• volume : real

方法

• void pause()
• void play()
• void stop()

詳細な説明

SpatialSoundは、3D空間内の可聴オブジェクトを表します。空間内での位置や向きを定義したり、再生する音を設定したり、オブジェクトの音量を指定したりすることができます。

オブジェクトには、さまざまな減衰挙動を持たせたり、主に一方向に、あるいは球状に音を放射させたり、他のオブジェクトによって遮られたかのように振る舞わせたりすることができます。

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

autoPlay : bool

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

デフォルト値はtrue です。

directivity : real

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

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

directivityOrder : real

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

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

distanceCutoff : real

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

distanceModel : enumeration

音量がリスナーまでの距離に応じてどのように変化するかを定義します。音量はsize からdistanceCutoff へと徐々に小さくなっていきます。距離がsize未満の場合は音量は一定であり、カットオフ距離を超える場合は音量はゼロになります。

loops : int

プレーヤーが停止するまでに、サウンドが再生される回数を指定します。現在のサウンドを無限にループさせるには、SpatialSound::Infinite に設定してください。

デフォルト値は1 です。

manualAttenuation : real

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

nearFieldGain : real

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

occlusionIntensity : real

オブジェクトがどの程度遮られているかを指定します。0 はオブジェクトがまったく遮られていないことを意味し、数値が大きいほど遮蔽度が高いことを意味します。

デフォルト値は 0 です。

size : real

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

source : url

再生する音声のソースファイル。

volume : real

この音源の全体的な音量を設定します。

0 から 1 までの値を設定すると音量が減衰し、1 より大きい値を設定すると音量がさらに増幅されます。

メソッドのドキュメント

void pause()

現在の位置で音声の再生を一時停止します。play() を呼び出すと、再生が再開されます。

void play()

音声の再生を開始します。すでに音声が再生されている場合は、何も行いません。

void stop()

サウンドの再生を停止し、現在の位置とループ回数を0にリセットします。play() を呼び出すと、サウンドファイルの先頭から再生が開始されます。