ProximityPromptService

显示已弃用

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

服务
不可浏览

靠近提示服务 允许开发人员以全球方式与 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

互动的玩家。