자동 자막 ‐ 실시간 음성 인식 자막 오버레이 - auejin/vzzk-bot GitHub Wiki

자동 자막 기능은 스트리머의 음성을 실시간으로 인식하여 방송 화면에 깔끔한 자막으로 표시해 주는 편의 기능입니다. VZZK 앱 자체가 마이크 소리를 듣고 작동하므로, 복잡한 외부 프로그램 연동 없이 즉시 사용할 수 있습니다.

이렇게 활용해 보세요

방송 접근성 향상: 시청자가 볼륨을 켜기 힘든 상황(예: 대중교통 등)에서도 방송 내용을 텍스트로 쉽게 파악할 수 있어 이탈률을 줄여줍니다.
글로벌 방송 (자동 번역): 한국어로 말해도 시청자 화면에는 영어, 일본어 등 다국어 자막을 함께 띄울 수 있어 해외 시청자의 유입을 돕습니다.
게임 몰입감 증대: 게임 오디오가 커서 목소리가 묻힐 때, 혹은 스트리머 본인이 발음을 명확하게 전달하고 싶을 때 시각적인 보조 수단으로 탁월합니다.

시작하기

자동 자막 기능을 켜려면 VZZK에게 마이크 사용 권한을 허락해 주어야 합니다.

1. 마이크 권한 허용 및 설정

VZZK 콘솔에서 자동 자막 설정 메뉴로 이동합니다.
페이지 상단의 마이크 권한 요청 버튼을 누르고 접근을 허용합니다. (최초 1회)
음성을 입력받을 마이크 장치를 선택합니다. (마이크 목록이 보이지 않으면 새로고침 버튼을 누르세요)
내가 주로 말하는 언어(예: 한국어)를 인식 언어로 설정합니다.

2. 번역 설정 (선택)

외국인 시청자를 위해 자막 아래에 번역본을 함께 띄우고 싶다면 자동 번역 토글을 켭니다. 인식 언어(예: 한국어)와 번역 대상 언어(예: 영어)를 각각 선택하시면 됩니다. VZZK은 영어, 일본어, 중국어 등 10개 이상의 주요 언어 번역을 지원합니다.

[!TIP] 자동 번역 결과는 스트리머가 문장을 완전히 끝맺었을 때(인식 완료) 표시됩니다.

3. 방송 오버레이 추가 및 인식 시작

설정 페이지 상단에 있는 오버레이 URL을 복사합니다.
OBS에서 브라우저 소스를 추가하여 복사한 주소를 붙여넣습니다. (권장 크기: 너비 1920px, 높이 200px)
VZZK 앱에서 인식 시작 버튼을 누르면 마이크 아이콘이 깜빡이며 동작을 시작합니다. 이제 방송 중에 편하게 말씀하시면 자동으로 화면에 자막이 송출됩니다.

문제 해결 (FAQ)

Q. 음성이 전혀 인식되지 않습니다.

마이크 권한이 정상적으로 허용되었는지, 그리고 설정 페이지에서 올바른 마이크 장치를 선택했는지 확인해 주세요.
VZZK 화면에서 '인식 시작' 버튼을 눌러야만 인식이 진행됩니다.

Q. 오버레이에 자막이 보이지 않습니다.

OBS 브라우저 소스 속성에서 URL이 정확한지 확인하세요.
VZZK 앱이 켜져 있고 '인식 시작' 상태여야 오버레이에 데이터가 전송됩니다.

Q. 지원하지 않는 브라우저라고 뜹니다.

자동 자막은 Google Chrome, Microsoft Edge 등 Chromium 기반 환경에서 동작합니다. 만약 VZZK 앱 내부가 아닌 외부 브라우저(Firefox, Safari 등)에서 이 기능을 열려고 시도하셨다면 인식이 작동하지 않을 수 있습니다.