VoiceChatService
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
VoiceChatService は、ボイスチャットの高レベル機能の責任者です。これは主に構成オプションと、より特定的なインスタンスによって特別に制御されていない機能で構成されています。
概要
プロパティ
AudioDeviceInput および AudioEmitter オブジェクトが生成されると、デフォルトのボイスチャット設定が使用する距離衰減曲線を決定します。
各ボイスエライブルプレイヤーが、自分のキャラクターを通じて話しているかのように聞かれるかどうかを制御します。
ボイスチャットが AudioDeviceInput オブジェクトによって表示され、制御されるかどうかを制御します。
方法
指定されたユーザーがボイスを有効にしているかどうかを返します。
プロパティ
DefaultDistanceAttenuation
このプロパティは、デフォルトの距離衰減曲線を、デフォルトのボイスチャット設定で生成されたすべてのAudioEmitterインスタンスに割り当てます。
このプロパティは、EnableDefaultVoice と UseAudioApi が両方有効になっている場合にのみ効果があり、そうでなければ AudioEmitters は生成されません。
EnableDefaultVoice
有効にすると、各声が資格のあるプレイヤーは、自分のキャラクターを通じて話しているかのように聞こえます。ボイス設定の実装詳細は UseAudioApi に依存します。
When UseAudioApi が Enabled になると、このプロパティを無効にすると、デフォルト設定が無効になりますが、AudioDeviceInput は引き続き機能します。逆に、UseAudioApi が Disabled になると、デフォルトのボイス設定を無効にすると、ボイスチャットは完全に無効になります。
UseAudioApi
如果 Enabled 、ボイスチャット設定は AudioDeviceInput オブジェクトによって表現および制御されます。より具体的には：
- AudioDeviceInput が作成され、親になり、それぞれの声の資格のある Player になります。
- が作成され、各ボイスエライブルプレイヤーの に親属されます。
- AudioListener が作成され、親になります Workspace.CurrentCamera 。
デフォルト設定を無効にするには、VoiceChatService.EnableDefaultVoice を false に設定してください。
Disabled である場合、ボイスチャットの設定は内部専用システムを通じて行われます。
現在、これを Automatic に設定すると、Disabled と同じ意味があります。しかし、将来、Automatic は Enabled になり、新しい経験が声に対するより大きなカスタマイズを達成できるようになります。
方法
IsVoiceEnabledForUserIdAsync
指定されたユーザーがボイスを有効にしているかどうかを返します。クライアント側では、これはローカルプレイヤーのボイスステータスをチェックするのみに使用できます。サーバー側では、これはそのサーバー上のプレイヤーの音声ステータスのみをチェックできます。
この機能は、HTTP 呼び出しが失敗した場合にエラーを throw できます。
local Players = game:GetService("Players")
local VoiceChatService = game:GetService("VoiceChatService")
local localPlayer = Players.LocalPlayer
local success, enabled = pcall(function()
return VoiceChatService:IsVoiceEnabledForUserIdAsync(localPlayer.UserId)
end)
if success and enabled then
print("Voice chat enabled!")
end
パラメータ
チェックする Player.UserId 。
戻り値
そのユーザーがボイスを有効にしている場合。