근접 프롬프트

ProximityPrompt 개체는 사용자가 경험 내 개체, 예를 들어 문, 조명 스위치 및 버튼에 다가갈 때 작업을 트리거하도록 장려합니다. 이 개체를 사용하면 다음을 할 수 있습니다.

사용자가 경험에서 상호 작용할 수 있는 개체를 나타냅니다.
사용자가 개체에서 수행할 수 있는 동작을 표시한 다음 키를 누르거나 길게 누르는 등의 사용자 입력을 통해 동작을 트리거합니다.
모든 입력 유형에 대해 올바른 입력을 표시합니다. 키보드, 게임 패드 및 터치 스크린 키.

위의 동영상에 표시된 것처럼 근접 프롬프트 예시를 위해 Dungeon Delve 샘플 장소를 참조하십시오.

근접 프롬프트 생성

사용자가 상호 작용하려는 부품, 모델 또는 부착을 부모로 지정해야 합니다. 부모에 근접 프롬프트를 추가하려면 BasePart, Model 또는 Attachment 개체를 부모로 지정합니다.

탐색기 창에서 Class.BasePart, BasePart 또는 Model 을 마우스로 가져다가 2>Class.Button2> 을 클릭하십시오. 컨텍스트 메뉴가 표시됩니다.
메뉴에서 근접 프롬프트를 삽입합니다.

원하는 대로 가까이 얻기 위해 표시하려는 위치, 표시하려는 경우 사용자가 수행해야 하는 작업 및 응용 프로그램을 사용자 지정할 수 있습니다.You can customize a proximity prompt based on how you want it to appear , when you want it to be visible , and what you want a user to do to trigger the action .

모양

근접 프롬프트는 다음과 같은 세 가지 메시지를 전달해야 합니다.

사용자가 상호 작용할 수 있는 개체 입니다.
근접 프롬프트와 상호 작용할 때 트리거되는 액션 입니다.
사용자가 누르거나 길게 누르어야 하는 키 .

다음 속성을 통해 지정할 수 있습니다:

ObjectText 사용자가 상호 작용할 수 있는 개체의 옵션 이름입니다.
ActionText 사용자가 트리거하는 동작에 대한 옵션 이름.
KeyboardKeyCode 사용자가 액션을 트리거하려면 키보드 키를 누르거나 길게 누르면 됩니다.
GamepadKeyCode 사용자가 트리거할 액션실행하려면 게임 패드 키를 누르거나 길게 누르면 됩니다.

이벤트	설명
PromptTriggered	근접 프롬프트와 상호 작용할 때 화면( Class.ProximityPrompt.HoldDuration\|HoldDuration)에 대한 지속 시간이 끝난 후 화면에 표시됩니다.
PromptTriggerEnded	근접 프롬프트와 상호 작용을 중지할 때 트리거됩니다.
PromptButtonHoldBegan	근접 프롬프트에 대한 플레이어의 상호 작용 시작 시 발생합니다. 값이 0이 아닌 HoldDuration 입니다.
PromptButtonHoldEnded	근접 프롬프트에 대한 플레이어의 상호 작용 중지 시간이 0이 아닌 값으로 HoldDuration 일 때 화면에 표시됩니다.
PromptShown	근접 프롬프트가 표시될 때 LocalScripts 에서 트리거.
PromptHidden	프롬프트가 숨겨진 경우 LocalScripts 에서 트리거.

다음 코드 샘플에는 ProximityPromptService를 사용하는 기본 프레임워크가 포함되어 있습니다.


local ProximityPromptService = game:GetService("ProximityPromptService")

-- 프롬프트가 트리거될 때 감지
local function onPromptTriggered(promptObject, player)

end

-- 프롬프트 홀드가 시작될 때 감지
local function onPromptHoldBegan(promptObject, player)

end

-- 프롬프트 보유가 끝나면 감지
local function onPromptHoldEnded(promptObject, player)

end

-- 처리 함수에 이벤트 연결
ProximityPromptService.PromptTriggered:Connect(onPromptTriggered)
ProximityPromptService.PromptButtonHoldBegan:Connect(onPromptHoldBegan)
ProximityPromptService.PromptButtonHoldEnded:Connect(onPromptHoldEnded)

근접 프롬프트 생성

근접 프롬프트 사용자 정의

모양

가시성

최대 활성화 거리

시야선 필요

독점

인터액티비티

지속 시간

클릭 가능한 프롬프트

근접 프롬프트 스크립트