이 가이드는 산업의 개념을 플랫폼에 현재 있는 객체(부케, 라인, 패키지, 파트너 계정, 노드, API)에 대응시킵니다. 이는 개념적 대응이며 산업 전용 기능이 아닙니다. 또한 파트너 계정은 위임 계정이며 격리된 테넌트가 아닙니다.
개념적 대응
패널에는 객실이나 숙박이라는 이름의 것이 없습니다. 아래 표는 어떤 객체가 어떤 역할을 하는지 보여 주며, 이어지는 장에서 그 순서대로 설정합니다.
| 내 산업에서는 | 플랫폼에서는 | 패널에서의 위치 |
|---|---|---|
| 호텔 운영자 또는 공인 파트너 | 파트너 계정(리셀러): 크레딧, 권한, 자체 라인을 가진 위임 대시보드 | Users → 리셀러 추가, 권한은 Groups에서 설정 |
| 채널 패키지 | 부케: 패키지가 부여하는 채널, 영화, 시리즈의 이름 있는 묶음 | Bouquets, Streams와 Movies / Series에서 생성 |
| 객실 또는 기기 | 라인: 패키지, 부케, 만료일, 연결 제한, 출력을 가진 하나의 액세스 | Lines → 추가, 또는 활성화 코드, 또는 Reseller API |
| 호텔 안내 영상 | VOD 카탈로그: 시즌과 에피소드가 있는 영화와 시리즈, 카테고리, 메타데이터 | Movies와 Series, 또는 VOD 인제스트 작업 |
| 라이선스를 받은 텔레비전 채널 | 실시간 채널: 소스, EPG, 출력 형식을 가진 스트림 | Streams → 실시간 스트림 추가(소스 URL 또는 RTMP 푸시) |
| 숙박 기간 | 라인의 만료일. 패키지, 크레딧 또는 API로 갱신됩니다 | 라인의 만료일과 패키지의 기간 |
| 건물 또는 동마다 노드 하나 | 스트리밍 노드: 패널에서 등록하는 엣지 서버. 현장 또는 건물당 하나 | Servers → 노드 추가(SSH로 설치) |
사전 준비
설치 전에 준비할 것.
- 시설 네트워크의 서버(Ubuntu 22.04 또는 24.04), 설치 프로그램, 객실 기기가 접근할 수 있는 주소.
- 시설이 권리를 가진 채널 피드(풀 URL 또는 RTMP), 호텔의 안내 영상, 객실 기기(Android TV 박스, MAG 또는 Enigma2 박스, 플레이어 앱이나 브라우저가 있는 스마트 TV).
- 체크인과 체크아웃 때 PMS가 HTTP API를 호출할 수 있는 기능, 또는 프런트가 패널에서 처리하는 절차.
인프라 구축
중앙 서버와 건물마다 노드.
- 중앙 서버에서 설치 프로그램을 실행합니다. 재생 기본 주소를 시설의 내부 주소로 설정해 객실이 로컬 네트워크에 머물게 합니다.
- Streams에 채널 피드를, Movies에 안내 영상을 추가하고 웹 플레이어에서 확인합니다.
- Servers에서 동 또는 건물마다 노드를 등록합니다. 패널이 SSH로 설치하고 해당 건물의 객실을 노드로 연결합니다.
- 서버에 라이선스 키를 설정합니다. 활성화는 현장에서 이루어지며 서비스는 외부 회선 없이 실행됩니다.
콘텐츠 정리
채널 패키지와 호텔 영상.
- 시설의 채널로 채널 패키지(일반 객실, 스위트, 컨퍼런스)마다 부케를 하나씩 만듭니다.
- 호텔 영상(환영, 시설, 안전)의 부케를 만들어 모든 패키지에 추가합니다.
- 객실 등급마다 부여할 부케와 기간 1일을 담은 패키지를 하나씩 만듭니다. 체크인 시 객실의 라인을 숙박 일수만큼(1박당 한 번) 갱신하고(갱신할 때마다 패키지 기간이 더해집니다), 체크아웃 시 비활성화합니다(8장).
- 텔레비전 메뉴가 잘 읽히도록 채널을 정렬하고 로고를 지정합니다.
파트너(리셀러) 설정
시설 또는 여러 시설을 운영하는 사업자를 위임 계정으로 설정합니다.
- 권한을 라인(객실)으로 한정하고 카탈로그 변경은 허용하지 않는 그룹을 만듭니다.
- 시설의 프런트 또는 사업자를 해당 그룹과 객실 패키지를 가진 리셀러로 추가합니다.
- 여러 시설을 운영하는 사업자에게는 시설마다 리셀러를 하나씩 만들고, 각각 자체 객실과 크레딧을 갖게 합니다.
객실(라인) 설정
객실마다 라인 하나, 이름은 객실 번호.
- Lines에서 객실 번호를 이름으로, 객실 등급의 패키지를 지정해 객실마다 라인을 하나씩 만듭니다.
- 최대 연결 수를 1(텔레비전 한 대) 또는 객실의 화면 수로 설정합니다.
- 네트워크가 기기에 고정 주소를 부여하는 경우 라인을 객실 기기의 주소에 묶습니다.
- 기기를 한 번만 설정합니다(라인의 자격 증명을 쓰는 Xtream Codes API 또는 M3U, 또는 MAG / Enigma2 포털). 자격 증명은 객실에 남습니다.
호텔 안내 영상
시설 자체 영상을 주문형으로.
- 환영 영상과 안내 영상을 영화로 업로드합니다. 시설의 언어별 버전은 별도 항목 또는 오디오 트랙으로 둡니다.
- 이를 호텔 영상 부케에 넣어 모든 객실 등급이 받도록 합니다.
- 정보가 바뀔 때마다 패널에서 업데이트합니다. 객실에는 새 버전이 즉시 표시됩니다.
라이선스를 받은 텔레비전 채널
시설의 채널을 실시간 스트림으로.
- Streams에서 라이선스를 받은 각 채널을 피드와 함께 추가합니다. 타임시프트나 캐치업은 라이선스가 허용하는 경우에만 활성화합니다.
- 텔레비전의 가이드에 프로그램이 표시되도록 EPG 소스를 추가합니다.
- 지역 제한 채널은 알맞은 패키지만 부여하는 부케에 둡니다.
체크인, 체크아웃, 만료
숙박을 라인의 유효 기간으로 사용합니다.
- 체크인 시 객실 라인을 활성화하고 숙박 기간만큼 갱신합니다(PMS가 API로, 또는 프런트가 패널에서).
- 체크아웃 시 라인을 비활성화합니다. 새 숙박이 시작되면 다시 활성화하므로 자격 증명은 객실을 떠나지 않습니다.
- PMS 또는 프런트를 웹훅에 등록하여 활성화, 비활성화, 만료된 라인을 확인합니다.
PMS와의 연동
체크인과 체크아웃이 객실을 제어합니다.
- PMS용 Reseller API 키를 만들어 PMS의 설정에 보관합니다.
- 체크인 시 PMS가 객실 라인에 대해 요청 ID와 함께 action=enable_line과 action=renew_line을 호출하고, 체크아웃 시 action=disable_line을 호출합니다.
- 투숙객 서비스 애플리케이션(직원 호출, 하우스키핑, 빠른 체크아웃, 룸서비스)과 백오피스 연결은 Enterprise 요금제에 포함되며 시설과 함께 범위를 정합니다.
보안 고려 사항
채널을 시설 안에 유지합니다.
- 재생 기본 주소와 노드는 시설 네트워크에 두고, 객실에 필요하지 않은 것은 인터넷에 노출하지 마세요.
- 객실당 연결 하나를 기기에 묶습니다. 서명된 링크는 만료되므로 복사된 링크는 작동하지 않게 됩니다.
- 패널에는 2단계 로그인을 사용하고, 프런트에는 제한된 권한 그룹을 부여합니다.
- 암호화된 데이터베이스 백업을 켜세요. 객실 자격 증명이 그 안에 있습니다.
문제 해결
가장 먼저 확인할 일반적인 항목.
- 객실에 텔레비전이 나오지 않음: 라인이 활성화되어 있고 만료되지 않았는지 확인한 다음 기기의 자격 증명과 주소를 확인하세요.
- 객실에서 채널이 보이지 않음: 객실 등급 패키지의 부케를 확인하세요.
- 인터넷 장애 중 텔레비전이 멈춤: 재생 기본 주소와 소스가 내부 주소인지 확인하세요. 외부 피드는 외부 회선에 의존합니다.
- PMS 호출이 실패함: API 키, 쓰기가 POST인지, 재시도 시의 요청 ID를 확인하세요.