프로젝트 불러오기 & 저장¶
이 문서는 VoiceScriptPlayer에서 프로젝트를 불러오고, 저장하며, 관리하는 방법을 설명합니다.
1. 프로젝트 불러오기¶
기존에 만든 프로젝트는 메인 화면의 프로젝트 목록(타일 형식) 에서 불러올 수 있습니다.
에디터가 실행 중일 때는 새 프로젝트를 열 수 없으며,
먼저 에디터를 닫은 뒤 홈 화면으로 돌아가야 합니다.
🔹 불러오기 방법¶
- 에디터 창을 닫고 홈 화면으로 이동합니다.
- 홈 화면의 프로젝트 목록(타일) 에서 열고자 하는 프로젝트를 찾습니다.
- 해당 프로젝트의 편집 버튼을 누르면 자동으로 열립니다.
- 최근 수정한 프로젝트는 상단의 “최근 수정한 리스트” 에도 표시됩니다.
⚠️ 주의:
VoiceScriptPlayer는 동시에 여러 프로젝트를 열 수 없습니다.
현재 편집 중인 프로젝트를 닫은 뒤에만 다른 프로젝트를 열 수 있습니다.💡 팁:
프로젝트는 자동 저장되며, 수동으로 삭제하지 않는 한 목록에 계속 표시됩니다.
제목, 태그, 설명은 홈 화면에서 바로 수정할 수 있습니다.
2. 프로젝트 저장¶
VoiceScriptPlayer는 작업 도중 언제든지 저장할 수 있으며,
자동 저장 기능도 지원합니다.
| 저장 방식 | 설명 |
|---|---|
| 저장 (Ctrl + S) | 현재 프로젝트 상태를 즉시 저장합니다. |
💡 팁:
리소스 파일은 프로젝트 저장과 관련 없이 적용됩니다.
3. 리소스 관리¶
VoiceScriptPlayer에서는 리소스를 “탐색기” 형태로 한 번에 관리하지 않고,
각 리소스 유형별로 전용 탭(Tab) 에서 개별적으로 관리합니다.
🔹 리소스 탭 구조¶
프로젝트 상단에는 다음과 같은 리소스 관리 탭이 있습니다.
| 탭 이름 | 설명 |
|---|---|
| 🎵 사운드 | 오디오 파일(.mp3, .wav)을 불러오고 자막 생성 및 편집, 번역, 음성 생성(TTS) 등을 수행할 수 있습니다. |
| 🎬 비디오 | 영상 파일(.mp4, .mov)을 추가하고 자막 생성, 번역, 동기화 편집을 할 수 있습니다. |
| 🧍 Live2D | 캐릭터 모델(.model3.json) 및 모션 파일을 불러와 배치하고 설정합니다. |
| 🧩 UI | 버튼, 이미지, 텍스트 등 사용자 인터페이스 구성 요소를 배치 및 편집합니다. |
| 💬 스크립트 | 변수, 트리거, 조건문 등을 사용해 상호작용 동작을 정의하고 제어합니다. |
| ✏️ 스트로크 | 타임라인 기반 스트로크 패턴을 불러오고 설정합니다. |
| ✨ 특수 이벤트 | 미리 정의된 특수 이벤트들을 제공합니다. |
| 📦 리소스 관리 | 프로젝트 전반에 사용되는 공용 리소스(변수, 이미지, Live2D, 번역 사전 등) 을 통합 관리합니다. |
🔹 리소스 추가 방법¶
- 원하는 리소스 탭(예: 사운드, 비디오, Live2D)으로 이동합니다.
- 상단의 [가져오기] 버튼을 이용해 파일을 불러옵니다.
- 리소스가 해당 탭 목록에 등록되며, 프로젝트 폴더 내 알맞은 위치에 자동 복사됩니다.
⚙️ 참고:
리소스는 각각의 탭에서 개별적으로 관리되며,
추가된 파일은 자동으로 프로젝트 폴더(Video/,UI/,Trigger/등)에 정리됩니다.
경로를 직접 입력할 필요가 없습니다.
🔹 리소스 수정 및 삭제¶
- 각 탭에서 등록된 리소스를 선택하면 우측 패널에 세부 설정이 표시됩니다.
- 설정을 변경하면 실시간으로 반영되며, 별도의 저장 과정 없이 자동 저장됩니다.
- 필요 없는 리소스는 [삭제] 버튼으로 제거할 수 있습니다.
(실제 파일은 프로젝트 폴더에서 자동 정리됩니다.)
💡 팁:
각 리소스 탭은 독립적으로 작동하므로,
한 리소스를 수정해도 다른 탭에는 영향을 주지 않습니다.
예를 들어, 사운드 편집 중이라도 UI 탭의 버튼 구성은 그대로 유지됩니다.
4. 내보내기 & 공유¶
VoiceScriptPlayer에서는 프로젝트를 다른 사용자에게 배포하거나,
편집이 불가능한 재생 전용 형태로 게시할 수 있습니다.
📁 프로젝트 게시 열기¶
프로젝트 게시 기능은 상단 메뉴의 [파일 → 프로젝트 게시] 에서 실행할 수 있습니다.
이 항목을 클릭하면 게시 설정 창이 열립니다.
🗂️ 게시 설정 창¶
게시 창에서는 다음 항목을 설정할 수 있습니다:
| 항목 | 설명 |
|---|---|
| 위치 고르기 | 게시할 폴더 경로를 선택합니다. |
| 프로젝트 포함 여부 | 게시에 포함할 리소스를 선택합니다. 오른쪽 화살표(→)로 제외, 왼쪽 화살표(←)로 포함할 수 있습니다. |
게시를 완료하면 선택한 폴더 내에
편집이 불가능하고 재생만 가능한 형태의 프로젝트 폴더가 생성됩니다.
⚙️ 참고:
게시 시 프로젝트는 압축되지 않습니다.
내부 구조(Video/,UI/,Trigger/등)는 그대로 유지되며,
VoiceScriptPlayer Player에서만 실행 가능합니다.
🎧 저작권이 있는 음원 제외¶
게시 과정에서 저작권이 민감한 오디오 파일(예: 상업용 BGM, 음성 등)은
“프로젝트 포함 여부” 목록에서 제외할 수 있습니다.
- 제외된 음원은 게시 폴더에 복사되지 않습니다.
- 재생 시 사용자가 직접 해당 파일의 위치를 지정하여 로드할 수 있습니다.
- 이를 통해 저작권이 있는 음원을 보호하면서도 프로젝트 배포가 가능합니다.
💡 팁:
게시 전 저작권 관련 리소스를 정리하면
다른 사용자가 프로젝트를 열 때 오류 없이 바로 실행할 수 있습니다.
📦 내보내기 옵션 요약¶
| 기능 | 설명 |
|---|---|
| 프로젝트 게시 | 폴더 형태로 내보내며, 편집은 불가능하고 재생만 가능 |
| 프로젝트 내보내기 | 전체 프로젝트를 복사(또는 백업)하는 일반 내보내기 |
| 플레이어 빌드 내보내기 | 실행 파일 형태로 빌드하여 완전 독립 실행 가능 |
5. 백업 & 버전 관리¶
프로젝트 안정성을 위해 주기적인 백업과 버전 관리를 권장합니다.
- 권장 폴더:
Documents/VoiceScriptPlayer/Projects/폴더 내에
각 프로젝트를 개별 폴더로 정리하세요.