ProximityPromptService
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
ProximityPromptService は、開発者がグローバルな方法で ProximityPrompt オブジェクトと対話できるようにします。個々の ProximityPrompt オブジェクトではなく、このサービスを通じてイベントを聴く方が便利かもしれません。
概要
プロパティ
ProximityPrompts が有効になっていて、それゆえ経験中に表示されるかどうか
プレイヤーに表示される最大数の ProximityPrompts
イベント
プレイヤーが非ゼロの KeyboardKeyCode のプロンプトで HoldDuration キー/ボタンを長押し開始すると、トリガーが発動します。
プレイヤーが非ゼロの キー/ボタンを押し続けるプロンプトでトリガーが発動するとき。
プロンプトが非表示になると、クライアント側でトリガーが発動します。
プロンプトが表示されると、クライアント側をトリガーします。
プレイヤーがプロンプトをトリガーするときに KeyboardKeyCode キー/ボタンを長押ししないで停止するときにトリガーされます。
ユーザーがこのプロンプトと対話するときにトリガーが発動します。
プロパティ
Enabled
このプロパティは、ProximityPrompts が有効になっているか、そして経験中に表示されるかどうかを決定します。その値が false の場合、プロンプトは表示されません。
たとえば、ラウンドベースシステムでは、エクスペリエンスの特定のポイントでプロンプトを無効にして、近接ベースのインタラクションを無効にできます:
local ProximityPromptService = game:GetService("ProximityPromptService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local enablePrompts = ReplicatedStorage:FindFirstChild("EnablePrompts") -- バインド可能イベント
-- バインド可能イベントに接続し、他のスクリプトによる制御ロジックで発射する
enablePrompts.OnServerEvent:Connect(function(enabled)
ProximityPromptService.Enabled = enabled
end)
方法
イベント
PromptButtonHoldBegan
このイベントは、プレイヤーが非ゼロの KeyboardKeyCode キー/ボタンを押し続けるようになったときにトリガーされます。このイベントは、非ゼロの HoldDuration を持つプロンプトで発生します。
パラメータ
プレイヤーが対話を開始するプロンプト。
キー/ボタンを保持するプレイヤー。
PromptButtonHoldEnded
このイベントは、非ゼロの KeyboardKeyCode を持つプロンプトでプレイヤーが HoldDuration キー/ボタンを長押しを停止するとトリガーされます。
パラメータ
プレイヤーが相互作用を停止するプロンプト。
保持キー/ボタンをリリースするプレイヤー。
PromptHidden
このイベントは、プロンプトが非表示になったときにクライアント側の接続されたローカルスクリプトをトリガーします。
パラメータ
非表示になるプロンプトインスタンス。
PromptShown
このイベントは、プロンプトが表示されると、接続されたローカルスクリプトのクライアント側をトリガーします。
パラメータ
表示可能になるプロンプトインスタンス。
イベントをトリガーにした入力。
PromptTriggerEnded
このイベントは、プレイヤーがプロンプトをトリガーしている間、 KeyboardKeyCode キー/ボタンを長押しを停止すると発動します。これは、プレイヤーが何かが体験中にキー/ボタンを保持する必要のあるインタラクションを許可することを目的としています。
パラメータ
プレイヤーが相互作用を停止するプロンプト。
キー/ボタンをリリースするプレイヤー。
PromptTriggered
このイベントは、プレイヤーがプロンプトとのインタラクションを完了したときにトリガーされ、KeyboardKeyCode キー/ボタンが押されたり、指定された時間後にキー/ボタンを保持したりすると、プロンプトの HoldDuration がゼロでない場合があります。
パラメータ
プレイヤーが対話するプロンプト。
交流するプレイヤー。