Skip to content

문제 해결 ​

음성 인식이 작동하지 않아요 ​

  1. API 키 확인: 설정 → API 키 탭에서 OpenAI API 키가 "활성화됨" 상태인지 확인하세요
  2. 마이크 권한: OS 설정에서 앱의 마이크 접근 권한을 허용했는지 확인하세요
  3. 마이크 선택: 설정 → 음성 인식 탭에서 올바른 마이크가 선택되어 있는지 확인하세요

OBS에 연결되지 않아요 ​

  1. OBS Studio가 실행 중인지 확인하세요
  2. OBS → 도구 → WebSocket 서버 설정에서:
    • "WebSocket 서버 활성화"가 체크되어 있는지 확인
    • 포트 번호가 앱 설정과 같은지 확인 (기본: 4455)
    • 비밀번호를 설정했다면 앱에도 같은 비밀번호를 입력

VTube Studio에 연결되지 않아요 ​

  1. VTube Studio가 실행 중인지 확인하세요
  2. VTube Studio → 설정 → API에서 API가 활성화되어 있는지 확인하세요
  3. 처음 연결할 때 VTube Studio에 인증 팝업이 뜹니다 — 반드시 승인을 눌러주세요

AI가 아무 반응이 없어요 ​

  1. 음성 인식이 켜져 있는지 확인하세요 (사이드바 버튼이 빨간색 "음성 인식 중지" 상태여야 합니다)
  2. 활동 피드에 "음성" 항목이 뜨는지 확인하세요 — 뜨지 않으면 마이크가 제대로 인식되지 않는 것입니다
  3. 연출 모드가 "소극적"이면 "게임 화면으로 전환해" 같은 명확한 명령만 처리합니다 — "적극적" 모드로 바꿔보세요

쿨다운 때문에 동작이 안 돼요 ​

사이드바의 쿨다운 패널에서 현재 활성화된 쿨다운을 확인하세요.

쿨다운 패널 — x 버튼으로 개별 초기화, ↺ 버튼으로 전체 초기화

  • 개별 항목의 x 버튼으로 특정 쿨다운만 바로 해제할 수 있습니다
  • ↺ 버튼으로 모든 쿨다운을 한꺼번에 해제할 수 있습니다
  • 쿨다운이 너무 길다면 설정 → 리소스 관리에서 시간을 줄여보세요

설정을 바꿨는데 적용이 안 돼요 ​

  • 대부분의 설정은 바꾸는 즉시 적용됩니다
  • 단축키: 바로 적용 (재시작 불필요)
  • API 키, 연결 정보 변경: 앱을 재시작해야 할 수 있습니다