這些指南將產業的概念對應到平台目前具備的物件(頻道包、線路、方案、合作夥伴帳號、節點、API)。這些是概念上的對應,並非產業專屬功能,而且合作夥伴帳號是委派帳號,不是隔離的租戶。
概念對應
面板裡沒有任何東西叫舞台或票券。下表說明哪個物件扮演哪個角色;以下各章依該順序進行設定。
| 在您的產業中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 舞台頻道 | 直播頻道:含來源、EPG 與輸出格式的串流 | Streams → 新增直播串流(來源 URL 或 RTMP 推流) |
| 票券類型 | 頻道包(bouquet):由方案授予的一組具名頻道、電影或影集 | Bouquets,由 Streams 與 Movies / Series 建立 |
| 票券或通行證 | 線路:一份存取權,含其方案、頻道包、到期日、連線數上限與輸出 | Lines → 新增,或使用啟用碼,或 Reseller API |
| 活動結束 | 線路的到期日,可由方案、點數或 API 續期 | 線路的到期日與方案的期限 |
| 每張票券的裝置數 | 線路的最大連線數:可同時觀看的裝置數量 | 線路的最大連線數 |
| 票務或報名整合 | Reseller API 與 webhook:從您自己的系統執行面板的各項操作 | 經銷商 dashboard 中的 Reseller API 金鑰與 webhook |
| 會場節點 | 串流節點:從面板登錄的邊緣伺服器,每個據點或建築一個 | Servers → 新增節點,透過 SSH 安裝 |
前置條件
安裝前需要準備什麼。
- 一台具公開位址或網域、上行頻寬足以應付預期尖峰觀眾的伺服器(Ubuntu 22.04 或 24.04);若設會場節點,還需要會場網路上的一台機器。
- 每個舞台一台能推送 RTMP 的編碼器,以及舞台、日期與票券類型的清單。
- 關於票券如何進入面板的決定:批次產生啟用碼,或由票務系統呼叫 Reseller API。
基礎架構部署
先部署來源伺服器,再部署會場。
- 在管理伺服器上執行安裝程式,並將面板放在具 TLS 的反向代理之後;設定受信任代理,使 IP 規則能看到觀眾的真實位址。
- 將播放基底網址設為與會者連線的公開位址。
- 從 Servers 為會場內的機器登錄一個節點;面板會透過 SSH 安裝它,本地螢幕會被導向它。
- 為票務台建立一個合作夥伴帳號(reseller),擁有線路權限但沒有目錄權限。
內容整理
舞台是頻道,票券是方案。
- 依日期或分場新增分類,使頻道清單讀起來像議程。
- 每種票券類型建立一個頻道包:該票券可觀看的舞台。
- 每種票券類型建立一個方案,以活動的長度作為時效;如有需要,為媒體與講者新增一個試用方案。
- 為贊助商的舞台或貴賓室訊號建立一個頻道包,並只透過贊助商方案授予。
合作夥伴(經銷商)設定
票務台,如果由它發放存取權。
- 為票務台建立一個擁有線路權限、沒有目錄權限的群組。
- 將票務台新增為 reseller,使用該群組,並賦予足夠其發放啟用碼的點數。
- 銷售自己票券的共同主辦方或區域合作夥伴,取得自己的合作夥伴帳號與自己的方案。
與會者存取設定
每張票券一條線路。
- 批次產生啟用碼,每張票券一個,每個都綁定到其票券類型的方案,並隨票券列印或以電子郵件寄出。
- 對於線上售票,安裝您的電商平台的連接器,或讓票務系統以方案與請求 ID 呼叫 action=create_line。
- 將最大連線數設為每張票券一兩個裝置,這樣啟用碼就不能在觀眾之間共用。
- 開門前以試用線路測試,使用與會者將要使用的同一個播放器。
場次錄影
活動之後的錄影。
- 錄製每個舞台,並將檔案作為每個分場一部影集的各集加入片庫,或以 VOD 匯入工作匯入。
- 透過單獨的頻道包與方案授予錄影,使與會者在直播線路到期後仍保有存取權。
- 在宣布之前,以該方案的測試線路檢查錄影的播放。
舞台頻道
把舞台變成直播頻道。
- 為每個舞台新增一個直播串流,使用編碼器的 RTMP 推送,並將其放入可觀看它的票券類型的頻道包中。
- 啟用回看,讓錯過場次開頭的與會者可以倒轉。
- 在第一場之前檢查會場節點是否從來源伺服器只拉取每個舞台一次,以及螢幕是否已導向它。
到期
存取權隨活動結束。
- 讓每個票券方案的時效在活動最後一天結束,這樣線路不需要任何操作就會失效。
- 對於講者或遲到的贊助商,延長一條線路或發放一個短期有效的啟用碼,而不是建立新方案。
- 在 Lines 中停用遺失或被共用票券的線路;稽核日誌會保留紀錄。
與票務系統整合
由系統驅動存取,由播放器負責播放。
- 票務或報名系統透過 Reseller API 建立線路,並監聽 line.created 與 line.expired 等 webhook。
- 受支援電商平台上的線上售票使用其連接器;沒有針對特定票務產品的原生連接器。
- 沒有面向觀眾的單一登入:與會者使用線路的憑證或啟用碼登入播放器。
安全考量
一張票券對應一個人。
- 透過 TLS 提供面板與播放基底網址,並將 TRUSTED_PROXIES 設為您的反向代理。
- 每個面板帳號使用雙重驗證登入,並設定權限群組,使票務台無法更改舞台。
- 播放連結經過簽章並會過期,每張票券設定較低的連線數上限。
- 加密的資料庫備份並保留異地副本,以稽核日誌記錄線路與舞台的每一次變更。
疑難排解
常見的初步檢查。
- 與會者無法開啟某個舞台:檢查線路的方案、包含該舞台的頻道包以及到期日。
- 舞台在會場內卡住但線上正常:檢查會場節點的心跳以及螢幕到它的路由。
- 啟用碼被拒絕:檢查它是否已被使用,以及其方案是否仍然有效。
- 稽核日誌顯示的是代理的位址:將 TRUSTED_PROXIES 設為該代理並重新啟動面板。