# ProximityPromptService

ProximityPromptService : `Instance`

## Overview

월드 내 모든 ProximityPrompt를 전역으로 관리하는 서비스입니다.

`game:GetService("ProximityPromptService")`를 통해 획득할 수 있습니다.

개별 ProximityPrompt 인스턴스 대신 이 서비스를 통해 이벤트를 수신하면, 월드 전체의 프롬프트 상호작용을 한 곳에서 처리할 수 있습니다.

## Properties

### Enabled

`boolean`

서비스 전체의 ProximityPrompt 기능을 활성화 또는 비활성화합니다.

false로 설정하면 월드의 모든 프롬프트가 표시되지 않습니다.

#### Code Samples

```lua
local ProximityPromptService = game:GetService("ProximityPromptService")
ProximityPromptService.Enabled = false
```

### MaxPromptsVisible

`number`

동시에 화면에 표시할 수 있는 프롬프트의 최대 개수입니다.

#### Code Samples

```lua
local ProximityPromptService = game:GetService("ProximityPromptService")
ProximityPromptService.MaxPromptsVisible = 3
```

## Methods

## Events

### PromptButtonHoldBegan

월드 내 어떤 ProximityPrompt의 버튼 홀드가 시작되었을 때 발생하는 이벤트입니다.

#### Parameters

| `ProximityPrompt` prompt | 해당 ProximityPrompt 인스턴스입니다. |
| ------------------------ | --------------------------- |
| `Player` player          | 버튼을 누르기 시작한 플레이어입니다.        |

#### Code Samples

```lua
local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptButtonHoldBegan:Connect(function(prompt, player)
    print(player.Name .. " started holding.")
end)
```

### PromptButtonHoldEnded

월드 내 어떤 ProximityPrompt의 버튼 홀드가 종료되었을 때 발생하는 이벤트입니다.

#### Parameters

| `ProximityPrompt` prompt | 해당 ProximityPrompt 인스턴스입니다. |
| ------------------------ | --------------------------- |
| `Player` player          | 버튼에서 손을 뗀 플레이어입니다.          |

#### Code Samples

```lua
local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptButtonHoldEnded:Connect(function(prompt, player)
    print(player.Name .. " stopped holding.")
end)
```

### PromptHidden

월드 내 어떤 ProximityPrompt가 화면에서 숨겨질 때 발생하는 이벤트입니다.

이 이벤트는 클라이언트 환경에서만 동작합니다.

#### Parameters

| `ProximityPrompt` prompt | 숨겨진 ProximityPrompt 인스턴스입니다. |
| ------------------------ | ---------------------------- |

#### Code Samples

```lua
local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptHidden:Connect(function(prompt)
    print(prompt.ObjectText .. " prompt is now hidden.")
end)
```

### PromptShown

월드 내 어떤 ProximityPrompt가 화면에 표시될 때 발생하는 이벤트입니다.

이 이벤트는 클라이언트 환경에서만 동작합니다.

#### Parameters

| `ProximityPrompt` prompt | 표시된 ProximityPrompt 인스턴스입니다. |
| ------------------------ | ---------------------------- |

#### Code Samples

```lua
local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptShown:Connect(function(prompt)
    print(prompt.ObjectText .. " prompt is now visible.")
end)
```

### PromptTriggered

월드 내 어떤 ProximityPrompt가 활성화되었을 때 발생하는 이벤트입니다.

#### Parameters

| `ProximityPrompt` prompt | 활성화된 ProximityPrompt 인스턴스입니다. |
| ------------------------ | ----------------------------- |
| `Player` player          | 프롬프트를 활성화한 플레이어입니다.           |

#### Code Samples

```lua
local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptTriggered:Connect(function(prompt, player)
    print(player.Name .. " interacted with " .. prompt.ObjectText)
end)
```

### PromptTriggerEnded

활성화 중이던 ProximityPrompt의 트리거가 완료되거나 취소되었을 때 발생하는 이벤트입니다.

#### Parameters

| `ProximityPrompt` prompt | 해당 ProximityPrompt 인스턴스입니다. |
| ------------------------ | --------------------------- |
| `Player` player          | 관련 플레이어입니다.                 |

#### Code Samples

```lua
local ProximityPromptService = game:GetService("ProximityPromptService")

ProximityPromptService.PromptTriggerEnded:Connect(function(prompt, player)
    print(player.Name .. "'s trigger has ended.")
end)
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overdare.com/korean/development/api-reference/classes/proximitypromptservice.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.