這些指南將產業的概念對應到平台目前具備的物件（頻道包、線路、方案、合作夥伴帳號、節點、API）。這些是概念上的對應，並非產業專屬功能，而且合作夥伴帳號是委派帳號，不是隔離的租戶。
概念對應
面板中沒有任何東西叫做客房或住宿。此表說明哪個物件扮演哪個角色；以下各章依此順序進行設定。
| 在您的產業中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 飯店營運者或授權合作夥伴 | 合作夥伴帳號（經銷商）：具備點數、權限與自己線路的委派 dashboard | Users → 新增經銷商；其權限在 Groups 設定 |
| 頻道方案 | 頻道包（bouquet）：由方案授予的一組具名頻道、電影或影集 | 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 機上盒、搭配播放器應用程式或瀏覽器的智慧電視）。
- PMS 能在入住與退房時呼叫 HTTP API，或由櫃檯在面板中操作的作業程序。
基礎架構部署
中央伺服器與每棟建築一個節點。
- 在中央伺服器上執行安裝程式；將播放基底網址設為館內的內部位址，讓客房留在區域網路中。
- 在 Streams 下新增頻道訊號，在 Movies 下新增資訊影片；並在網頁播放器中確認。
- 從 Servers 為每個側翼或建築登錄一個節點；面板會透過 SSH 安裝它，並將該建築的客房導向它。
- 在伺服器上設定授權金鑰；啟用在現場進行，服務在沒有上行網路時也能運作。
內容整理
頻道方案與飯店影片。
- 從館方的頻道中，為每個頻道方案（標準房、套房、會議）建立一個頻道包。
- 建立一個飯店影片（歡迎、設施、安全須知）的頻道包，並將它加入每個方案。
- 為每種房型建立一個方案，指定它授予的頻道包，期限為一天：入住時，房間的線路依住宿晚數各續期一次（每次續期增加一個方案期限），退房時停用該線路（第 8 章）。
- 為頻道排序並設定標誌，讓電視上的選單易於閱讀。
合作夥伴（經銷商）設定
將館方，或營運多間飯店的營運商，作為委派帳號。
- 建立一個群組，權限僅限於線路（客房），不能變更內容目錄。
- 將館方櫃檯或營運商新增為經銷商，指定該群組與客房方案。
- 營運多間飯店的營運商，每間飯店各有一個經銷商，各自擁有自己的客房與點數。
客房（線路）設定
每間客房一條線路，以房號命名。
- 在 Lines 下為每間客房建立一條線路，以房號作為名稱，並指定該房型的方案。
- 將最大連線數設為 1（一台電視），或設為客房內的螢幕數量。
- 當網路為裝置指派固定位址時，將線路綁定到客房裝置的位址。
- 設定裝置一次即可（以線路憑證設定 Xtream Codes API 或 M3U，或使用 MAG / Enigma2 入口）；憑證會一直留在客房。
飯店資訊影片
館方自有的隨選影片。
- 將歡迎與資訊影片上傳為電影，館方的各語言版本可作為獨立項目或音軌。
- 將它們放進飯店影片頻道包，讓每種房型都能收到。
- 資訊有變動時，隨時從面板更新；客房會立即看到新版本。
取得授權的電視頻道
將館方的頻道作為直播串流。
- 在 Streams 下新增每個取得授權的頻道及其訊號；只有在授權允許時才啟用時移或回看。
- 新增一個 EPG 來源，讓電視上的節目表顯示節目。
- 將有地區限制的頻道放在只有對應方案才能取得的頻道包中。
入住、退房與到期
以住宿作為線路的有效期間。
- 入住時啟用該房間的線路，並依住宿天數續期（由 PMS 透過 API，或由櫃檯在面板中操作）。
- 退房時停用線路；新的住宿會再次啟用它，因此憑證永遠不會離開客房。
- 讓 PMS 或櫃檯訂閱 webhook，以查看已啟用、已停用與已到期的線路。
與 PMS 整合
由入住與退房驅動客房。
- 為 PMS 建立一把 Reseller API 金鑰，並儲存在 PMS 的設定中。
- 入住時，PMS 針對該房間的線路，以一個請求 ID 呼叫 action=enable_line 與 action=renew_line；退房時呼叫 action=disable_line。
- 賓客服務應用程式（呼叫服務人員、客房清潔、快速退房、客房餐飲）及其後台連接屬於 Enterprise 方案，與館方共同評估範圍。
安全考量
讓頻道留在館內。
- 將播放基底網址與節點保持在館內網路；不要向網際網路暴露客房不需要的任何東西。
- 每間客房一個連線，並綁定裝置；簽章連結會過期，因此被複製的連結會失效。
- 面板使用雙重驗證登入；櫃檯取得權限受限的群組。
- 啟用加密的資料庫備份；客房憑證就儲存在其中。
疑難排解
常見的初步檢查。
- 客房沒有電視：檢查其線路是否已啟用且未到期，再檢查裝置的憑證與位址。
- 客房缺少某個頻道：檢查該房型方案的頻道包。
- 網路中斷時電視停止：檢查播放基底網址與來源是否為內部位址；外部訊號依賴上行網路。
- PMS 呼叫失敗：檢查 API 金鑰、寫入操作是否為 POST，以及重試時的請求 ID。