ProximityPromptService
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
ProximityPromptService permite a los desarrolladores interactuar con objetos ProximityPrompt en un modo global. Puede ser más conveniente escuchar los eventos a través de este servicio que en los objetos individuales ProximityPrompt .
Resumo
Propriedades
Si ProximityPrompts están habilitados y, por lo tanto, se muestran, en la experiencia.
Máximo de ProximityPrompts que se mostrará al jugador.
Eventos
Se activa cuando el jugador comienza a mantener presionada la tecla KeyboardKeyCode en un prom示 con una tecla no nulo HoldDuration .
Se activa cuando el jugador deja de mantener presionada la tecla / botón KeyboardKeyCode en un prom示 con una tecla / botón no nulo HoldDuration .
Activa el lado del cliente cuando se hace invisible un prom示.
Activa el lado del cliente cuando se hace visible un prom示.
Se activa cuando el jugador deja de mantener presionado el botón KeyboardKeyCode mientras se activa un prom示t.
Se activa cuando el usuario interactúa con esta solicitud.
Propriedades
Enabled
Esta propiedad determina si ProximityPrompts están habilitados, y por lo tanto se muestran, en la experiencia. Cuando falso, no se mostrarán prom示tas.
Por ejemplo, en un sistema basado en rondas, puede desactivar las solicitudes en ciertos puntos de la experiencia para desactivar las interacciones basadas en proximidad:
local ProximityPromptService = game:GetService("ProximityPromptService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local enablePrompts = ReplicatedStorage:FindFirstChild("EnablePrompts") -- Evento vinculable
-- Conecta al evento vinculado y dispara desde otro script que controla la lógica de la experiencia
enablePrompts.OnServerEvent:Connect(function(enabled)
ProximityPromptService.Enabled = enabled
end)
Métodos
Eventos
PromptButtonHoldBegan
Este evento se activa cuando el jugador comienza a mantener presionada la tecla KeyboardKeyCode en un prom示 con una tecla no nulo HoldDuration .
Parâmetros
El mensaje que el jugador comienza a interactuar con.
El jugador que sostiene la llave / botón.
PromptButtonHoldEnded
Este evento se activa cuando el jugador deja de mantener presionada la tecla KeyboardKeyCode en un prom示 con una tecla no nulo HoldDuration .
Parâmetros
El mensaje que el jugador deja de interactuar con.
El jugador que libera la tecla / botón retenido.
PromptHidden
Este evento se activa en el lado del cliente en los scripts locales conectados cuando se hace una solicitud oculta.
Parâmetros
La instancia de invitación que se hace invisible.
PromptShown
Este evento se activa en el lado del cliente en los scripts locales conectados cuando una solicitud se hace visible.
Parâmetros
La instancia de prom示 que se hace visible.
La entrada que desencadenó el evento.
PromptTriggerEnded
Este evento se activa cuando el jugador deja de mantener presionado el KeyboardKeyCode key/button mientras se activa un prom示. Esto está destinado a permitir interacciones que requieren que el jugador mantenga una key/button mientras algo sucede en la experiencia.
Parâmetros
El mensaje que el jugador deja de interactuar con.
El jugador que libera la llave / botón.
PromptTriggered
Este evento se activa cuando el jugador completa la interacción con un mensaje, ya sea cuando se presiona la tecla KeyboardKeyCode o después de un tiempo especificado si la interacción está atascada.
Parâmetros
El mensaje que el jugador interactúa.
El jugador interactuante.