這些指南將產業的概念對應到平台目前具備的物件(頻道包、線路、方案、合作夥伴帳號、節點、API)。這些是概念上的對應,並非產業專屬功能,而且合作夥伴帳號是委派帳號,不是隔離的租戶。
概念對應
面板裡沒有任何東西叫會議、居民或部門。下表說明哪個物件扮演哪個角色;以下各章依該順序進行設定。
| 在您的產業中 | 在平台上 | 在面板中的位置 |
|---|---|---|
| 議會會議或公共頻道 | 直播頻道:含來源、EPG 與輸出格式的串流 | Streams → 新增直播串流(來源 URL 或 RTMP 推流) |
| 會議存檔與訓練片庫 | VOD 內容目錄:電影與含季和集的影集、分類與中繼資料 | Movies 與 Series,或 VOD 匯入工作 |
| 公共節目或部門專藏 | 頻道包(bouquet):由方案授予的一組具名頻道、電影或影集 | Bouquets,由 Streams 與 Movies / Series 建立 |
| 居民或職員的存取權 | 線路:一份存取權,含其方案、頻道包、到期日、連線數上限與輸出 | Lines → 新增,或使用啟用碼,或 Reseller API |
| 民眾或職員存取的有效期 | 線路的到期日,可由方案、點數或 API 續期 | 線路的到期日與方案的期限 |
| 議會系統整合 | Reseller API 與 webhook:從您自己的系統執行面板的各項操作 | 經銷商 dashboard 中的 Reseller API 金鑰與 webhook |
前置條件
安裝前需要準備什麼。
- 機構資料中心裡的一台伺服器(Ubuntu 22.04 或 24.04)、安裝程式,以及機構反向代理之後用於公開位址的網域。
- 能推送 RTMP 的議事廳編碼器或影像切換台、過往會議的錄影,以及職員的訓練影片。
- 關於哪些內容公開、哪些內部、民眾線路有效期多長,以及營運人員中誰取得面板帳號的決定。
基礎架構部署
先部署管理伺服器,再部署任何遠端據點。
- 在機構的伺服器上執行安裝程式;將面板放在具 TLS 的反向代理之後並設定 TRUSTED_PROXIES,使稽核日誌與 IP 規則能看到真實位址。
- 將播放基底網址設為居民連線的公開位址,並在伺服器上設定授權金鑰。
- 為需要節點的據點(例如設有議事廳的第二棟建築)從 Servers 登錄一個節點;面板會透過 SSH 安裝它。
- 為宣傳團隊建立一個擁有民眾線路權限的合作夥伴帳號(reseller),並為人事或訓練部門建立一個負責職員線路的帳號。
內容整理
公開節目與部門專藏。
- 為會議、委員會與公共資訊建立分類,每個機關一部影集,每次會議一集。
- 建立一個包含直播會議頻道與存檔的公開頻道包,並為每個部門的訓練專藏各建立一個頻道包。
- 為居民建立一個只授予公開頻道包的方案,以較長的時效作為存取期間。
- 為職員建立在公開頻道包之上再加入訓練與內部頻道包的方案。
合作夥伴(經銷商)設定
負責發放存取權的團隊。
- 建立一個僅含線路權限、不能存取目錄或設定的群組。
- 將宣傳團隊新增為使用居民方案的合作夥伴帳號,將人事或訓練部門新增為使用職員方案的合作夥伴帳號。
- 設有多個服務部門的機關可以給每個部門各配一個合作夥伴帳號;它是委派帳號,而不是獨立的安裝。
居民與職員線路設定
民眾線路與職員線路。
- 為議會網站建立一個 Reseller API 金鑰並儲存在其機密資訊中;居民申請存取時,它以公開方案與請求 ID 呼叫 action=create_line。
- 為民眾線路設定較長的到期日,以及適合家庭觀看的連線數上限。
- 以職員方案依部門建立職員線路,可由議會的職員系統透過 API 建立,也可透過 Lines → add 建立。
- 在網路允許時,將職員線路綁定到機構的位址範圍。
會議存檔與訓練片庫
隨選錄影。
- 將每個錄製的會議作為其機關影集中的一集加入,以 VOD 匯入工作匯入或直接上傳,並附上標題、日期與說明。
- 將會議影集放入公開頻道包,將訓練片庫放入各部門的頻道包。
- 以公開方案的一條測試線路與職員方案的一條測試線路檢查播放,確認誰看得到什麼。
現場會議
把議事廳變成直播頻道。
- 新增一個由議事廳編碼器以 RTMP 推送的直播串流,並將其放入公開頻道包。
- 啟用回看,讓遲到的觀眾可以倒轉,並加入 EPG 項目或標題,讓觀眾知道正在進行的是哪場會議。
- 每次會議前測試訊號;若第二個據點也舉行會議,在其附近保留一個節點。
到期與續期
民眾線路較長,職員線路與任職掛鉤。
- 民眾線路的有效期與方案的時效一致;居民再次申請時,以 action=renew_line 延長。
- 職員線路在此人為機構工作期間續期,離職時以 action=disable_line 停用。
- 讓議會的系統訂閱 webhook,以查看即將到期與已停用的線路。
與機構系統整合
由系統驅動存取,由播放器負責播放。
- 網站與職員系統憑金鑰與請求 ID,透過 Reseller API 建立、續期、啟用與停用線路。
- 沒有面向觀眾的單一登入,也沒有與特定公共部門產品的原生整合:觀眾使用其線路的憑證登入播放器。
- 為報表工具使用帶唯讀旗標、IP 允許清單與到期日的 Admin API 金鑰。
安全考量
由機構自行營運,該公開的地方公開。
- 將平台放在機構的基礎架構上、具 TLS 的反向代理之後,並把公開與內部素材放在不同的頻道包中。
- 每個面板帳號使用雙重驗證登入,並依團隊設定權限群組;若面板可從外部連線,在登入頁啟用 reCAPTCHA 或 Turnstile。
- 播放連結經過簽章並會過期,每條線路設定連線數上限,職員線路綁定位址。
- 加密的資料庫備份並保留異地副本,以稽核日誌記錄線路與目錄的每一次變更。
疑難排解
常見的初步檢查。
- 居民無法觀看:檢查線路的到期日、是否已啟用,以及方案中的公開頻道包。
- 會議沒有開始:檢查編碼器向該串流的推送,以及面板中該串流的狀態。
- 職員看不到訓練片庫:檢查職員線路的方案及其授予的頻道包。
- 稽核日誌顯示的是代理的位址:將 TRUSTED_PROXIES 設為該代理並重新啟動面板。