AudioDeviceInput

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

AudioDeviceInput は、マイクなどの物理デバイスからオーディオストリームを生成します。他のピンに接続できる単一の 出力 ピンを提供します。 Wires を介して他のピンに接続できます。AudioDeviceInput には、ストリームを生成している Player を選択し、ミュートされるかどうかを制御するプロパティがある

概要

プロパティ

  • SetUserIdAccessList に提供されたユーザーID リストが許可リストまたは拒否リストとして処理されるかどうかを決定します。

  • Robloxのスクリプトセキュリティ
    並列読み取り

    物理デバイスがアクティブに記録しているかどうかを制御します。

  • 読み取り専用
    複製されていません
    Robloxのスクリプトセキュリティ
    並列読み取り

    この AudioDeviceInput がサウンドを生成できるかどうかを示します。

  • 並列読み取り

    この AudioDeviceInput がミュートされるかどうかを制御します。

  • 複製されていません
    Robloxのスクリプトセキュリティ
    並列読み取り
  • 並列読み取り

    誰のデバイスが音を生成しているかを決定します。

  • 並列読み取り

    出力オーディオストリームに乗算されるボリュームレベル。

方法

イベント

プロパティ

並列読み取り

SetUserIdAccessList に提供されたユーザーID リストが許可リストまたは拒否リストとして処理されるかどうかを決定します。

If が である場合、 だけ 提供されたユーザーIDがこれを聞くことが許可されます .If が である場合、 の提供されたユーザーIDは、これを聞くことができません 。

プレイヤーの声はネットワークされているので、このプロパティは適切に複製するために、サーバーからのみ割り当てる必要があります。

Active

Robloxのスクリプトセキュリティ
並列読み取り

物理デバイスがアクティブに記録しているかどうかを制御します。このプロパティは Roblox コアスクリプトによってのみ設定されますが、ユーザースクリプトによって読み込まれる可能性があります。一般的に、 は、 が真で、 が偽である場合にのみ音を生成できます。

IsReady

読み取り専用
複製されていません
Robloxのスクリプトセキュリティ
並列読み取り

この AudioDeviceInput がサウンドを生成できるかどうかを示し、すべてのネットワーク接続が確立されたことを意味します。

Muted

並列読み取り

この AudioDeviceInput がミュートされているかどうかを制御します。Active とは異なり、このプロパティは公開スクリプト可能です。

一般的に、 は、 が真で、 が偽である場合にのみ聞くことができます。

コードサンプル

Push-to-talk

local players = game:GetService("Players")
local userInput = game:GetService("UserInputService")
local audioIn: AudioDeviceInput = players.LocalPlayer:WaitForChild("AudioDeviceInput")
audioIn.Muted = true
local pushToTalkKey = Enum.KeyCode.V
userInput.InputBegan:Connect(function(input: InputObject)
if input.KeyCode == pushToTalkKey then
audioIn.Muted = false
end
end)
userInput.InputEnded:Connect(function(input: InputObject)
if input.KeyCode == pushToTalkKey then
audioIn.Muted = true
end
end)

MutedByLocalUser

複製されていません
Robloxのスクリプトセキュリティ
並列読み取り

Player

並列読み取り

誰のデバイスが音を生成しているかを決定します。正しくレプリケートするには、これはサーバーからのみ割り当てられる必要があります。このプロパティをローカルで割り当てることは、PlayerPlayers.LocalPlayer でない限り、一般的に機能しません。

Volume

並列読み取り

出力オーディオストリームに乗算されるボリュームレベル。0から 3までの範囲。

方法

GetConnectedWires

Instances

指定されたピピン留めに接続された Wires のアレイを返します。AudioDeviceInput には「出力」ピン留めが 1 つあります。

パラメータ

pin: string
既定値: ""

戻り値

Instances

GetInputPins


戻り値

GetOutputPins


戻り値

GetUserIdAccessList

リターンするのは、 によって許可されているユーザーID リスト、またはこれを聞くことをブロックされているユーザーIDリストです。


戻り値

SetUserIdAccessList

()

ユーザーID リストを設定し、この AudioDeviceInput を聴くことが許可されているか、ブロックされているかによって、AccessType によって許可されるユーザーID リストを設定します。

このメソッドは、サーバーからクライアントにレプリケートします; 一全般的には、適切にレプリケートするためには、サーバーからのみ呼び出されるべきです。

パラメータ

userIds: Array
既定値: ""

戻り値

()

イベント

WiringChanged

Wire が接続または切断された後に発生するイベント、および Wire が現在または以前に AudioDeviceInput および他のワイヤー可能なインスタンスのピンに接続されているか、接続されていました。

パラメータ

connected: boolean

インスタンスが接続されたか、切断されたか。

pin: string

ターゲットの AudioDeviceInput にピンを打った Wire

wire: Wire

Wire と他のインスタンスの間の AudioDeviceInput

instance: Instance

Wire を介して接続された他のインスタンス。