首頁
XtreamUIPro

設定指南

零售與加盟網路部署指南

將平台設定為門市網路的影片服務:螢幕上的門市頻道、職員訓練片庫、每位加盟商一個合作夥伴帳號、每個區域一個節點。

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

概念對應

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

在您的產業中在平台上在面板中的位置
門市頻道或訓練專藏頻道包(bouquet):由方案授予的一組具名頻道、電影或影集Bouquets,由 Streams 與 Movies / Series 建立
門市頻道直播頻道:含來源、EPG 與輸出格式的串流Streams → 新增直播串流(來源 URL 或 RTMP 推流)
訓練與產品影片VOD 內容目錄:電影與含季和集的影集、分類與中繼資料Movies 與 Series,或 VOD 匯入工作
門市螢幕或員工的存取權線路:一份存取權,含其方案、頻道包、到期日、連線數上限與輸出Lines → 新增,或使用啟用碼,或 Reseller API
加盟商帳號合作夥伴帳號(經銷商):具備點數、權限與自己線路的委派 dashboardUsers → 新增經銷商;其權限在 Groups 設定
區域節點串流節點:從面板登錄的邊緣伺服器,每個據點或建築一個Servers → 新增節點,透過 SSH 安裝
每條線路的螢幕或裝置數線路的最大連線數:可同時觀看的裝置數量線路的最大連線數

前置條件

安裝前需要準備什麼。

  1. 總部的一台伺服器(Ubuntu 22.04 或 24.04)、安裝程式,以及門市較多的每個區域一台能從門市連線的伺服器。
  2. 門市頻道的內容(編碼器或循環播放來源)、到職與產品訓練的錄影,以及門市裡的螢幕或媒體播放器。
  3. 關於加盟結構的決定:哪些區域設節點,以及每位加盟商中由誰管理線路。

基礎架構部署

先部署總部,再部署各區域。

  1. 在總部伺服器上執行安裝程式,並將播放基底網址設為門市可以連線的、啟用了 TLS 的位址。
  2. 在 Streams 下新增門市頻道,在 Movies 下新增訓練錄影,並在網頁播放器中確認。
  3. 從 Servers 為每個區域登錄一個節點;面板會透過 SSH 安裝它,或節點以一次性代碼登錄,並將該區域的門市導向它。
  4. 為總部內容團隊建立一個擁有目錄權限、沒有門市線路權限的合作夥伴帳號。

內容整理

門市頻道與訓練片庫。

  1. 為門市頻道建立一個直播串流,並放入它自己的頻道包。
  2. 依主題建立分類,每門訓練課程一部影集,每堂課一集;每個職務(銷售人員、經理、新進員工)再建立一個頻道包。
  3. 為門市螢幕建立一個方案,每個職務再建立一個方案,各自授予其頻道包,並以存取期間作為時效。
  4. 給加盟商他們可以轉售給門市與員工的方案。

合作夥伴(經銷商)設定

每位加盟商一個合作夥伴帳號。

  1. 建立一個權限僅限線路、不能更改目錄的群組。
  2. 在 Users → add a reseller 下新增每位加盟商,使用該群組、其方案與點數餘額。
  3. 擁有多個區域的加盟商可以為每個區域新增一個子 reseller,各有自己的門市。

門市與職員線路設定

每面螢幕、每位員工一條線路。

  1. 在 Lines → add 下為每面門市螢幕建立一條線路,以門市名稱命名,使用門市方案;加盟商為自己的門市做同樣的事。
  2. 將最大連線數設為門市的螢幕數量,員工則設為兩個(賣場與手機)。
  3. 門市有固定位址時,將門市線路綁定到該位址,這樣憑證在別處無法使用。
  4. 一次性設定螢幕的播放器(M3U、Xtream Codes API 或網頁播放器位址),並把憑證儲存在門市的檔案中。

訓練與產品影片

面向職員的片庫。

  1. 將每門訓練課程作為影集上傳,將每部產品影片作為電影上傳,或以 VOD 匯入工作將其匯入媒體根目錄。
  2. 透過分類把錄影放入對應職務的頻道包。
  3. 在向加盟商開放片庫之前,以測試線路檢查每個職務看得到什麼。

門市頻道

一個頻道供所有螢幕使用。

  1. 將門市頻道新增為直播串流,由總部的編碼器透過 RTMP 供流,或使用循環播放來源。
  2. 對現場直播的訓練課程啟用回看,並在之後把錄影上傳到片庫。
  3. 各區域的節點只從來源伺服器拉取一次該頻道並服務各自的門市,因此門市的連線不會被占滿。

到期與續期

存取權跟隨門市或合約。

  1. 線路在其方案期間結束時到期;加盟商以方案或點數為其續期。
  2. 停用已關閉門市或離職員工的線路。
  3. 讓加盟管理或人力資源系統訂閱 webhook,以查看即將到期或已到期的線路。

與加盟或人力資源系統整合

由系統驅動線路,由播放器負責播放。

  1. 為加盟管理或人力資源系統建立一個 Reseller API 金鑰;它呼叫 create_line、renew_line、enable_line 與 disable_line,每次寫入都帶有請求 ID。
  2. 向加盟商收取服務費用時使用電商連接器;其他系統使用 Reseller API 與 webhook。
  3. 沒有面向觀眾的單一登入:員工使用其線路的憑證登入播放器。

安全考量

讓每家門市只使用自己的線路。

  1. 將面板放在具 TLS 的反向代理之後並設定 TRUSTED_PROXIES,使稽核日誌與 IP 規則能看到真實位址。
  2. 每個總部帳號使用雙重驗證登入;加盟商取得僅限自己線路的權限群組。
  3. 每條線路設定連線數上限,播放連結經過簽章並會過期,門市螢幕綁定位址。
  4. 啟用附異地副本的加密資料庫備份,並以稽核日誌檢視線路與目錄的變更。

疑難排解

常見的初步檢查。

  1. 某面門市螢幕黑畫面:檢查其線路已啟用且未到期、位址綁定,以及第二台裝置使用該線路時的連線數上限。
  2. 某個區域卡頓:檢查區域節點的心跳以及門市是否已導向它。
  3. 加盟商無法建立線路:檢查其點數餘額、群組權限以及分配給它的方案。
  4. 稽核日誌顯示的是代理的位址:將 TRUSTED_PROXIES 設為該代理並重新啟動面板。