# 인터페이스

## 개요

<figure><img src="/files/6G7mpSvwRolsC25TrinP" alt=""><figcaption></figcaption></figure>

액션시퀀서 에디터는 ActionSequence 인스턴스에 마우스를 올리면 표시되는 **Open 버튼**을 클릭하여 열 수 있습니다.

여러 액션시퀀스를 동시에 열어 편집할 수 있으며, **각 액션시퀀스는 별도의 탭으로 표시**됩니다. 이를 통해 **여러 액션**을 빠르게 전환하며 확인하거나 비교하면서 작업할 수 있습니다.

## 주의 사항

플레이 테스트 중 편집한 내용은 즉시 반영되지 않으며, 재실행 시 적용됩니다.

## 화면 구성

<figure><img src="/files/2hFTMoRfpUVBJsee8r4h" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="195.3333740234375">UI</th><th>설명</th></tr></thead><tbody><tr><td>액션시퀀서 툴바</td><td>작업 내용을 저장하거나 JSON 형식으로 Import/Export할 수 있으며, 각 패널의 표시 여부를 설정할 수 있습니다.</td></tr><tr><td>뷰포트</td><td>액션시퀀스의 연출 결과를 미리 확인할 수 있는 미리보기 화면입니다. 타임라인 재생을 통해 애니메이션 및 연출 결과를 확인할 수 있습니다.</td></tr><tr><td>타임라인 툴바</td><td>타임라인 편집에 필요한 주요 기능을 제공하는 영역입니다.<br>트랙 추가, 재생 길이 설정, 편집 잠금, 카메라 빙의, 시간/프레임 단위 전환, 화면에 채우기 기능을 사용할 수 있습니다.</td></tr><tr><td>재생 컨트롤</td><td>타임라인의 재생과 탐색을 제어하는 영역입니다.<br>스크러버 이동(구간 시작/끝), 키프레임/섹션 단위 이동, 프레임 단위 이동, 재생/역재생, 재생 길이 설정 및 반복 기능을 제공합니다.</td></tr><tr><td>트랙 목록</td><td>액션시퀀스에 포함된 트랙들을 관리하는 영역입니다.</td></tr><tr><td>타임라인</td><td>트랙의 섹션과 키프레임 등이 표시되는 영역입니다.</td></tr><tr><td>스크러버</td><td>타임라인에서 현재 재생 위치를 나타내는 기준선으로, 드래그하여 원하는 시점으로 이동할 수 있습니다.</td></tr><tr><td>트랙 프로퍼티</td><td>선택한 트랙의 속성을 편집하는 영역입니다.</td></tr></tbody></table>

### 액션시퀀서 툴바

<figure><img src="/files/8QSKrJz7BnsDxWfxLNzc" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="134.6666259765625">버튼</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/u1pFgxWuRyz0J9veRxmU" alt=""></td><td>액션시퀀스 저장<br>(액션시퀀스를 저장하더라도 <strong>맵을 저장하지 않으면 데이터가 누락될 수 있습니다.</strong>)</td></tr><tr><td><img src="/files/zTfU9R0HIeq6W3HbDr0B" alt=""></td><td>액션시퀀스 JSON 데이터 적용</td></tr><tr><td><img src="/files/Q1CPlMoaI93tUL7cb5Ej" alt=""></td><td>액션시퀀스 JSON 데이터 추출</td></tr><tr><td><img src="/files/ETb7AsTxAerFQ6c4ucbS" alt=""></td><td>프리셋 선택 팝업 표시</td></tr><tr><td><img src="/files/P2srNeYoIDbW2Ra6V5Zs" alt=""></td><td>타임라인 표시</td></tr><tr><td><img src="/files/TmKeg16AuumKiHDhCyRH" alt=""></td><td>트랙 프로퍼티 패널 표시</td></tr></tbody></table>

프리셋 자세히 알아보기

{% content-ref url="/pages/KKU7niOqI4ZsXqJHxztZ" %}
[프리셋](/korean/manual/studio-manual/game-development/actionsequence/actionsequence-preset.md)
{% endcontent-ref %}

### 뷰포트

<figure><img src="/files/n4nhYoW5K7H7sPvDIEXN" alt=""><figcaption></figcaption></figure>

뷰포트는 액션 시퀀스의 연출을 확인하고 카메라를 조작하는 영역입니다. 키보드와 마우스를 통해 이동, 회전, 확대/축소를 수행할 수 있습니다.

