# 이벤트

<callout>Spine Essential에서는 이벤트를 사용할 수 없습니다.</callout>

이벤트는 애니메이션 중에 어떤 작업이 일어나게 하는 트리거입니다. Spine 편집기에서 이벤트를 구성하여 오디오를 재생할 수 있습니다. 그렇지 않으면 이벤트는 런타임 시 처리되도록 되어 있으며, 여기서 코드를 작성하여 이벤트에 대한 반응으로 원하는 어떤 작업이든 수행할 수 있습니다. 예를 들어, 파티클 효과를 생성하고, 적을 다치게 하고, 문을 여는 등의 작업을 수행합니다.

오디오 이벤트에 대한 오디오 재생은 Spine 편집기의 기능이지만, Spine 런타임에서는 오디오 재생을 관리하지 않습니다. 런타임 시 코드를 작성하여 [이벤트를 처리](/spine-applying-animations#수신기)한 다음 이벤트의 오디오 경로, 볼륨 및 밸런스 속성을 사용하여 적절한 오디오를 재생해야 합니다.

Spine에서 내보낸 동영상에는 오디오 이벤트의 오디오가 포함될 수 있습니다. 자세한 내용은 [AVI 내보내기](/spine-export#AVI) 및 [MOV 내보내기](/spine-export#MOV)를 참조하십시오.

# 설정

트리에서 `Events` 노드를 선택한 다음 `New...` `Event`를 클릭하면 이벤트가 생성됩니다.

![](/img/spine-user-guide/events/new.png)

# 속성

![](/img/spine-user-guide/events/properties.png)

`Integer`, `Float` 및 `String` 속성은 이벤트에 대한 추가 정보 또는 컨텍스트를 제공하는 값입니다. 설정 포즈에는 이러한 값에 대한 기본값이 있으며 각 이벤트 키에는 다른 값이 있을 수 있습니다.

## 정수

분수 부분 없이 정수를 저장합니다. [키를 지정](/spine-keys#이벤트)할 수 있습니다.

## 부동 소수점

분수 부분이 있을 수 있는 숫자를 저장합니다. [키를 지정](/spine-keys#이벤트)할 수 있습니다.

## 문자열

텍스트 문자열을 저장합니다. [키를 지정](/spine-keys#이벤트)할 수 있습니다.

## 오디오 경로

오디오 경로가 설정된 경우, 애니메이션 재생 중에 이 이벤트의 키가 발견되면 Spine 편집기에서 해당 오디오 파일을 재생합니다. 자세한 내용은 [오디오 파일 검색](#오디오-파일-검색)을 참조하십시오.

오디오 경로가 설정되면, 이벤트는 [오디오 이벤트](#오디오-이벤트)가 되고 `Volume`과 `Balance` 속성이 나타납니다.

### 볼륨

Spine 편집기에서 재생될 때 오디오 이벤트의 재생 볼륨이 설정됩니다. 이 속성은 [키를 지정](/spine-keys#이벤트)할 수 있습니다.

### 밸런스

Spine 편집기에서 재생될 때 오디오 이벤트의 밸런스가 설정됩니다. 이 속성은 [키를 지정](/spine-keys#이벤트)할 수 있습니다.

2개 채널 오디오의 경우, 이 속성에서 왼쪽 및 오른쪽 채널의 볼륨을 설정합니다. 1개 채널 오디오의 경우, 이 속성에서 오디오를 왼쪽 또는 오른쪽으로 이동합니다.

# 오디오 노드

Spine에서 스켈레톤에 대한 WAV, MP3 및 OGG 오디오 파일을 찾을 수 있는 폴더 경로가 트리의 `Audio` 노드에 있습니다. 오디오 경로는 프로젝트 파일이 저장된 위치와 관계있을 수 있거나 절대 경로일 수 있습니다. `Browse` 버튼을 사용하여 경로를 지정하거나 경로를 입력한 후 `enter` 키를 누를 수 있습니다. 경로가 설정되면 해당 폴더의 오디오 파일이 `Audio` 노드 아래에 나타납니다. Spine에서는 오디오 폴더를 감시하고 변경 사항을 오디오 파일에 즉시 로드합니다.

![](/img/spine-user-guide/events/audio.png)

기본적으로 오디오 폴더에 있는 처음 2,000개의 오디오 파일만 표시됩니다. 따라서 잘못된 경로를 잘못 지정한 경우 Spine에서는 수백만 개의 파일을 검색하지 못합니다. `Limit scanning`을 선택을 하지 않으면 Spine에서 2,000개 이상의 오디오 파일을 찾을 수 있습니다.

## 오디오 이벤트

"오디오 이벤트"는 [오디오 경로](#오디오-경로)가 설정된 이벤트입니다. 오디오 이벤트를 입력하거나 트리에서 오디오 파일을 이벤트로 드래그하여 오디오 경로를 설정할 수 있습니다.

또는 오디오 파일을 선택하고 트리 속성에서 `New Event`를 클릭하여 새 오디오 이벤트를 생성할 수 있습니다. 이렇게 하면 동일한 이름의 이벤트가 생성되고 오디오 경로가 설정됩니다.

`Audio` 노드 아래의 각 오디오 파일에는 이벤트에서 사용되지 않는 경우 빨간색 아이콘이 있고, 하나 이상의 이벤트에서 사용되는 경우 녹색 아이콘이 있습니다.

트리의 이벤트 옆에 있는 표시점이 지워지면 오디오가 재생되지 않으며, [오디오 뷰](/spine-audio-view)에 표시되지 않습니다.

## 오디오 파일 검색

Spine에서는 `Audio` 노드 아래 지정된 경로를 선택한 다음 이벤트의 오디오 경로를 추가하여 이벤트에 대한 오디오 파일을 찾습니다. 이벤트의 오디오 경로에는 파일 확장자를 포함할 필요가 없습니다. Spine에서는 파일 확장자가 `.wav`, `.mp3` 또는 `.ogg`인 파일을 찾습니다.

예를 들어, 오디오 노드에 `./audio/`가 있고 이벤트에 `footstep`의 오디오 경로가 있는 경우, Spine에서는 `./audio/footstep.wav`, `./audio/footstep.mp3` 및 `./audio/footstep.ogg`를 찾습니다. 일부 운영 체제에서는 대소문자를 구분합니다.

오디오 경로에는 하위 폴더가 포함될 수 있습니다. 예를 들어, 오디오 노드에 `./audio/`가 있고 이벤트에 `gun/reload`의 오디오 경로가 있는 경우, Spine에서는 `./audio/gun/reload.wav`를 찾습니다.

## 오디오 형식

Spine에서는 WAV, MP3 및 OGG 오디오 파일을 지원합니다. WAV 파일은 PCM, 1개 또는 2개 채널 및 샘플당 16비트이어야 합니다.

[SoX](http://sox.sourceforge.net/)는 오디오 파일을 변환하는 무료 명령줄 도구입니다. 예를 들어, WAV 파일을 샘플당 16비트로 변환하려면 다음과 같습니다.

```
sox input.wav -b 16 output.wav
```

# 뷰포트 이벤트

애니메이션 재생 중에 이벤트 키가 발견되면 이벤트 이름이 뷰포트의 스켈레톤 위에 잠시 표시됩니다.

![](/img/spine-user-guide/events/viewport-name.png)

뷰포트의 이벤트 이름을 숨기려면 트리의 이벤트 옆에 있는 표시점을 지웁니다. 이벤트가 오디오 이벤트인 경우 재생되지 않으며 [오디오 뷰](/spine-audio-view)에 표시되지 않습니다.

뷰포트의 모든 이벤트 이름을 숨기려면 [그래프 필터](/spine-graph#필터) 및 [도프시트 필터](/spine-dopesheet#필터)를 모두 설정하여 이벤트를 제외합니다.

## 폴더

이벤트는 폴더로 구성할 수 있습니다. 폴더를 생성하려면 이벤트를 선택한 후 `New...` `Folder`를 클릭합니다. 이벤트를 드래그하여 폴더 간에 이동할 수 있습니다.

내보낸 스켈레톤 데이터에서 폴더 이름은 이벤트 이름 앞에 추가되어 Spine 런타임에서 사용되는 최종 이름이 생성됩니다. 예를 들어, `attacks` 폴더에 `reload` 이벤트가 있는 경우 런타임 시 이벤트 이름은 `attacks/reload`가 됩니다.

# 동영상

[youtube:gPj9ZkSb0gU&list=PLwGl7Ikd_6GRFo7d0uRu_fN2RIlvkxW7b]

[다음: 뷰](/spine-views)
[이전: 변형 제약조건](/spine-transform-constraints)
[Spine 사용자 가이드: 목차]