# 컴포지션을 Lottie로 내보내기
After Effects 컴포지션을 Lottie로 렌더링하고, 선택적으로 LottieFiles 워크스페이스에 업로드합니다. 모두 After Effects 안에서 진행됩니다.

## 접근 방법

1. After Effects에서 LottieFiles 플러그인을 엽니다(**Window > Extensions > LottieFiles**).
2. 상단 탭 바에서 **Export**를 클릭합니다.

Export 탭은 현재 After Effects 프로젝트의 모든 컴포지션 목록으로 열립니다.

## 시작하기 전에

- After Effects 프로젝트에 컴포지션이 하나 이상 있습니다.
- LottieFiles에 로그인되어 있습니다. 렌더링 자체는 로컬에서 작동하지만, 워크스페이스에 업로드하려면 로그인이 필요합니다. {/* [needs review] 로그인 없이 렌더링-only가 지원되는지 확인 */}
- 좋은 결과를 위해 렌더링 전에 [Lottie용 컴프 준비하기](/ko/integrations/after-effects/04_preparing-comps)를 읽어 보세요. 렌더링 결과가 얼마나 깔끔하게 나오는지 결정하는 레이어와 컴프 선택을 다룹니다.

## 단계

### 1. 내보낼 컴포지션 찾기

Export 탭에는 프로젝트의 모든 컴포지션이 표시됩니다. 상단 검색 바를 사용해 목록을 좁히세요. 입력하는 동안 컴포지션 이름으로 필터링됩니다.

{
  // TEMP_IMAGE_HIDDEN: 임시 릴리스에서는 숨김. 시각 QA 때 이 소스 위치에 이미지를 복원하세요.
  false ? (

  <Image
        src="/images/screenshots/ae-export-compositions-list.webp"
        alt="Export tab with the search bar, composition list, and 렌더링 버튼 highlighted"
        caption="렌더링할 컴포지션을 찾고 선택합니다"
        zoom
        variant="default"
      />
  ) : null
}

### 2. 하나 이상의 컴포지션 선택

- **Single 렌더링** — 컴포지션 이름 옆의 렌더링 아이콘을 클릭합니다.
- **일괄 렌더링** — 원하는 각 컴포지션 옆 체크박스를 선택하거나 상단의 **Select all** 체크박스를 사용합니다. **Shift**를 누른 채 클릭하면 범위를 선택할 수 있습니다.

선택한 컴포지션 수가 목록 상단에 표시되고, 하단의 전역 렌더링 버튼을 사용할 수 있게 됩니다.

### 3. (선택) Render Settings 구성

컴포지션 행에서 **Render Settings**를 열면 하나의 컴포지션을 바꿀 수 있습니다. 목록 헤더의 설정 액션을 사용하면 모든 컴포지션 또는 현재 선택한 컴포지션을 바꿀 수 있습니다.

