博物館與文化中心部署指南

概念對應

面板裡沒有任何東西叫展廳或會員。下表說明哪個物件扮演哪個角色；以下各章依該順序進行設定。

1前置條件

安裝前需要準備什麼。

1. 館內的一台伺服器（Ubuntu 22.04 或 24.04）、安裝程式，以及螢幕與會員裝置將使用的展廳網路。
2. 展覽影片、您擁有權利的典藏錄影、演講廳的編碼器，以及展廳用的螢幕或媒體播放器。
3. 授權金鑰，以及館內沒有網際網路時的離線啟用流程；還要決定服務台由誰銷售會員資格。

2基礎架構部署

館內的伺服器，在現場啟用。

1. 在伺服器上執行安裝程式，並將播放基底網址設為展廳網路可連線的位址。
2. 在面板中離線啟用授權金鑰；啟用後服務可在沒有網際網路的區域網路上運作。
3. 在 Movies 下新增展覽影片，在 Streams 下新增演講廳的訊號，並在網頁播放器中確認。
4. 對於第二個場地或大型公共計畫，從 Servers 登錄一個節點；面板會透過 SSH 安裝它，並將該場地的觀眾導向它。

3內容整理

展廳、典藏與會員專藏。

1. 依展覽與年份建立分類，並為一個講座系列建立一部影集，每場講座一集。
2. 為展廳螢幕建立一個頻道包，為包含講座與典藏影片的會員片庫再建立一個。
3. 為展廳建立一個方案，每種會員資格再建立一個，各自授予其頻道包；會員方案的時效就是會員期間。
4. 為每部電影加入海報與簡短說明，使片庫在播放器中易於瀏覽。

4合作夥伴（經銷商）設定

服務台與商店作為委派帳號。

1. 建立一個權限僅限線路與啟用碼、不能存取目錄或伺服器的群組。
2. 將服務台或商店新增為 reseller，使用該群組、會員方案與點數餘額。
3. 營運多個場館的文化中心可以為每個場館新增一個 reseller，各自以自己的餘額銷售會員資格。

5訪客與會員存取設定

螢幕與會員使用線路。

1. 在 Lines → add 下為每面展廳螢幕建立一條使用展廳方案的線路；網路為螢幕指派固定位址時，將其綁定到螢幕的位址。
2. 每銷售一份會員資格，就在服務台建立一個啟用碼；會員在播放器中輸入該碼，線路即開通。
3. 將每份會員資格的最大連線數設為會員可使用的裝置數，通常為兩個。
4. 依會員的裝置，把播放器應用程式、M3U 播放清單或網頁播放器位址交給會員。

6展覽影片與典藏

隨選片庫。

1. 將展覽影片與數位化典藏作為電影上傳，或以 VOD 匯入工作將其匯入媒體根目錄。
2. 有 TMDB 中繼資料的就加入，其餘的自行撰寫標題與說明。
3. 不對大眾開放的典藏只放在會員頻道包中，並以測試線路檢查每個方案看得到什麼。

7開幕式與講座

把活動變成直播頻道。

1. 為演講廳的編碼器新增一個直播串流（RTMP 推送），並將其放入會員頻道包；若是要在螢幕上播放的開幕式，則放入展廳頻道包。
2. 啟用回看，讓遲到的會員可以倒轉，並在之後把錄影上傳到片庫。
3. 活動前以測試線路在觀眾將使用的同一網路上測試編碼器與串流。

8會員資格到期與續期

會員資格就是線路的有效期。

1. 線路在其方案期間結束時到期；在服務台續期會增加一個週期。
2. 會員資格被取消時停用線路；從未使用的啟用碼在被兌換之前保持未使用狀態。
3. 讓商店或會員系統訂閱 webhook，以查看即將到期或已到期的線路。

9與商店或會員系統整合

由系統銷售存取權，由播放器負責播放。

1. 為商店或會員系統建立一個 Reseller API 金鑰；它呼叫 create_line、renew_line 與 disable_line，每次寫入都帶有請求 ID。
2. 會員資格線上銷售時使用電商連接器；其他系統使用 Reseller API 與 webhook。
3. 沒有面向觀眾的單一登入：會員使用線路的憑證或啟用碼登入播放器。

10安全考量

把典藏留在它們該在的地方。

1. 讓展廳網路與訪客網路分開，任何公開存取都放在具 TLS 並設定了 TRUSTED_PROXIES 的反向代理之後。
2. 每個面板帳號使用雙重驗證登入；服務台取得僅限線路與啟用碼的權限群組。
3. 播放連結經過簽章並會過期，每份會員資格設定連線數上限，展廳螢幕綁定位址。
4. 啟用附異地副本的加密資料庫備份，並以稽核日誌檢視線路與目錄的變更。

11疑難排解

常見的初步檢查。

1. 某面展廳螢幕黑畫面：檢查其線路已啟用且未到期、螢幕的位址綁定，以及伺服器在展廳網路上是否可連線。
2. 會員的啟用碼無法使用：檢查該碼是否已被兌換，以及它所開通的方案是否仍分配給服務台。
3. 離線授權啟用失敗：對照授權金鑰檢查啟用檔案，並檢查伺服器的時鐘。
4. 直播開幕式卡頓：對照上行連線檢查編碼器的位元率，並在 Streams 下檢查該串流的狀態。