ProximityPromptService
*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.
ProximityPromptService 는 개발자가 전역 방식으로 ProximityPrompt 개체와 상호 작용할 수 있습니다. 개별 ProximityPrompt 개체를 통해 이벤트를 수신하는 것이 더 편리할 수 있습니다.
요약
속성
Class.ProximityPrompt|ProximityPrompts 이 경험 내에 표시되고 활성화되는지 여부.
플레이어에게 표시될 ProximityPrompts 의 최대 수.
이벤트
플레이어가 키 또는 버튼을 클릭하여 프롬프트에서 KeyboardKeyCode 키/버튼을 누르기 시작하면 트리거됩니다.
Class.ProximityPrompt.KeyboardKeyCode|KeyboardKeyCode 키/버튼을 눌러서 프롬프트에서 HoldDuration 를 지정한 경우에 트리거됩니다.
프롬프트가 숨겨지면 클라이언트 사이트를 트리거합니다.
프롬프트가 표시되면 클라이언트 사이트를 트리거합니다.
트리거는 플레이어가 프롬프트를 트리거하는 동안 KeyboardKeyCode 키/버튼을 눌러서 중지하면 발생합니다.
사용자가 이 메시지와 상호 작용할 때 트리거됩니다.
속성
Enabled
이 속성은 ProximityPrompts가 활성화되었는지 여부를 결정하므로 경험 내에 표시되지 않습니다. 틀린 경우 프롬프트가 표시되지 않습니다.
예를 들어, 원형 시스템에서는 경험의 특정 지점에서 프롬프트를 비활성화하여 근접 기반 상호 작용을 비활성화할 수 있습니다.
local ProximityPromptService = game:GetService("ProximityPromptService")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local enablePrompts = ReplicatedStorage:FindFirstChild("EnablePrompts") -- 바인딩 가능한 이벤트
-- 바인딩된 이벤트에 연결하고 경험 로직을 제어하는 다른 스크립트에서 화재하십시오.
enablePrompts.OnServerEvent:Connect(function(enabled)
ProximityPromptService.Enabled = enabled
end)
메서드
이벤트
PromptButtonHoldBegan
이 이벤트는 플레이어가 키 KeyboardKeyCode 키/버튼을 누르기 시작하면 트리거됩니다. HoldDuration 에 대한 키가 아닌 경우.
매개 변수
플레이어가 상호 작용하는 프롬프트입니다.
키/버튼을 가진 플레이어.
PromptButtonHoldEnded
이 이벤트는 플레이어가 프롬프트에서 KeyboardKeyCode 키/버튼을 떠나면 트리거됩니다. HoldDuration .
매개 변수
플레이어가 상호 작용하지 않도록 하는 프롬프트입니다.
키/버튼을 릴리스하는 플레이어.
PromptHidden
이 이벤트는 프롬프트가 숨겨지면 연결된 로컬 스크립트에서 클라이언트 사이를 트리거합니다.This event triggers client-side in connected local scripts when a prompt becomes hidden.
매개 변수
숨겨지는 프롬프트 인스턴스입니다.
PromptShown
이 이벤트는 프롬프트가 표시되면 연결된 로컬 스크립트에서 클라이언트 사이를 트리거합니다.This event triggers client-side in connected local scripts when a prompt becomes visible.
매개 변수
표시되는 프롬프트 인스턴스입니다.
이벤트를 트리거한 입력.
PromptTriggerEnded
이 이벤트는 플레이어가 프롬프트를 트리거할 때 KeyboardKeyCode 키/버튼을 눌러서 이벤트가 발생할 때 발생합니다. 이는 플레이어가 경험 내에서 일어나는 이벤트에 대해 키/버튼을 눌러야 하는 상황에서 상호 작용을 수행할 수 있도록 하려는 것입니다.
매개 변수
플레이어가 상호 작용하지 않도록 하는 프롬프트입니다.
키/버튼을 해제하는 플레이어.
PromptTriggered
이 이벤트는 플레이어가 프롬프트와 상호 작용을 완료할 때, 키/버튼이 KeyboardKeyCode 키/버튼을 누르거나 프롬프트의 HoldDuration 이 0이 아닐 때 트리거됩니다.
매개 변수
플레이어가 상호 작용하는 프롬프트입니다.
상호 작용하는 플레이어.