> For the complete documentation index, see [llms.txt](https://docs.overdare.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.overdare.com/korean/development/api-reference/enums/ballstate.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.overdare.com/korean/development/api-reference/enums/ballstate.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.