ProximityPromptService
*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.
근접 알림 서비스 는 개발자가 전역적으로 ProximityPrompt 개체와 상호작용할 수 있도록 허용합니다.개별 객체가 아닌 이 서비스를 통해 이벤트를 듣는 것이 더 편리할 수 있습니다. ProximityPrompt
요약
속성
경험 내에서 ProximityPrompts 가 활성화되고 표시되는지 여부
플레이어에게 표시될 최대 수의 ProximityPrompts 요소.
이벤트
플레이어가 0보다 큰 KeyboardKeyCode 키/버튼을 누르는 프롬프트에서 트리거가 시작되면 HoldDuration 키/버튼을 길게 누르기 시작합니다.
플레이어가 0보다 큰 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
이 이벤트는 플레이어가 0보다 큰 KeyboardKeyCode 키/버튼을 누르기 시작할 때 트리거됩니다.This event triggers when the player begins holding down the key/button on a prompt with a non-zero HoldDuration .
매개 변수
플레이어가 상호 작용하기 시작하는 프롬프트.
키/버튼을 보유하는 플레이어.
PromptButtonHoldEnded
이 이벤트는 플레이어가 0보다 큰 KeyboardKeyCode 키/버튼을 길게 누르는 프롬프트에서 HoldDuration 키/버튼을 누르지 않을 때 트리거됩니다.
매개 변수
플레이어가 상호 작용을 중지하는 프롬프트.
보유 중인 키/버튼을 릴리스하는 플레이어.
PromptHidden
이 이벤트는 프롬프트가 은폐되면 연결된 로컬 스크립트에서 클라이언트 측을 트리거합니다.
매개 변수
숨겨지는 프롬프트 인스턴스.
PromptShown
이 이벤트는 프롬프트가 표시되면 연결된 로컬 스크립트에서 클라이언트 측을 트리거합니다.
매개 변수
표시되는 프롬프트 인스턴스.
이벤트를 트리거한 입력.
PromptTriggerEnded
이 이벤트는 플레이어가 프롬프트를 트리거하는 동안 KeyboardKeyCode 키/버튼을 길게 누르지 않을 때 트리거됩니다.플레이어가 경험 내에서 키/버튼을 누르고 있어야 하는 상호작용을 허용하기 위한 것입니다.
매개 변수
플레이어가 상호 작용을 중지하는 프롬프트.
키/버튼을 발행하는 플레이어.
PromptTriggered
이 이벤트는 플레이어가 프롬프트와 상호작용을 완료할 때 트리거되며, KeyboardKeyCode 키/버튼이 누르거나 특정 시간 후에 키/버튼을 누르면 프롬프트의 HoldDuration 가 0이 아닌 경우에 발생합니다.
매개 변수
플레이어가 상호 작용하는 프롬프트.
상호 작용하는 플레이어.