ProximityPromptService

非推奨を表示

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

サービス
閲覧できません

ProximityPromptService は、開発者がグローバルな方法で ProximityPrompt オブジェクトと対話できるようにします。個々の ProximityPrompt オブジェクトではなく、このサービスを通じてイベントを聴く方が便利かもしれません。

概要

プロパティ

イベント

プロパティ

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)

MaxPromptsVisible

並列読み取り

このプロパティは、プレイヤーに表示される最大数の ProximityPrompts を示します。

方法

イベント

PromptButtonHoldBegan

このイベントは、プレイヤーが非ゼロの KeyboardKeyCode キー/ボタンを押し続けるようになったときにトリガーされます。このイベントは、非ゼロの HoldDuration を持つプロンプトで発生します。

パラメータ

プレイヤーが対話を開始するプロンプト。

playerWhoTriggered: Player

キー/ボタンを保持するプレイヤー。


PromptButtonHoldEnded

このイベントは、非ゼロの KeyboardKeyCode を持つプロンプトでプレイヤーが HoldDuration キー/ボタンを長押しを停止するとトリガーされます。

パラメータ

プレイヤーが相互作用を停止するプロンプト。

playerWhoTriggered: Player

保持キー/ボタンをリリースするプレイヤー。


PromptHidden

このイベントは、プロンプトが非表示になったときにクライアント側の接続されたローカルスクリプトをトリガーします。

パラメータ

非表示になるプロンプトインスタンス。


PromptShown

このイベントは、プロンプトが表示されると、接続されたローカルスクリプトのクライアント側をトリガーします。

パラメータ

表示可能になるプロンプトインスタンス。

イベントをトリガーにした入力。


PromptTriggerEnded

このイベントは、プレイヤーがプロンプトをトリガーしている間、 KeyboardKeyCode キー/ボタンを長押しを停止すると発動します。これは、プレイヤーが何かが体験中にキー/ボタンを保持する必要のあるインタラクションを許可することを目的としています。

パラメータ

プレイヤーが相互作用を停止するプロンプト。

playerWhoTriggered: Player

キー/ボタンをリリースするプレイヤー。


PromptTriggered

このイベントは、プレイヤーがプロンプトとのインタラクションを完了したときにトリガーされ、KeyboardKeyCode キー/ボタンが押されたり、指定された時間後にキー/ボタンを保持したりすると、プロンプトの HoldDuration がゼロでない場合があります。

パラメータ

プレイヤーが対話するプロンプト。

playerWhoTriggered: Player

交流するプレイヤー。