Player Audio

プレイヤーのオーディオには、マイクから入力される音声と、アバターに付随するサウンドの2種類があります。Udonを使用すると、プレイヤーが他のプレイヤーの音声やアバターサウンドをどのように聴くかを変更できます。例えば、以下のコードはゲインを5デシベル（デフォルトの15デシベルより低い値）に設定することで、プレイヤーの音量を下げます：

somePlayer.SetVoiceGain(5);

アクセス可能なプロパティの一覧です：

Voice

Set Voice Gain

デシベル単位、範囲 0-24 プレイヤーの音声にデシベル単位でブーストを加えます。デフォルト値は15です。

Set Voice Distance Near

メートル単位、範囲 0 - 1,000,000 音量が減衰し始める距離（メートル単位）です。リアルな体験と効果的な空間音響を実現するため、Near値は0のままにしておくことを強く推奨します。

Set Voice Distance Far

メートル単位、範囲 0 - 1,000,000 ユーザーの声が聞こえる範囲の終端を設定します。デフォルト値は25メートルです。この値を下げることで、他のプレイヤーの声が届く距離を短くでき、0にすれば実質的にそのプレイヤーを「ミュート」できます。

Set Voice Volumetric Radius

メートル単位、範囲 0 - 1,000 デフォルト値は0です。 プレイヤーの音声は通常、点音源としてシミュレートされますが、この値を変更することで、より広い範囲から聞こえるように設定できます。慎重に使用してください。主に、通り過ぎる際に「大きく」響かせる必要がある遠方の音源用です。仕組みを理解している場合を除き、この値は0に保ってください。Volumetric Radiusの値は、常にVoice Distance Farよりも小さい値にする必要があります。

ユーザーの声をどれだけ離れていても近くで聞こえるようにしたい場合は、Voice Distance Nearの範囲を大きな値に設定してください。

Set Voice Lowpass

On/Off 声が一定以上離れている場合、騒がしいワールドでも聞き取りやすくするためにローパスフィルターが適用されます。このフィルターをスキップしたい場合は無効にできます。例えば、プレイヤーがボイスチャンネルを使用して高音質なDJミックスを流すことを想定している場合は、このフィルターをオフにすることをお勧めします。

アバター

SetAvatarAudioGain

デシベル単位、範囲 0-10 アバターオーディオに許可される最大ゲインを設定します。デフォルトは10です。

SetAvatarAudioFarRadius

メートル単位、範囲制限なし アバターのオーディオが聞こえる最大距離の終点を設定します。デフォルトは40メートルです。この値を小さくすることで、他のプレイヤーのアバターの音声が遠くまで届かないように調整できます。0に設定すれば、実質的にそのプレイヤーを「ミュート」できます。なお、この値はオーディオソースのmaxDistanceと比較され、小さい方の値が使用される点に注意してください。

SetAvatarAudioNearRadius

単位はメートル、範囲制限なし アバターの音声が聞こえ始める範囲の最大開始距離を設定します。デフォルトは0メートルです。この値を大きくすると、アバターのオーディオソースが最大音量に達する距離がより遠くなります。なお、この値はオーディオソースのmaxDistanceと比較され、小さい方の値が使用されます。

SetAvatarAudioVolumetricRadius

単位はメートル、範囲制限なし アバターのオーディオソースは通常、点音源としてシミュレートされますが、この値を変更することで、より広い範囲から音が聞こえるようにできます。この設定は慎重に使用する必要があります。主に、通り過ぎる際に「大きく」聞こえるべき遠方のオーディオソース用です。特別な理由がない限り0に保ってください。Volumetric Radiusの値は、常にAvatar AudioFarRadiusよりも小さく設定する必要があります。デフォルトは0メートルです。

SetAvatarAudioForceSpatial

オン/オフ オンにすると、そのソースに対してSpatializationが有効になり、spatialBlendが1に設定されます。デフォルトはオフです。

SetAvatarAudioCustomCurve

オン/オフ オーディオソースに事前設定されたカスタムカーブを使用するかどうかを設定します。デフォルトはオフです。