vMix 연동

방송 제작을 위해 vMix로 실시간 자막을 전송하세요.

개요

방송 제작을 위해 vMix로 실시간 자막을 전송하세요. Maestra는 vMix와 동일한 컴퓨터에서 실행되며 실시간 자막을 vMix 타이틀 입력으로 보냅니다.

시작하기 전에

• Google Chrome을 사용하고 최신 버전으로 유지하세요.
• vMix가 실행 중이고 vMix Web Controller가 활성화되어 있는지 확인하세요.
• vMix와 동일한 컴퓨터에서 동일한 브라우저로 Maestra를 여세요.

설정 방법

1. Maestra Live가 실행 중인 동일한 컴퓨터에서 vMix를 실행해야 합니다.
2. vMix에서 자막을 표시할 이 타이틀 템플릿을 다운로드하세요. Add Input > Title/XAML으로 이동하여 이 타이틀 템플릿을 vMix로 가져오세요. Input Select 창의 오른쪽 상단에서 Browse...를 클릭하고 다운로드한 타이틀 템플릿 파일을 선택하세요. OK를 클릭하세요.
3. vMix에서 Settings > Web Controller로 이동하여 웹 컨트롤러를 활성화하는 체크박스를 선택하세요.
4. 포트를 설정하거나 기본값을 사용하세요.
5. "vMix Web Site Address"를 복사하여 Maestra에 붙여넣으세요.
6. 선택적으로 더 매끄러운 환경을 위해 Maestra Companion App을 다운로드하세요. 설치하여 실행한 뒤 vMix 채널 설정에서 활성화하고 페이지를 새로 고치면 vMix에서 자막을 즐길 수 있습니다.

문제 해결

Maestra 실시간 세션에서 vMix로 자막이 전달되지 않는 경우, 이 체크리스트를 순서대로 진행하세요. 각 단계는 Web Controller 설정과 Chrome 네트워크 권한부터 방화벽, 포트, vMix 자막 템플릿에 이르기까지 흔한 원인을 하나씩 배제합니다. 화면에서 자막이 업데이트되기 시작하면 즉시 멈추세요.

체크리스트

1. 기본 사항 확인
   • Maestra를 사용하는 브라우저와 동일한 컴퓨터에서 vMix Web Controller를 실행하세요.
   • 채널이 올바른 vMix URL(기본값 http://localhost:8088)을 가리키고 자막 타이틀 또는 템플릿 GUID가 일치하는지 확인하세요.
2. Web Controller 보안 옵션 검토
   • Allow software on this computer access without login을 체크 상태로 유지하세요.
   • Enable enhanced security on Web and TCP API는 체크 해제 상태로 두세요.
   • Restrict access to LAN only는 체크 해제 상태로 두세요.
3. Chrome에서 로컬 네트워크 액세스 활성화
   • chrome://settings/content/all로 이동한 후 live.maestra.ai를 검색하여 선택하세요(또는 자물쇠 아이콘을 누른 다음 사이트 설정 이용).
   • 로컬 네트워크 액세스를 허용으로 설정하고 Maestra를 다시 로드한 후 재시도하세요.
4. 네트워크 접근성 확인
   • 해당 컴퓨터에서 아무 브라우저로 Web Controller URL(예: http://localhost:8088)을 여세요.
   • 로드되지 않거나 느린 경우, 먼저 그 문제를 해결하세요. vMix를 시작하고 포트를 수정하며 방화벽을 차단 해제하세요.
5. 다른 포트 시도
   • 8088이 계속 실패하면 vMix Web Controller를 사용되지 않는 높은 포트(예: 2025)로 변경하고 Maestra의 URL을 업데이트한 후 다시 테스트하세요.
   • 이렇게 하면 흔히 사용되는 포트에 연결된 기업 보안 필터나 오래된 리스너를 우회할 수 있는 경우가 많습니다.
6. 기업 또는 VPN 차단 배제
   • HTTPS 페이지가 http://localhost에 접근하는 것을 막을 수 있는 VPN, 엔드포인트 방화벽 또는 백신을 일시적으로 연결 해제하세요.
   • 자막이 작동하기 시작하면 vMix와 브라우저를 허용 목록에 추가한 후 보안 도구를 다시 활성화하세요.
7. vMix 템플릿 검증
   • Title Designer에서 WebCaptionerCaptions 필드가 존재하고 GUID가 Maestra 설정과 일치하는지 확인하세요.
   • vMix에서 해당 필드를 수동으로 편집하여 화면에서 업데이트되는지 확인하세요.
8. 브라우저 점검
   • DevTools를 연 다음 Network 탭으로 이동하여 채널을 활성화하고 SetText 요청을 관찰하세요.
   • 브라우저가 Mixed Content, Private Network Access 또는 CORS를 표시하는지, 아니면 요청이 전혀 전송되지 않는지 확인하세요.
9. 혼합 콘텐츠 또는 사설 네트워크 경고 해결
   • Chrome, Edge 또는 Brave: chrome://flags/#block-insecure-private-network-requests를 비활성화한 후 다시 시작하세요.
   • Safari: 테스트하는 동안 개발 메뉴에서 Disable Cross-Origin Restrictions를 켜세요.
   • Firefox: network.websocket.allowInsecureFromHTTPS를 true로 설정하고 HTTPS 전용 모드가 꺼져 있는지 확인하세요.
10. 결과 모니터링
    • 자막이 실행되는 동안 DevTools를 열어 두세요. 요청은 성공한 것처럼 보이지만 텍스트가 업데이트되지 않으면 Network 항목과 vMix 미리보기의 스크린샷을 캡처하세요.
    • 지원팀에 문의하기 전에 타임스탬프, 브라우저 버전, 운영 체제, 콘솔 오류를 수집하세요.

여전히 해결되지 않나요?

관련 문서

• Zoom 연동
• Microsoft Teams 연동
• OBS Studio 연동
• Google Meet 연동