vMix 연동

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

개요

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

시작하기 전에

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

설정 방법

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

문제 해결

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

체크리스트

기본 사항 확인

Maestra를 사용하는 브라우저와 동일한 컴퓨터에서 vMix Web Controller를 실행하세요.
채널이 올바른 vMix URL(기본값 http://localhost:8088)을 가리키고 자막 타이틀 또는 템플릿 GUID가 일치하는지 확인하세요.

Web Controller 보안 옵션 검토

Allow software on this computer access without login을 체크 상태로 유지하세요.
Enable enhanced security on Web and TCP API는 체크 해제 상태로 두세요.
Restrict access to LAN only는 체크 해제 상태로 두세요.

Chrome에서 로컬 네트워크 액세스 활성화

chrome://settings/content/all로 이동한 후 live.maestra.ai를 검색하여 선택하세요(또는 자물쇠 아이콘을 누른 다음 사이트 설정 이용).
로컬 네트워크 액세스를 허용으로 설정하고 Maestra를 다시 로드한 후 재시도하세요.

네트워크 접근성 확인

해당 컴퓨터에서 아무 브라우저로 Web Controller URL(예: http://localhost:8088)을 여세요.
로드되지 않거나 느린 경우, 먼저 그 문제를 해결하세요. vMix를 시작하고 포트를 수정하며 방화벽을 차단 해제하세요.

다른 포트 시도

8088이 계속 실패하면 vMix Web Controller를 사용되지 않는 높은 포트(예: 2025)로 변경하고 Maestra의 URL을 업데이트한 후 다시 테스트하세요.
이렇게 하면 흔히 사용되는 포트에 연결된 기업 보안 필터나 오래된 리스너를 우회할 수 있는 경우가 많습니다.

기업 또는 VPN 차단 배제

HTTPS 페이지가 http://localhost에 접근하는 것을 막을 수 있는 VPN, 엔드포인트 방화벽 또는 백신을 일시적으로 연결 해제하세요.
자막이 작동하기 시작하면 vMix와 브라우저를 허용 목록에 추가한 후 보안 도구를 다시 활성화하세요.

vMix 템플릿 검증

Title Designer에서 WebCaptionerCaptions 필드가 존재하고 GUID가 Maestra 설정과 일치하는지 확인하세요.
vMix에서 해당 필드를 수동으로 편집하여 화면에서 업데이트되는지 확인하세요.

브라우저 점검

DevTools를 연 다음 Network 탭으로 이동하여 채널을 활성화하고 SetText 요청을 관찰하세요.
브라우저가 Mixed Content, Private Network Access 또는 CORS를 표시하는지, 아니면 요청이 전혀 전송되지 않는지 확인하세요.

혼합 콘텐츠 또는 사설 네트워크 경고 해결

Chrome, Edge 또는 Brave: chrome://flags/#block-insecure-private-network-requests를 비활성화한 후 다시 시작하세요.
Safari: 테스트하는 동안 개발 메뉴에서 Disable Cross-Origin Restrictions를 켜세요.
Firefox: network.websocket.allowInsecureFromHTTPS를 true로 설정하고 HTTPS 전용 모드가 꺼져 있는지 확인하세요.

결과 모니터링

자막이 실행되는 동안 DevTools를 열어 두세요. 요청은 성공한 것처럼 보이지만 텍스트가 업데이트되지 않으면 Network 항목과 vMix 미리보기의 스크린샷을 캡처하세요.
지원팀에 문의하기 전에 타임스탬프, 브라우저 버전, 운영 체제, 콘솔 오류를 수집하세요.

여전히 해결되지 않나요?

이 체크리스트를 거친 후에도 자막이 업데이트되지 않는 경우, 앱에서 지원 위젯을 열고 티켓 생성을 클릭하세요. 타임스탬프, 브라우저 버전, 운영 체제, vMix 버전, 콘솔 오류를 함께 알려주세요.