09 · 스위처 연동
스위처 연동
스위처 유형을 골라 슬롯을 구성하고 연결을 확인한 뒤, 카메라 매핑으로 점등 위치를 확정합니다. 완제품과 Free 버전 모두 사용할 수 있습니다.
완제품 · Free 버전 공통
시작하기 전에
- 04 · 네트워크 접속 완료(스위처가 도달 가능한 망)
- 스위처(또는 스위처 PC)의 IP 정보
- 스위처 쪽 사전 준비 완료(유형별 — 아래 표)
유형 선택#
| 유형 | 방식 · 기본 포트 | 연결 방향 | 스위처 쪽 준비 | 인증 |
|---|---|---|---|---|
| ATEM | UDP · 9910 | 장비 → 스위처 | 스위처 IP 고정(ATEM Software Control) | 없음 |
| OBS | WebSocket · 4455 | 장비 → OBS PC | OBS 28 이상(기본 내장·기본 켜짐), Tools → WebSocket 설정에서 포트·비밀번호 확인 | 비밀번호(선택) |
| vMix | TCP · 8099 | 장비 → vMix PC | 없음(고정 포트 상시 대기) — 방화벽 8099 인바운드 확인 | 없음 |
| OSEE | UDP · 52381 | 스위처 → 장비(수신형) | 기기에서 이 장비 IP:52381을 송신 대상으로 지정 | 없음 |
카메라 번호는 씬 목록 순서(OBS)
OBS에는 카메라 개념이 없어 씬 목록 순서로 번호를 정합니다(마지막 씬 = 카메라 1). 씬 순서를 바꾸면 번호도 바뀝니다. OBS WebSocket 5.x 전용입니다.
슬롯 구성#
- 1Configure 열기슬롯 상태 카드의 Configure 클릭 → 설정 모달 표시
- 2필드 입력Type·IP·Port(유형 선택 시 자동)·Password(OBS만)·Max Channels 입력 → 값 검증 통과
- 3Save저장 즉시 슬롯 재시작(재부팅 불필요) → 상태 카드가 다음 폴링에 갱신
- 4연결 확인Connected 배지(초록) 표시 → PGM/PVW 갱신 시작
| 필드 | 입력 |
|---|---|
| Type | ATEM / OBS / VMIX / OSEE |
| Network Interface | Auto(기본) / Ethernet / WiFi — Free 버전은 잠기고 항상 Auto |
| IP Address | 점표기 IPv4만(호스트명 불가) |
| Port | 기본 잠금, 해제 시 1~65535 |
| Password | OBS 유형에서만 표시·전송 |
| Max Channels | 1~20, 기본 8 — 실제 입력 수와 일치 권장 |
저장 거부되는 값
호스트명 IP·포트 범위 밖·알 수 없는 유형·Free에서의 Ethernet 선택은 오류 toast와 함께 거부됩니다.
- 인터페이스 지정: ATEM 케이블 직결 시에만 Ethernet으로 지정하세요(04 · 네트워크 접속 참조). 강제 지정은 해당 인터페이스가 살아 있어야 연결이 시작됩니다 — 링크 다운 시 다른 경로로 새지 않고 대기합니다.
- 슬롯 2는 카드 토글로 on/off하며(슬롯 1은 상시 활성), 끄면 해당 기여분이 클리어됩니다.
연결 확인과 재접속#
- Connected 배지·PGM/PVW는 폴링 갱신 — 주기만큼 반영이 지연될 수 있습니다.
- Reconnect 버튼으로 수동 재시작 가능. 끊기면 자동 재시도(백오프: ATEM·vMix·OSEE 1→30초, OBS 5→60초).
OSEE 연결 (방향 주의)#
OSEE만 방향이 반대입니다 — 장비가 UDP 포트를 열고 기다립니다.
- 1슬롯 구성Type OSEE · Port 52381(수신 포트) Save → 슬롯 대기 상태
- 2OSEE 기기 설정tally 송신 대상을 이 장비 IP:52381으로 지정 → 기기에서 송신 시작
- 3연결 확인첫 패킷 수신 시 Connected + Active → 15초 무패킷 시 Timed Out·OFF로 클리어(재수신 시 자동 회복)
매핑과 합산#
- 1매핑 편집20 포지션에 소스(슬롯+카메라) 배정 → 포지션당 최대 4소스, 다중 배정 가능
- 2Reset(선택)1:1 기본 매핑(포지션 N → 슬롯1 카메라 N)으로 복원
- 3Save Mapping저장 → 웹·OLED·수신기가 모두 같은 합산 상태를 표시
수신기 카메라 번호가 매핑의 소스입니다 — 번호 지정은 11 · 수신기 관리 또는 12 · 리시버 운영을 참조하세요.
- 슬롯이 Connected로 표시된다
- 스위처에서 PGM 전환 시 대시보드·수신기에 반영된다
연결 관련 증상은 문제 해결 · 통신을 참조하세요.
다음 단계
최종 수정 —
