OBS 進階教學：利用 WebSocket 與 Python 腳本實現即時比分板
OBS WebSocket 是一種基於網路通訊協定的 API 介面，允許外部程式直接與 OBS Studio 進行雙向溝通。透過 Python 腳本結合 WebSocket，直播工程師可以編寫自動化邏輯，將運動賽事的即時分數、球員資訊或比賽計時器，精準且無延遲地推送至 OBS 的來源圖層中。這種方法徹底取代了傳統手動修改文字檔（Text File）的低效流程，不僅大幅降低人為操作失誤，更能在高強度的轉播環境中，實現專業級的動態數據視覺化更新。
專業賽事直播的核心挑戰：為何手動更新必須被取代？
在過去的傳統導播作業中，許多團隊仍仰賴助理導播手動開啟記事本修改比分，並由 OBS 自動偵測檔案更動。然而，這種做法在專業領域存在三大致命缺點：第一，反應延遲（Latency），檔案系統的 I/O 寫入與 OBS 偵測之間存在秒級誤差。第二，操作風險（Operational Risk），在高壓的賽事節奏下，手動輸入極易產生錯字或數據誤植。第三，擴展性不足，當需要同時更新多組數據（如得分、犯規次數、暫停次數）時，單純的文字檔覆蓋難以維持複雜的動畫邏輯與同步性。
技術解決方案：Python 與 WebSocket 的自動化架構
針對專業體育轉播需求，我們建議採用以 Python 為核心的控制層，透過 obs-websocket-py 套件直接對 OBS 內的 Text (GDI+) 或 Browser Source 進行動態屬性修改。這種架構具備極高的靈活性，可以輕易整合外部數據源，例如運動計時器的 API、甚至是自訂的網頁輸入介面，將數據直接注入串流信號流中。
實作技術路徑
- 環境建置：在 OBS 中開啟 WebSocket 伺服器設定，配置連接埠與認證密碼。
- 套件引用：安裝 Python 導播自動化工具，主要使用 obs-websocket-py 進行通訊協定封裝。
- 邏輯撰寫：定義一個資料處理函式，將輸入的分數轉換為 JSON 格式，並透過 SetInputSettings 指令發送至指定的 OBS 來源名稱。
- 異常處理：建立 Heartbeat 機制確保連線穩定，當網路波動導致斷線時，腳本須具備自動重連功能以維持轉播不中斷。
直播技術方案對比表：手動與自動化差異
| 比較項目 | 傳統手動修改文字檔 | WebSocket Python 自動化 |
| 更新延遲 | 1 到 3 秒 (取決於系統偵測頻率) | 毫秒級即時更新 |
| 操作精準度 | 高人為錯誤率，需人工複核 | 高精準度，可與賽事官網同步 |
| 控制難度 | 容易操作但難以應付複雜情境 | 需具備開發能力但效率極高 |
| 多場景同步 | 需手動管理多個檔案，極度混亂 | 單一腳本可同時更新多個場景與來源 |
| 自動化潛力 | 無 | 可串接即時 API 或資料庫 |
專家實務建議：轉播現場的穩定性法則
身為資深直播架構師，我必須強調穩定性高於功能性。在導入自動化比分系統時，務必在主機端與控制端建立獨立的區域網路環境，避免與公有網路混用，以防止 WebSocket 因頻寬競爭產生的指令封包遺失。此外，建議在 Python 腳本中加入快速熱鍵備援（Hotkey Override），當外部數據源異常時，導播能立即接管控制權。對於高規格的賽事，應搭配 NDI 或 SRT 協定傳輸 Alpha 通道的圖卡信號，而非僅僅是文字層，這樣才能在自動化更新的基礎上，維持最高品質的視覺包裝。
常見問題 FAQ
1. 使用 WebSocket 控制會佔用大量的系統資源或影響 Bitrate 嗎？
不會。WebSocket 指令是以極小規模的 JSON 封包進行傳輸，對於系統 CPU 與網路頻寬的佔用幾乎可以忽略不計，完全不會影響串流的影像品質或 Bitrate 穩定性。
2. 如果比賽中途 Python 腳本崩潰，OBS 上的畫面會消失嗎？
不會。OBS 來源會保留最後一次成功更新的數據。只要腳本設計有完善的自動重連與狀態保存機制，重新啟動腳本後即可恢復與 OBS 的連動，不會對正在進行的直播畫面造成閃爍或中斷。
3. 這套方案是否支援 Mac 或 Linux 系統上的 OBS？
是的。由於 Python 與 WebSocket 都是跨平台的標準技術，只要該作業系統版本的 OBS 支援 WebSocket 插件（OBS 28 版本後已內建），這套自動化邏輯即可在 Windows、macOS 與 Linux 系統之間無縫移植。
