ProximityPromptService
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
ProximityPromptService permet aux développeurs d'interagir avec ProximityPrompt objets dans une manière globale. Il peut être plus pratique d'écouter les événements via ce service plutôt que sur les objets individuels ProximityPrompt.
Résumé
Propriétés
Que ProximityPrompts soient activés et donc affichés dans l'expérience.
Nombre maximum de ProximityPrompts qui seront affichés au joueur.
Évènements
Se déclenche lorsque le joueur commence à maintenir la touche KeyboardKeyCode sur un bouton avec une durée d'expiration non zéro HoldDuration.
Se déclenche lorsque le joueur arrête de maintenir la touche KeyboardKeyCode sur un bouton avec une durée d'expiration non zéro HoldDuration.
Activer le côté client lorsqu'une invite devient invisible.
Activer le côté client lorsqu'une invite devient visible.
Activer quand le joueur arrête de maintenir la touche KeyboardKeyCode lorsqu'il active une invite.
Se déclenche lorsque l'utilisateur interagit avec cette invite.
Propriétés
Enabled
Cette propriété détermine si ProximityPrompts sont activés, et donc affichés, dans l'expérience. Lorsque faux, aucune invitation à l'action ne sera affichée.
Par exemple, dans un système basé sur des tours, vous pouvez désactiver les invitations à certains moments de l'expérience pour désactiver les interactions basées sur la proximité :
local ProximityPromptService = game:GetService("ProximityPromptService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local enablePrompts = ReplicatedStorage:FindFirstChild("EnablePrompts") -- Événement liable
-- Connectez-vous à l'événement lié et tirez d'un autre script qui contrôle la logique d'expérience
enablePrompts.OnServerEvent:Connect(function(enabled)
ProximityPromptService.Enabled = enabled
end)
MaxPromptsVisible
Cette propriété indique le nombre maximum de ProximityPrompts qui seront affichés au joueur.
Méthodes
Évènements
PromptButtonHoldBegan
Cet événement se déclenche lorsque le joueur commence à maintenir la touche KeyboardKeyCode sur une fenêtre avec une durée d'expiration non zéro HoldDuration.
Paramètres
La fenêtre dans laquelle le joueur commence à interagir.
Le joueur qui détient la clé/bouton.
PromptButtonHoldEnded
Cet événement se déclenche lorsque le joueur arrête de maintenir la touche KeyboardKeyCode ou le bouton sur une invite avec une durée non zéro HoldDuration.
Paramètres
La demande qui le joueur arrête d'interagir avec.
Le joueur qui libère la touche/bouton maintenu.
PromptHidden
Cet événement déclenche le côté client dans les scripts locaux connectés lorsqu'une invitation devient cachée.
Paramètres
L'instance d'invite qui devient cachée.
PromptShown
Cet événement déclenche le côté client dans les scripts locaux connectés lorsqu'une invitation devient visible.
Paramètres
L'instance d'invite qui devient visible.
L'entrée qui a déclenché l'événement.
PromptTriggerEnded
Cet événement se déclenche lorsque le joueur arrête de maintenir la touche KeyboardKeyCode enfoncée pendant qu'il déclenche une touche/bouton. Cela est destiné à permettre les interactions qui nécessitent que le joueur maintene une touche/bouton pendant que quelque chose se produit dans l'expérience.
Paramètres
La demande qui le joueur arrête d'interagir avec.
Le joueur qui libère la clé/bouton.
PromptTriggered
Cet événement se déclenche lorsque le joueur termine l'interaction avec un bouton, soit lorsque la clé KeyboardKeyCode est appuyée, soit après un certain nombre de temps spécifiés lorsque la clé/le bouton est maintenue si la valeur HoldDuration du bouton n'est pas nulle.
Paramètres
La fenêtre avec laquelle le joueur interagit.
Le joueur interactif.