# BallState

## Overview

BallState는 SimulationBall의 현재 상태를 나타내는 Enum입니다.

SimulationBall의 **BallState** 속성에서 사용되며, 볼 시뮬레이션의 재생 상태를 제어하고 확인할 수 있습니다. 시뮬레이션이 완료된 후 재생, 일시정지, 정지 등의 상태를 관리합니다.

## Items

| Name    | Value | Description                                                               |
| ------- | ----- | ------------------------------------------------------------------------- |
| Stopped | 0     | 시뮬레이션이 정지된 상태입니다. `Stop()` 메서드를 호출하면 이 상태가 되며, 재생 시간이 0으로 초기화됩니다.         |
| Paused  | 1     | 시뮬레이션이 일시정지된 상태입니다. `Pause()` 메서드를 호출하면 이 상태가 되며, 재생이 중단되지만 재생 시간은 유지됩니다. |
| Playing | 2     | 시뮬레이션이 재생 중인 상태입니다. `Play()` 메서드를 호출하면 이 상태가 되며, 볼이 움직이기 시작합니다.           |

## Options

| Name      | Value | Description                                                               |
| --------- | ----- | ------------------------------------------------------------------------- |
| Simulated | 0     | 시뮬레이션이 완료되어 재생 준비가 된 상태입니다. `Simulate()` 메서드 호출 후 이 상태가 됩니다.              |
| Playing   | 1     | 시뮬레이션이 재생 중인 상태입니다. `Play()` 메서드를 호출하면 이 상태가 되며, 볼이 움직이기 시작합니다.           |
| Stopped   | 2     | 시뮬레이션이 정지된 상태입니다. `Stop()` 메서드를 호출하면 이 상태가 되며, 재생 시간이 0으로 초기화됩니다.         |
| Paused    | 3     | 시뮬레이션이 일시정지된 상태입니다. `Pause()` 메서드를 호출하면 이 상태가 되며, 재생이 중단되지만 재생 시간은 유지됩니다. |

## See also

{% content-ref url="/pages/ca0qkgbvP2luHQy0HlFQ" %}
[SimulationBall](/korean/development/api-reference/classes/simulationball.md)
{% endcontent-ref %}


---

# 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/enums/ballstate.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.