<table><thead><tr><th width="195.3333740234375">조작</th><th>설명</th></tr></thead><tbody><tr><td>W / A / S / D</td><td><strong>Viewport를 클릭한 다음</strong> W/A/S/D를 누르거나, <strong>마우스 우클릭 상태에서</strong> W/A/S/D를 눌러 카메라를 앞/왼쪽/뒤/오른쪽으로 움직일 수 있습니다.</td></tr><tr><td>Q / E</td><td><strong>Viewport를 클릭한 다음</strong> Q/E를 누르거나, <strong>마우스 우클릭 상태에서</strong> Q/E를 눌러 카메라를 아래/위쪽으로 이동할 수 있습니다.</td></tr><tr><td>Shift</td><td>Shift키와 이동키(W,A,S,D)를 함께 누르게 되면 카메라 이동 속도를 변경할 수 있습니다.</td></tr><tr><td>마우스 우클릭</td><td><strong>마우스를 우클릭한 상태에서</strong> 움직이면 카메라를 회전할 수 있습니다.</td></tr><tr><td>마우스 휠 업/다운</td><td><strong>마우스 휠 업/다운 버튼</strong>으로 카메라를 축소/확대할 수 있습니다.</td></tr><tr><td>마우스 휠 버튼</td><td><strong>마우스 휠 버튼을 누른 상태</strong>에서 움직이면 카메라를 움직일 수 있습니다.</td></tr></tbody></table>

### 타임라인 툴바

<figure><img src="/files/l2kF9IxYM0zsQosxUmT6" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="134.6666259765625">버튼</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/gn6AMtEKqo7bU9GMKK6X" alt=""></td><td>트랙 추가<br>(같은 종류의 트랙을 여러 개 추가할 수 있습니다.)</td></tr><tr><td><img src="/files/wVtgiSa43BruXvQ4onVx" alt=""></td><td>재생 길이 설정 필드</td></tr><tr><td><img src="/files/LvD5VXh2Ksu6C6cYFtFn" alt=""></td><td>전체 트랙 편집 잠금</td></tr><tr><td><img src="/files/KJttSG3QmIVw580XBXyx" alt=""></td><td>편집 카메라/캐릭터 카메라 시점 전환<br>(Camera Shake, Camera FOV, Camera Zoom 트랙의 미리보기 시 사용됩니다.)</td></tr><tr><td><img src="/files/l2HD3YDONKuccjVyUNJo" alt=""></td><td>시간/프레임 단위 전환</td></tr><tr><td><img src="/files/0gGw3pmxwRKS1lfedvBA" alt=""></td><td>재생 길이에 맞춰 타임라인을 화면에 채우기</td></tr></tbody></table>

### 재생 컨트롤

<div align="left"><figure><img src="/files/cfb2EbXovlXPbtLZiLG3" alt=""><figcaption></figcaption></figure></div>

<table><thead><tr><th width="134.6666259765625">버튼</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/dYpgwPpbEU2iQWRxUHqz" alt=""></td><td>재생 시작 위치로 스크러버 이동</td></tr><tr><td><img src="/files/rQ5FbgAyb3QzlghvWC2b" alt=""></td><td>이전 키프레임/섹션으로 이동</td></tr><tr><td><img src="/files/CI2WW983MiZOoWVJr2r8" alt=""></td><td>이전 프레임으로 이동</td></tr><tr><td><img src="/files/hw86gAJVJ5W6mCJ7Wp0a" alt=""></td><td>역재생 또는 일시정지</td></tr><tr><td><img src="/files/vuEeMEZFrMTgZabjKQPF" alt=""></td><td>재생 또는 일시정지</td></tr><tr><td><img src="/files/pOILBwWgKBON6L1IdL43" alt=""></td><td>다음 프레임으로 이동</td></tr><tr><td><img src="/files/nnX90isK6wwdBnHNIWNh" alt=""></td><td>다음 키프레임/섹션으로 이동</td></tr><tr><td><img src="/files/CUdzU8UtDjCj31d5ecWr" alt=""></td><td>재생 종료 위치로 스크러버 이동</td></tr><tr><td><img src="/files/Lk1UV6fCTdcXglfER2AY" alt=""></td><td>재생 길이를 현재 스크러버 위치로 설정</td></tr><tr><td><img src="/files/xgDgd5ORP1xarXMs3fFs" alt=""></td><td>반복 재생 여부 설정</td></tr></tbody></table>

