스위처 연동
비디오 스위처와 Tally Node 시스템을 연동하여 카메라 Tally 정보를 자동으로 수집하고 리시버에 표시합니다. Blackmagic ATEM, OBS Studio, vMix, OSEE 등 다양한 스위처를 지원하며 2개 슬롯을 통해 다중 스위처 환경을 구성할 수 있습니다.
지원 스위처#
Tally Node v2는 다음 4종류의 비디오 스위처를 지원합니다.
| 스위처 | 기본 포트 | 전송 방식 | 특이사항 |
|---|---|---|---|
| ATEM | 9910/UDP | Blackmagic 프로토콜 | Blackmagic Design ATEM Mini/Television Studio 등 |
| OBS | 4455/WebSocket | WebSocket 5.x | 비밀번호 지원, OBS WebSocket 5.x 필수 |
| vMix | 8099/TCP | XML → SUBSCRIBE TALLY | Web API 활성화 필요, PING 3초 간격 keep-alive |
| OSEE | 52381/UDP | 바이너리 프로토콜 | OSEE 전용 프로토콜 |
연결 절차#
ATEM 연결#
- 1Switcher 페이지 접속브라우저에서
http://[master-ip]/switcher열기 - 2Slot 1 Configure 버튼 클릭
- 3다음 설정 입력
- Type:
ATEM - IP: 스위처 IP 주소 (예:
192.168.1.100) - Port:
9910(기본값) - Max Channels: 사용할 채널 수 (1–20, 기본 8)
- Interface:
Auto또는 특정 인터페이스
- Type:
- 4Save 버튼 클릭
- 5연결 상태 확인Connected / Disconnected 표시로 확인
- ATEM Television Studio Series
- ATEM Mini Series
- ATEM Constellation Series
OBS 연결#
- 1OBS Studio에서 WebSocket 서버 활성화
- 파일 → 설정 → WebSocket 서버
- 포트:
4455 - 비밀번호 설정 (필수 권장)
- 2Switcher 페이지에서 Slot 1 Configure 클릭
- 3다음 설정 입력
- Type:
OBS - IP: OBS 실행 PC의 IP 주소
- Port:
4455 - Password: WebSocket 비밀번호
- Max Channels: 채널 수
- Type:
- 4Save 버튼 클릭
vMix 연결#
- 1vMix에서 Web API 활성화
- Settings → Web API → Enable
- 포트:
8099(기본값)
- 2Switcher 페이지에서 Slot 1 Configure 클릭
- 3다음 설정 입력
- Type:
VMIX - IP: vMix 실행 PC의 IP 주소
- Port:
8099 - Max Channels: 채널 수
- Type:
- 4Save 버튼 클릭
OSEE 연결#
- 1Switcher 페이지에서 Slot 1 Configure 클릭
- 2다음 설정 입력
- Type:
OSEE - IP: OSEE 스위처 IP 주소
- Port:
52381 - Max Channels: 채널 수
- Type:
- 3Save 버튼 클릭
- 4연결 건강 상태 확인
- Active: 패킷 수신 중 (녹색 점)
- Timed Out: 패킷 수신 없음 (적색 점)
다중 스위처 구성#
Tally Node는 2개 슬롯을 통해 다중 스위처 환경을 지원합니다.
슬롯 구조#
| 슬롯 | 용도 | 색상 |
|---|---|---|
| Slot 1 | Primary (기본) | Cyan (청록색) |
| Slot 2 | Secondary (보조) | Rose (장미색) |
Slot 2 활성화#
- 1Slot 2 카드 토글 ONSwitcher 페이지에서 Slot 2 카드의 토글 스위치 ON
- 2Slot 2 Configure 버튼 클릭
- 3Slot 2용 스위처 설정위 절차와 동일하게 설정
- 4Save 버튼 클릭
슬롯별 Max Channels (채널 수)#
Max Channels는 각 슬롯에 적용되는 설정입니다. 슬롯에 연결된 스위처가 제공하는 카메라 채널 수를 지정하며, 이 값이 해당 슬롯에서 꺼낼 수 있는 카메라 소스의 범위(Cam 1 ~ Cam N)를 결정합니다.
| 항목 | 값 |
|---|---|
| 적용 단위 | 슬롯 (Slot 1, Slot 2 각각 독립) |
| 범위 | 1–20 |
| 기본값 | 8 |
| 의미 | 그 슬롯이 Cam 1 ~ Cam N 까지의 채널을 제공 |
- 각 슬롯의 Configure 대화상자에서 설정합니다 (Type/IP/Port 와 같은 슬롯 설정의 일부).
- Slot 1과 Slot 2는 서로 다른 Max Channels 값을 가질 수 있습니다.
카메라 매핑#
카메라 매핑은 슬롯 설정(위) 이후의 별도 단계입니다. 앞서 구성한 슬롯(들)을 재료로 삼아 고정된 1–20 개의 표시 위치(P1–P20) 데이터를 만듭니다. 각 위치 Pn 은 어떤 슬롯의 어느 카메라 소스를 표시할지 지정하고, 최종적으로 해당 위치에 대응하는 리시버(camera_id)가 켜집니다.
매핑 개념#
- 매핑 테이블은 항상 20개 위치(P1–P20)로 고정입니다.
- 각 위치에 Slot 1 또는 Slot 2의 카메라 번호를 배정하거나, 빈칸(Blank)으로 둘 수 있습니다.
- 슬롯의 Max Channels 가 8이면 그 슬롯에서는 Cam 1–8 까지만 선택할 수 있습니다.
예시:
- P1 ← Slot 1 / Cam 1
- P2 ← Slot 1 / Cam 2
- P9 ← Slot 2 / Cam 1 (두 번째 스위처의 첫 카메라)
매핑 절차#
- 1P1–P20 버튼 클릭Camera Mapping 영역에서 위치 버튼 중 하나 클릭
- 2소스 선택 모달에서 항목 선택
- Slot 1: 1 ~ (Slot 1 Max Channels) 카메라 번호 (Cyan 색상)
- Slot 2: 1 ~ (Slot 2 Max Channels) 카메라 번호 (Rose 색상)
- Blank: 매핑 해제
- 3원하는 카메라 번호 클릭
- 4Save Mapping 버튼 클릭
| 위치 버튼 색상 | 의미 |
|---|---|
| Cyan | Slot 1 카메라 매핑됨 |
| Rose | Slot 2 카메라 매핑됨 |
| 회색 점선 | 미매핑 (Blank) |
고급 설정#
인터페이스 바인딩#
다중 NIC 환경에서 특정 네트워크 인터페이스를 강제할 수 있습니다.
WiFi 으로 vMix 연결, Ethernet 으로 ATEM 연결 등 서로 다른 내부망에서 동작하는 스위처 2개를 연결할 수 있습니다.
| Interface 값 | 의미 |
|---|---|
| Auto | 시스템 자동 선택 (기본) |
| Ethernet | 이더넷 인터페이스만 사용 |
| WiFi | WiFi 인터페이스만 사용 |
스위처와 직접(1:1) 연결#
Master를 공유기 없이 스위처에 직접 연결할 수 있습니다. 직결 링크에는 DHCP가 없으므로 Master 이더넷에 스위처 대역의 고정 IP를 설정해야 합니다.
- 스위처 IP 확인·설정 (예: ATEM 기본값 192.168.10.240)
- Master 이더넷 고정 IP 설정 — 자세한 절차는 네트워크 연결의 스위처와 직접(1:1) 연결 참조
- Switcher 페이지 슬롯에 스위처 IP 입력
Update Speed (상태 폴링 간격)#
Update Speed는 웹 대시보드가 장치 상태를 다시 가져오는 주기입니다. System 메뉴에서 설정합니다 (웹 UI 참조). Switcher 페이지 상단의 “Settings changes reflect after up to N s” 안내가 이 값으로 결정됩니다.
| 모드 | 간격 | 비고 |
|---|---|---|
| Fast | 500 ms (0.5초) | 네트워크 사용량 높음 |
| Normal | 1000 ms (1초) | — |
| Slow | 2000 ms (2초) | 기본값 |
| Eco | 5000 ms (5초) | 최소 트래픽 |
재연결#
연결이 끊어진 경우 Reconnect 버튼으로 즉시 재연결을 시도할 수 있습니다.
- Slot 1/Slot 2별 독립 재연결
- 연결 실패 시 자동 재시도 없음 (수동 재연결 필요)