ProximityPromptService
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
ProximityPromptService permite a los desarrolladores interactuar con ProximityPrompt objetos de forma global.Puede ser más conveniente escuchar eventos a través de este servicio en lugar de en objetos individuales ProximityPrompt.
Resumen
Propiedades
Si ProximityPrompts están habilitados y, por lo tanto, se muestran, en la experiencia.
Número máximo de ProximityPrompts que se mostrará al jugador.
Eventos
Se activa cuando el jugador comienza a mantener presionada la tecla KeyboardKeyCode en una solicitud con un HoldDuration no nulo.
Se activa cuando el jugador deja de mantener presionada la tecla/botón KeyboardKeyCode en una solicitud con un HoldDuration no nulo.
Se activa el lado del cliente cuando una solicitud se vuelve oculta.
Se activa en el lado del cliente cuando una solicitud se vuelve visible.
Se activa cuando el jugador deja de mantener presionada la tecla KeyboardKeyCode mientras se activa una solicitud.
Se activa cuando el usuario interactúa con este mensaje.
Propiedades
Enabled
Esta propiedad determina si ProximityPrompts están habilitados y, por lo tanto, se muestran, en la experiencia. Cuando es falsa, no se mostrarán mensajes de promoción.
Por ejemplo, en un sistema basado en rondas, puedes desactivar solicitudes en ciertos puntos de la experiencia para deshabilitar interacciones basadas en la proximidad:
local ProximityPromptService = game:GetService("ProximityPromptService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local enablePrompts = ReplicatedStorage:FindFirstChild("EnablePrompts") -- Evento enlazable
-- Conectarse al evento vinculable y disparar desde otro script que controla la lógica de experiencia
enablePrompts.OnServerEvent:Connect(function(enabled)
ProximityPromptService.Enabled = enabled
end)
MaxPromptsVisible
Esta propiedad indica el número máximo de ProximityPrompts que se mostrará al jugador.
Métodos
Eventos
PromptButtonHoldBegan
Este evento se activa cuando el jugador comienza a mantener presionada la tecla KeyboardKeyCode en una solicitud con un valor no nulo HoldDuration.
Parámetros
El mensaje que el jugador comienza a interactuar.
El jugador que sostiene la llave/botón.
PromptButtonHoldEnded
Este evento se activa cuando el jugador deja de mantener presionada la tecla/botón KeyboardKeyCode en una solicitud con un valor no nulo HoldDuration.
Parámetros
El mensaje que el jugador deja de interactuar.
El jugador que lanza la tecla/botón retenido.
PromptHidden
Este evento activa los scripts locales conectados en el lado del cliente cuando una solicitud se vuelve invisible.
Parámetros
La instancia de aviso que se vuelve oculta.
PromptShown
Este evento activa los scripts locales conectados en el lado del cliente cuando una solicitud se vuelve visible.
Parámetros
La instancia de aviso que se vuelve visible.
La entrada que activó el evento.
PromptTriggerEnded
Este evento se activa cuando el jugador deja de mantener presionada la tecla KeyboardKeyCode mientras se activa una solicitud.Esto está destinado a permitir interacciones que requieren que el jugador mantenga una tecla/botón mientras sucede algo en la experiencia.
Parámetros
El mensaje que el jugador deja de interactuar.
El jugador que lanza la tecla/botón.
PromptTriggered
Este evento se activa cuando el jugador completa la interacción con una solicitud, ya sea cuando se presiona la tecla/botón KeyboardKeyCode o después de una cantidad de tiempo especificada de mantener presionada la tecla/botón si la solicitud de HoldDuration es no cero.
Parámetros
El mensaje que el jugador interactúa con.
El jugador interactuante.