### 트랙 목록

<div align="left"><figure><img src="/files/UX3oiYB9Hve25xPTr6EJ" alt=""><figcaption></figcaption></figure></div>

<table><thead><tr><th width="134.6666259765625">버튼</th><th>설명</th></tr></thead><tbody><tr><td><img src="/files/TsJPElMvV3xJoGH9mqFU" alt=""></td><td>트랙의 활성화 여부 설정<br>(비활성화 시 에디터 및 런타임 환경 모두 재생되지 않습니다.)</td></tr><tr><td><img src="/files/IAA1k2Jm7K8ajou0huxE" alt=""></td><td>트랙 편집 잠금</td></tr></tbody></table>

트랙을 선택한 상태에서 F2 키를 눌러 트랙 이름을 변경할 수 있습니다.

<div align="left"><figure><img src="/files/dOzHb1hzSdVyA45p3Dac" alt=""><figcaption></figcaption></figure></div>

트랙을 우클릭하면 표시되는 메뉴에서 잘라내기, 복사, 붙여넣기, 복제, 삭제 등의 작업을 수행할 수 있습니다.

<div align="left"><figure><img src="/files/6C1alq0yLyNbe2B8iINQ" alt=""><figcaption></figcaption></figure></div>

### 타임라인

<figure><img src="/files/iQsyLIqExKoWWeQbKu52" alt=""><figcaption></figcaption></figure>

타임라인은 트랙에 배치된 키프레임과 섹션, 마커를 시간 순서에 따라 시각적으로 표시하는 영역입니다. 사용자는 요소를 이동하거나 길이를 조정하여 액션의 타이밍과 흐름을 편집할 수 있습니다.

타임라인에서 스크러버 위치에 해당하는 섹션 및 키프레임의 연출이 뷰포트에 미리보기로 표시됩니다.

스크러버의 바탕에 주황색으로 표시되는 영역은 하나의 프레임을 의미합니다. 타임라인을 확대하면 시간 축은 길어지지만, 이 영역은 항상 동일하게 한 프레임 단위를 나타냅니다. 스크러버는 해당 프레임 내에서의 현재 위치를 표시합니다.

<figure><img src="/files/KnY4mQncONwabay0ZfPi" alt=""><figcaption></figcaption></figure>

타임라인에서 원하는 구간을 빠르게 확인하려면 **Ctrl 키를 누른 상태에서 시간축 위를 좌클릭으로 드래그**하면 됩니다. 드래그한 시작 지점부터 끝 지점까지가 하나의 범위로 선택되며, 해당 구간을 중심으로 작업하거나 확인할 수 있습니다. 긴 타임라인에서 특정 액션시퀀스 구간만 집중해서 보고 싶을 때 유용하며, 넓게 선택한 뒤 점점 범위를 줄여가면 원하는 위치를 더 빠르게 찾을 수 있습니다.

<figure><img src="/files/6rsPRou2F4V9fTeWvSqF" alt=""><figcaption></figcaption></figure>

타임라인의 빈 영역을 클릭한 상태로 드래그하면 선택 영역이 표시되며, 드래그를 종료하면 영역 안에 포함된 섹션, 키프레임, 마커 등의 요소가 한 번에 다중선택됩니다.

<figure><img src="/files/AjETrag9ewXFm8HNzlhZ" alt=""><figcaption></figcaption></figure>

#### 섹션

<div align="left"><figure><img src="/files/VE18UrXCO2RDI9r6A5sR" alt=""><figcaption></figcaption></figure></div>

섹션은 키프레임이나 마커와 달리 추가할 수 없으며, 트랙당 하나의 섹션으로 고정됩니다.

섹션의 중앙 영역을 드래그하면 위치를 이동할 수 있고, 가장자리 영역을 드래그하면 길이를 조절할 수 있습니다.

#### 키프레임

<div align="left"><figure><img src="/files/18EmOVTm7NQQcBfNXsS8" alt=""><figcaption></figcaption></figure></div>

키프레임 타입의 트랙에서는 타임라인에서 마우스 휠 버튼 클릭 또는 Ctrl + 좌클릭을 통해 키프레임을 추가할 수 있습니다.

키프레임을 드래그하여 위치를 변경할 수 있습니다.

