ドキュメント

サポート

Vivox Unity SDK

Vivox Unity SDK

In Game Control Audio Levels

Allow players to control voice and audio levels in-game.
読み終わるまでの所要時間 1 分最終更新 4日前
Vivox SDK を使用して、オーディオの入出力レベルをゲーム内で制御できるように設定できます。 以下のようなシナリオで、オーディオレベルをゲーム内で制御する機能を実装したいことがあります。
  • ユーザーがゲームのサウンドと音声出力の音量レベルを別々に設定できると便利です。
  • ユーザーが自分の音声入力の音量を調整することを求めています。
  • ユーザーがチャンネル全体の音量を調整することを求めています。
  • ユーザーがチャンネルを共用している他のユーザーの音量を調整することを求めています。
音量設定はデバイスまたは参加者の見かけ上のラウドネスを調整します。すべての音量設定は -50 から 50 の範囲の対数的なスケールで設定でき、0 に設定すると +0db (変更なし) になります。これは対数的なスケールであるため、使用可能な範囲は一般的に -10 から 25 の間であり、25 はキャプチャデバイスの過変調を引き起こしやすく、ユーザーがヘッドセットで不快感を覚える可能性があります。初期値を超えて音量を上げるとある程度音にひずみが生じる可能性がありますが、音量レベルがそれほど高くない場合はあまり感じられません。

ローカルユーザーの入力および出力デバイスの音量を調整する

Vivox Unity SDK は、以下のメソッドを使用して入力および出力デバイスのオーディオレベルを設定します。 
  • VivoxService.Instance.SetInputDeviceVolume(int value)
    • 入力デバイス (マイク) のクライアント側の音量を設定します。
    • この値は -50 から 50 の間の値に設定できます。負の値は音量を下げ、正の値は音量を上げます。
    • この値はすべてのチャンネルに影響します。
  • VivoxService.Instance.SetOutputDeviceVolume(int value)
    • コンピューター上のオーディオデバイスを通じて再生される、すべての Vivox 音声オーディオのクライアント側の音量を設定します。
    • この値は -50 から 50 の間の値に設定できます。負の値は音量を下げ、正の値は音量を上げます。
    • この値はすべてのチャンネルに影響します。

チャンネル参加者の音量を調整する

Vivox Unity SDK は、以下のメソッドを使用して、ユーザーがチャンネルを共用している個々のプレイヤーの音量を設定します。 
  • VivoxParticipant.SetLocalVolume(int volume)
    • チャンネル内の個々の参加者の Vivox 音声オーディオのクライアント側の音量を設定します。
    • この値は -50 から 50 の間の値に設定できます。負の値は参加者の音量を下げ、正の値は参加者の音量を上げます。
    • VivoxParticipant
      オブジェクトの詳細については、参加者の管理 に関するドキュメントを参照してください。

チャンネルの音量を調整する

Vivox Unity SDK は、以下のメソッドを使用して、チャンネルの音量を設定します。 
  • VivoxService.Instance.SetChannelVolumeAsync(string channelName, int value)
    • 特定のチャンネルを通じて再生される、すべての Vivox 音声オーディオのクライアント側の音量を設定します。
    • この値は -50 から 50 の間の値に設定できます。負の値はチャンネルから入ってくるすべてのオーディオの音量を下げ、正の値は音量を上げます。