모달에서는 메타데이터, 글꼴 내보내기, 표현식 변환, 이미지 에셋, 숨겨진 레이어, 가이드 레이어를 설정합니다. 전체 목록은 [Export 패널 컨트롤](/ko/integrations/after-effects/06_export/export-panel-controls#render-settings)을 참고하세요.

### 4. 렌더링 실행

**렌더링**을 클릭해 시작합니다. 렌더링은 디스크의 AEP를 읽으므로, 플러그인이 먼저 열린 프로젝트에 저장되지 않은 변경 사항이 있는지 확인합니다.

- 저장되지 않은 변경 사항이 없으면 저장하거나 확인 메시지를 표시하지 않고 렌더링을 시작합니다.
- 저장되지 않은 변경 사항이 있고 **Auto-save**가 켜져 있으면 AEP를 저장한 뒤 렌더링을 시작합니다.
- 저장되지 않은 변경 사항이 있고 **Auto-save**가 꺼져 있으면 렌더링 전에 **Save changes to AEP file** 안내가 나타납니다.

**Auto-save**는 계정 아바타 메뉴의 **Settings**에서 바꿀 수 있으며 변경 즉시 적용됩니다.

플러그인은 **렌더링 큐** 보기(`/compositions/render`)로 이동하고 각 컴포지션의 진행률을 보여줍니다. 각 컴포지션은 After Effects 백그라운드에서 렌더링되므로 AE UI는 반응성을 유지합니다.

{
  // TEMP_IMAGE_HIDDEN: 임시 릴리스에서는 숨김. 시각 QA 때 이 소스 위치에 이미지를 복원하세요.
  false ? (

  <Image
        src="/images/screenshots/ae-export-render-queue-progress.webp"
        alt="렌더링 큐 showing completed, rendering, and queued composition cards"
        caption="렌더링 큐 진행률"
        zoom
        variant="default"
      />
  ) : null
}

### 5. 결과 저장 또는 업로드

렌더링이 끝나면 행에 결과 Lottie 파일과 업로드 옵션이 표시됩니다.

- **Save locally** — 렌더링된 `.lottie`(또는 `.json`) 파일이 로컬 내보내기 경로에 기록됩니다. {/* [needs review] 기본 로컬 경로 확인 */}
- **Upload to workspace** — 완료된 렌더링을 하나 이상 선택하고 upload를 클릭합니다. LottieFiles 워크스페이스에서 대상 프로젝트나 폴더를 고릅니다. **Save AEP**를 체크하면 플러그인이 Lottie와 함께 `.aep` 소스 파일도 저장할 수 있습니다(저장 공간 제한 적용 — [제한과 플랜](#limits-and-plans) 참고).

## 결과 확인

- 렌더 큐가 완료된 각 렌더링에 ✓를 표시합니다.
- 로컬 내보내기 폴더에 Lottie 파일이 있습니다.
- 업로드했다면 선택한 대상의 LottieFiles 워크스페이스에 파일이 표시됩니다.
- Lottie를 플레이어 또는 [LottieFiles Creator](/ko/creator)에서 열었을 때 기대한 대로 재생됩니다.

재생이 After Effects 미리 보기와 맞지 않으면 [Lottie 호환성](/ko/integrations/after-effects/09_lottie-compatibility) 기준표를 확인하세요. 어떤 AE 기능이 깔끔하게 변환되고 어떤 기능이 그렇지 않은지 나와 있습니다.

<span id="troubleshooting" />

## 문제 해결

이 섹션은 After Effects 플러그인 문제 해결의 통합 홈입니다. 모션 디자이너가 겪는 이슈의 약 99%가 렌더링이나 내보내기 중에 드러나므로 모두 여기에 모았습니다. 몇 가지 비내보내기 이슈(플러그인이 로드되지 않음, 로그인 stuck)는 해당 장으로 연결합니다.

### 렌더링 쪽 실패

- **렌더링 큐가 진행 없이 멈춤** — After Effects가 modal(project save prompt, RAM 경고)을 기다리고 있지 않은지 확인하세요. AE 창을 앞으로 가져오세요. AE가 막혀 있으면 플러그인은 렌더링할 수 없습니다. AE가 반응하는데도 멈춰 있다면 AE를 다시 시작하세요. {/* [needs review] 확인 */}
- **렌더링이 실패하고 행에 오류 아이콘이 표시됨** — 행에 마우스를 올려 오류 메시지를 봅니다. 가장 흔한 원인은 누락된 font, 누락된 footage, 레이어의 지원되지 않는 effect입니다([Lottie 호환성](/ko/integrations/after-effects/09_lottie-compatibility) 참고).
- **출력 Lottie가 잘못 재생됨(누락된 레이어, 깨진 전환, 잘못된 색상)** — 거의 항상 호환성 문제입니다. 사용한 특정 기능을 [Lottie 호환성](/ko/integrations/after-effects/09_lottie-compatibility) 기준표에서 확인하세요.
- **출력 Lottie가 예상보다 큼** — raster 레이어, 큰 pre-comp, 불필요한 effect가 있는지 컴프를 점검하세요. [Lottie용 컴프 준비하기](/ko/integrations/after-effects/04_preparing-comps)를 참고하세요.
- **업로드가 전송 중 네트워크 오류로 실패** — 렌더 큐에서 업로드를 다시 시도하세요. 다시 실패하면 워크스페이스에 저장 공간이 충분한지 확인하세요(업로드 UI가 남은 quota를 보여줍니다).
- **"Save AEP"가 비활성화됨** — 워크스페이스 저장 공간이 한도에 도달했거나 가까워졌습니다. 공간을 비우거나, 업그레이드하거나, **Save AEP**를 해제하고 Lottie만 업로드하세요.

### 플러그인 로딩과 로그인(Export 전용은 아니지만 검색성을 위해 여기에 둠)

- **Window > Extensions 아래에 플러그인이 보이지 않음** — [설치 > 문제 해결](../01_quickstart/installation#troubleshooting)을 참고하세요.
- **AE 환경설정에서 "Allow Scripts" 체크박스가 비활성화됨** — After Effects를 종료했다가 다시 엽니다. Windows에서는 보통 AE를 한 번 관리자 권한으로 열면 해결됩니다. {/* [needs review] Windows 관리자 실행 우회 방법 확인 */}
- **로그인이 브라우저 탭을 열지만 돌아오지 않음** — 플러그인의 로그인 흐름은 기본 브라우저로 넘겨집니다. 브라우저가 실제로 LottieFiles 로그인 페이지를 불러왔는지 확인하세요. 불러오지 않았다면 기본 브라우저를 바꿔 보세요. 로그인 후 After Effects로 돌아와 플러그인 패널에서 **Reload**를 클릭합니다.

### 이슈 보고

여기에 없는 문제가 생기면 플러그인 패널 오른쪽 위 **Help** 드롭다운으로 보고하거나 [LottieFiles community forum](https://community.lottiefiles.com)에 올리세요. 플러그인 버전(**플러그인 정보** 모달)과 After Effects 버전을 함께 적으면 분류가 훨씬 빨라집니다.

## 관련 문서

- [Lottie용 컴프 준비하기](/ko/integrations/after-effects/04_preparing-comps) — 위 문제 대부분을 예방하는 내보내기 전 체크리스트입니다.
- [Lottie 호환성](/ko/integrations/after-effects/09_lottie-compatibility) — 기능별 지원 기준표.
- [Export 패널 컨트롤](/ko/integrations/after-effects/06_export/export-panel-controls) — Export 탭의 모든 컨트롤과 역할.