키프레임은 인접한 키프레임 사이의 시간을 조절할 수 있는 키 바 영역이 제공되며, 키 바를 드래그하여 이웃한 키프레임의 위치와 간격을 직관적으로 조정할 수 있습니다.

#### 마커

<div align="left"><figure><img src="/files/C2bcoDcyrQzzi1M8mys1" alt=""><figcaption></figcaption></figure></div>

이벤트 트랙이나 콜리전 트랙에서는 타임라인에서 마우스 휠 버튼 클릭 또는 Ctrl + 좌클릭을 통해 마커를 추가할 수 있습니다.

마커를 드래그하여 위치를 변경할 수 있습니다.

추가된 마커는 각각 고유한 key 값을 가지며, 해당 key는 스크립트 이벤트를 연결하여 특정 시점의 동작을 트리거하는 데 사용됩니다.

#### **레이어바**

<div align="left"><figure><img src="/files/1guOasFP3cMQ2nkFOxBS" alt=""><figcaption></figcaption></figure></div>

키프레임이나 마커가 존재하는 경우 레이어바가 표시되며, 레이어바는 해당 레이어에 포함된 모든 키프레임 또는 마커의 시작과 끝을 기준으로 생성되어 전체 구간의 위치와 길이를 시각적으로 나타냅니다.

레이어바의 중앙 영역을 드래그하면 위치를 이동할 수 있고, 가장자리 영역을 드래그하면 길이를 조절할 수 있습니다.

### 트랙 프로퍼티

<div align="left"><figure><img src="/files/dW37L3W7SskOFNBqxN2H" alt=""><figcaption></figcaption></figure></div>

트랙 프로퍼티는 선택한 요소의 속성을 확인하고 편집할 수 있는 영역입니다.

선택 대상에 따라 표시되는 정보가 달라지며, 트랙을 선택하면 트랙 설정이, 키프레임을 선택하면 해당 키프레임의 속성이 표시됩니다. (섹션을 선택하면 트랙을 선택한 것으로 간주됩니다.)

## 단축키

<table><thead><tr><th width="321.33343505859375">단축키</th><th>기능</th></tr></thead><tbody><tr><td>Ctrl + S</td><td>저장</td></tr><tr><td>Ctrl + Z</td><td>Undo</td></tr><tr><td>Ctrl + Y</td><td>Redo</td></tr><tr><td>Spacebar</td><td>재생 / 일시정지</td></tr><tr><td>(타임라인에서) Ctrl + 마우스 휠 업/다운</td><td>타임라인 줌 인 / 아웃</td></tr><tr><td>(타임라인에서) 마우스 우클릭 드래그</td><td>타임라인 가로축 이동</td></tr><tr><td>(타임라인 시간축에서)<br>Ctrl + 좌클릭 드래그</td><td>드래그한 시작 지점부터 끝 지점까지의 구간을 기준으로 타임라인 확대</td></tr><tr><td>F</td><td>재생 길이에 맞춰 타임라인을 화면에 채우기</td></tr><tr><td>(트랙 선택 상태에서) Ctrl + X</td><td>트랙 잘라내기</td></tr><tr><td>(트랙 선택 상태에서) Ctrl + C</td><td>트랙 복사</td></tr><tr><td>Ctrl + V</td><td>트랙 붙여넣기</td></tr><tr><td>(트랙 선택 상태에서) Ctrl + D</td><td>트랙 복제</td></tr><tr><td>(트랙 선택 상태에서) F2</td><td>트랙 이름 변경</td></tr><tr><td>(트랙 또는 키프레임 선택 후) Delete</td><td>삭제</td></tr><tr><td>(키프레임/마커 타입의 트랙에서)<br>마우스 휠 버튼 클릭 또는 Ctrl + 좌클릭</td><td>타임라인에 키프레임 추가</td></tr><tr><td>(키프레임/마커 타입의 트랙을 선택한 상태에서) Enter</td><td>스크러버가 위치한 타임라인에 키프레임 추가</td></tr><tr><td>(Shift 또는 Ctrl) +<br>(키프레임 또는 섹션 클릭)</td><td>타임라인내 키프레임, 섹션 다중 선택</td></tr><tr><td>(Shift 또는 Ctrl) + (트랙 클릭)</td><td>트랙 다중 선택</td></tr></tbody></table>


---

# 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/manual/studio-manual/game-development/actionsequence/actionsequence-interface.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.
