실행하기 (Playback Mode)¶

VoiceScriptPlayer의 실행 모드는 편집 모드와 분리된 순수 재생 전용 환경입니다.
이 모드에서는 타임라인이나 편집 도구가 모두 비활성화되고,
프로젝트의 실제 동작(사운드, Live2D, Stroke, 장치 연동 등)만 실행됩니다.

1. 실행 모드 개요¶

항목	설명
목적	완성된 프로젝트를 실제처럼 재생하거나, 장치 연동 테스트를 수행합니다.
편집과의 차이	편집 기능(선택, 이동, 편집 창 등)은 비활성화되며, 순수 재생만 가능합니다.
시작 방법	상단 툴바의 ▶ 실행 버튼 또는 `vsp://open?file=...` 형태로 실행할 수 있습니다.
종료 방법	Esc 키를 누르거나 창을 닫으면 종료됩니다.

⚙️ 참고:
실행 모드에서는 사용자의 키 입력이나 탐색 조작이 불가능하며,
모든 진행은 스크립트에 정의된 이벤트 흐름에 따라 자동으로 이루어집니다.

실행 모드 진입 시, 플레이 모드(Play Mode) 옵션을 통해
장치 사용 여부 및 제어 방식을 선택할 수 있습니다.

옵션	설명
상관없음	모든 장치 여부와 관계없이 자유롭게 재생합니다.
손만 사용	장치 출력 없이 화면과 사운드만 재생합니다.
기계 권장	장치가 연결되지 않은 경우 경고창을 표시하지만, 사용자가 계속 진행할 수 있습니다.
기계만 사용	장치가 반드시 연결되어 있어야 재생이 시작됩니다. 연결이 없으면 실행이 차단됩니다.

상황	동작
기계만 사용 모드에서 장치 미연결 시	“해당 스크립트는 장치가 연결되어야 재생할 수 있습니다.” 경고창이 표시되고 실행이 차단됩니다.
기계 권장 모드에서 장치 미연결 시	“장치 연결이 권장됩니다. 그래도 실행하시겠습니까?”라는 경고창이 표시되고, 사용자가 선택할 수 있습니다.
기계만 사용 중 장치 연결이 중간에 끊긴 경우	프로그램이 일시 정지되며, “장치를 다시 연결하고 계속 시도하세요.”라는 경고창이 나타납니다.
손만 사용 모드	장치 출력은 완전히 비활성화됩니다. Stroke, 진동 등 하드웨어 제어는 실행되지 않습니다.

💡 팁:
장치 모드 제약은 프로젝트 스크립트 내 “기기 의존형 이벤트” 존재 여부에 따라 달라집니다.
예를 들어 Stroke나 TCode 관련 동작이 포함된 경우, “기계 권장” 또는 “기계만 사용”으로 설정하는 것이 안전합니다.

실행 설정에서 “마이크 확인 창 사용” 옵션을 켜면,
플레이 시작 시 마이크 인식 여부를 확인하는 전용 창이 표시됩니다.

항목	설명
목적	음성 인식(STT)이나 반응형 이벤트 기능이 포함된 프로젝트의 정확한 작동을 보장합니다.
검사 항목	연결된 마이크 장치 목록, 입력 감도, 음성 테스트 기능
진행 방식	마이크가 정상적으로 인식될 경우에만 “확인” 버튼이 활성화되어 실행이 계속됩니다.
오류 시	마이크가 인식되지 않으면 경고창이 나타나며, 재시도 전까지 실행이 차단됩니다.

💡 참고:
마이크 인식 과정에서 오류가 발생할 경우,
SpeechRecognition 설정 문서에서 자세한 해결 방법을 확인할 수 있습니다.