ProximityPromptService
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Serviço de Aviso de Proximidade permite que os desenvolvedores interajam com ProximityPrompt de uma maneira global.Pode ser mais conveniente ouvir eventos através deste serviço em vez de em objetos individuais ProximityPrompt.
Resumo
Propriedades
Se ProximityPrompts estiverem habilitados e, portanto, mostrados, na experiência.
Número máximo de ProximityPrompts que será mostrado ao jogador.
Eventos
Ativa quando o jogador começa a segurar a tecla/botão KeyboardKeyCode na pressão de um prompt com um HoldDuration não zero.
Ativa quando o jogador para de segurar a tecla/botão KeyboardKeyCode na pressão de um prompt com um HoldDuration não zero.
Ativa o lado do cliente quando um prompt se torna oculto.
Ativa o lado do cliente quando um prompt se torna visível.
Ativa quando o jogador para de segurar a tecla/botão KeyboardKeyCode enquanto ativa um prompt.
Ativa quando o usuário interage com este aviso.
Propriedades
Enabled
Essa propriedade determina se ProximityPrompts são habilitados e, portanto, mostrados, na experiência. Quando falsa, nenhum prompt será mostrado.
Por exemplo, em um sistema baseado em rodadas, você pode desativar solicitações em determinados pontos da experiência para desativar interações baseadas em proximidade:
local ProximityPromptService = game:GetService("ProximityPromptService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local enablePrompts = ReplicatedStorage:FindFirstChild("EnablePrompts") -- Evento Vinculável
-- Conecte-se ao BindableEvent e dispare de outro script que controla a lógica de experiência
enablePrompts.OnServerEvent:Connect(function(enabled)
ProximityPromptService.Enabled = enabled
end)
MaxPromptsVisible
Essa propriedade indica o número máximo de ProximityPrompts que será mostrado ao jogador.
Métodos
Eventos
PromptButtonHoldBegan
Este evento é acionado quando o jogador começa a segurar a tecla/botão KeyboardKeyCode na pressão de um prompt com um HoldDuration não zero.
Parâmetros
O prompt com o qual o jogador começa a interagir.
O jogador que segura a chave/botão.
PromptButtonHoldEnded
Este evento é acionado quando o jogador para de manter pressionada a tecla/botão KeyboardKeyCode em um prompt com um HoldDuration não zero.
Parâmetros
O aviso que o jogador para de interagir.
O jogador que libera a tecla/botão segurada.
PromptHidden
Este evento gera scripts locais conectados do lado do cliente quando um prompt se torna oculto.
Parâmetros
A instância de solicitação que se torna oculta.
PromptShown
Este evento gera scripts locais conectados do lado do cliente quando um prompt se torna visível.
Parâmetros
A instância de solicitação que se torna visível.
A entrada que disparou o evento.
PromptTriggerEnded
Este evento é acionado quando o jogador para de manter pressionada a tecla/botão KeyboardKeyCode enquanto ativa um prompt.Isto tem a intenção de permitir interações que exigem que o jogador segure uma tecla/botão enquanto algo acontece na experiência.
Parâmetros
O aviso que o jogador para de interagir.
O jogador que libera a tecla/botão.
PromptTriggered
Este evento é acionado quando o jogador completa a interação com um prompt, seja quando a tecla/botão pressionado, ou após uma quantidade especificada de tempo segurando a tecla/botão se o prompt for não-zero.
Parâmetros
O prompt com o qual o jogador interage.
O jogador interagindo.