首頁
XtreamUIPro

設定指南

現場活動部署指南

將平台設定為研討會、音樂節或典禮的串流服務:每個舞台一個頻道,依票券授予存取權,會場內設節點,到期日較短。

這些指南將產業的概念對應到平台目前具備的物件(頻道包、線路、方案、合作夥伴帳號、節點、API)。這些是概念上的對應,並非產業專屬功能,而且合作夥伴帳號是委派帳號,不是隔離的租戶。

概念對應

面板裡沒有任何東西叫舞台或票券。下表說明哪個物件扮演哪個角色;以下各章依該順序進行設定。

在您的產業中在平台上在面板中的位置
舞台頻道直播頻道:含來源、EPG 與輸出格式的串流Streams → 新增直播串流(來源 URL 或 RTMP 推流)
票券類型頻道包(bouquet):由方案授予的一組具名頻道、電影或影集Bouquets,由 Streams 與 Movies / Series 建立
票券或通行證線路:一份存取權,含其方案、頻道包、到期日、連線數上限與輸出Lines → 新增,或使用啟用碼,或 Reseller API
活動結束線路的到期日,可由方案、點數或 API 續期線路的到期日與方案的期限
每張票券的裝置數線路的最大連線數:可同時觀看的裝置數量線路的最大連線數
票務或報名整合Reseller API 與 webhook:從您自己的系統執行面板的各項操作經銷商 dashboard 中的 Reseller API 金鑰與 webhook
會場節點串流節點:從面板登錄的邊緣伺服器,每個據點或建築一個Servers → 新增節點,透過 SSH 安裝

前置條件

安裝前需要準備什麼。

  1. 一台具公開位址或網域、上行頻寬足以應付預期尖峰觀眾的伺服器(Ubuntu 22.04 或 24.04);若設會場節點,還需要會場網路上的一台機器。
  2. 每個舞台一台能推送 RTMP 的編碼器,以及舞台、日期與票券類型的清單。
  3. 關於票券如何進入面板的決定:批次產生啟用碼,或由票務系統呼叫 Reseller API。

基礎架構部署

先部署來源伺服器,再部署會場。

  1. 在管理伺服器上執行安裝程式,並將面板放在具 TLS 的反向代理之後;設定受信任代理,使 IP 規則能看到觀眾的真實位址。
  2. 將播放基底網址設為與會者連線的公開位址。
  3. 從 Servers 為會場內的機器登錄一個節點;面板會透過 SSH 安裝它,本地螢幕會被導向它。
  4. 為票務台建立一個合作夥伴帳號(reseller),擁有線路權限但沒有目錄權限。

內容整理

舞台是頻道,票券是方案。

  1. 依日期或分場新增分類,使頻道清單讀起來像議程。
  2. 每種票券類型建立一個頻道包:該票券可觀看的舞台。
  3. 每種票券類型建立一個方案,以活動的長度作為時效;如有需要,為媒體與講者新增一個試用方案。
  4. 為贊助商的舞台或貴賓室訊號建立一個頻道包,並只透過贊助商方案授予。

合作夥伴(經銷商)設定

票務台,如果由它發放存取權。

  1. 為票務台建立一個擁有線路權限、沒有目錄權限的群組。
  2. 將票務台新增為 reseller,使用該群組,並賦予足夠其發放啟用碼的點數。
  3. 銷售自己票券的共同主辦方或區域合作夥伴,取得自己的合作夥伴帳號與自己的方案。

與會者存取設定

每張票券一條線路。

  1. 批次產生啟用碼,每張票券一個,每個都綁定到其票券類型的方案,並隨票券列印或以電子郵件寄出。
  2. 對於線上售票,安裝您的電商平台的連接器,或讓票務系統以方案與請求 ID 呼叫 action=create_line。
  3. 將最大連線數設為每張票券一兩個裝置,這樣啟用碼就不能在觀眾之間共用。
  4. 開門前以試用線路測試,使用與會者將要使用的同一個播放器。

場次錄影

活動之後的錄影。

  1. 錄製每個舞台,並將檔案作為每個分場一部影集的各集加入片庫,或以 VOD 匯入工作匯入。
  2. 透過單獨的頻道包與方案授予錄影,使與會者在直播線路到期後仍保有存取權。
  3. 在宣布之前,以該方案的測試線路檢查錄影的播放。

舞台頻道

把舞台變成直播頻道。

  1. 為每個舞台新增一個直播串流,使用編碼器的 RTMP 推送,並將其放入可觀看它的票券類型的頻道包中。
  2. 啟用回看,讓錯過場次開頭的與會者可以倒轉。
  3. 在第一場之前檢查會場節點是否從來源伺服器只拉取每個舞台一次,以及螢幕是否已導向它。

到期

存取權隨活動結束。

  1. 讓每個票券方案的時效在活動最後一天結束,這樣線路不需要任何操作就會失效。
  2. 對於講者或遲到的贊助商,延長一條線路或發放一個短期有效的啟用碼,而不是建立新方案。
  3. 在 Lines 中停用遺失或被共用票券的線路;稽核日誌會保留紀錄。

與票務系統整合

由系統驅動存取,由播放器負責播放。

  1. 票務或報名系統透過 Reseller API 建立線路,並監聽 line.created 與 line.expired 等 webhook。
  2. 受支援電商平台上的線上售票使用其連接器;沒有針對特定票務產品的原生連接器。
  3. 沒有面向觀眾的單一登入:與會者使用線路的憑證或啟用碼登入播放器。

安全考量

一張票券對應一個人。

  1. 透過 TLS 提供面板與播放基底網址,並將 TRUSTED_PROXIES 設為您的反向代理。
  2. 每個面板帳號使用雙重驗證登入,並設定權限群組,使票務台無法更改舞台。
  3. 播放連結經過簽章並會過期,每張票券設定較低的連線數上限。
  4. 加密的資料庫備份並保留異地副本,以稽核日誌記錄線路與舞台的每一次變更。

疑難排解

常見的初步檢查。

  1. 與會者無法開啟某個舞台:檢查線路的方案、包含該舞台的頻道包以及到期日。
  2. 舞台在會場內卡住但線上正常:檢查會場節點的心跳以及螢幕到它的路由。
  3. 啟用碼被拒絕:檢查它是否已被使用,以及其方案是否仍然有效。
  4. 稽核日誌顯示的是代理的位址:將 TRUSTED_PROXIES 設為該代理並重新啟動面板。