開始前準備
- OBS Studio 28 或更新版本；這些版本已內建 WebSocket，不需另外安裝舊外掛。
- OBS 與直播進場特效在同一台 Windows 電腦執行。自動讀取適用於相同 Windows 使用者的一般安裝；可攜版或讀取失敗時改用手動設定。
- 先在未開播時完成設定，保持兩個程式開啟。OBS 的密碼與連線資訊畫面不要放進直播或截圖公開。
手機可先閱讀，設定請在直播電腦操作。請用 Chrome 或 Edge 開啟，勿使用微信內建瀏覽器。
先分清楚兩種連線
ws://127.0.0.1:4455http://127.0.0.1:178914455 是 OBS WebSocket 預設連接埠，可依 OBS 實際設定調整。17891 是特效播放器的連接埠。
在 OBS 打開 WebSocket 設定
先開啟 OBS，在上方選單按「工具」→「WebSocket 伺服器設定」。英文介面為 Tools → WebSocket Server Settings。
若找不到這個項目，先查看 OBS 版本；本教學使用 OBS 28 以上的內建 WebSocket 5。選單名稱可能隨語言或版本略有差異。
啟用伺服器，確認連接埠與密碼
勾選「啟用 WebSocket 伺服器」。伺服器連線埠通常保持 4455；若你已使用其他值，記住該數字，稍後兩邊要一致。
保持「啟用認證」勾選，使用 OBS 產生的伺服器密碼。要查看或複製時可按「顯示連線資訊」。
設定完成按「套用」，再按「確定」關閉設定視窗。WebSocket 密碼與本程式的授權碼不同。
OBS WebSocket 連接埠：4455（預設）回到特效程式，先試自動讀取
在桌面版直播進場特效中，展開上方連線區下方的「OBS 自動化連線設定」。
「連線方式」選「自動讀取本機 OBS」。程式會讀取本機 OBS 的連接埠與密碼；若剛切換方式，先按「儲存連線設定」。
本程式固定連線至同一台電腦的 127.0.0.1，沒有另外填寫主機 IP 的欄位。
自動失敗時，手動填入同一組資料
將「連線方式」改為「手動指定密碼」。在「WebSocket 連接埠」填 OBS 中的數字，例如 4455；在「WebSocket 密碼」貼上 OBS 的伺服器密碼。
按「儲存連線設定」。若提示「已儲存手動密碼；留空保留」，欄位留空會沿用舊密碼；需要換密碼時請重新貼上新值。
也可用本程式的「產生專用密碼」→「複製密碼」，但必須親自把它貼到 OBS 的伺服器密碼並套用，再回本程式儲存。產生密碼不會自動修改 OBS。
按「測試連線」，確認真正連上
保持 OBS 開啟，在特效程式按「測試連線」。成功時會顯示「OBS 連線成功。」及 OBS 版本。
若按鈕不能按，先處理「請先儲存變更，再測試連線」提示。若失敗，依下方常見問題排查後重試。
這個測試只確認控制連線與版本，不會開始直播或新增來源；測試結束會關閉該次測試連線。上方的「直播來源已連線」是另一個畫面來源狀態，不能代替本步測試。
加入特效來源，核對直式或橫式畫布
在 OBS 選定實際要輸出的場景；若開啟工作室模式，要確認右側實際輸出場景，不只切換左側預覽。再到「設定」→「影像」確認基本畫布尺寸：直式常用寬 1080、高 1920；橫式常用寬 1920、高 1080。
回特效程式按上方「加入 OBS」。程式會依 OBS 基本畫布尺寸建立或更新「直播進場特效 - 獨立中文版」瀏覽器來源；再確認來源可見、位於攝影機圖層上方。
若自行新增瀏覽器來源，請複製本程式「直播網頁來源」的網址。下方是預設範例；不要把 WebSocket 的 4455 填到瀏覽器來源。兩種連接埠用途不同。
http://127.0.0.1:17891/overlay/screen-1#tiktok.studio需要監聽時，開啟音訊維持勾選
先確認 OBS 混音器中的特效來源沒有靜音，音量適合。需要自己聽到特效並送出聲音時，勾選程式上方「保持 OBS 特效音訊為『監聽與輸出』」。
此選項預設關閉；勾選後立即儲存，並每 5 秒檢查本程式的特效來源。請保留預設來源名稱與本程式的來源網址；尚未建立來源時會等待重試。
取消勾選只停止自動維持，不會還原 OBS 現有音訊模式。請用耳機及短段錄影確認沒有桌面音訊與來源音訊重複收音。
測試畫面、聲音，再連線聊天室
在特效程式按「動畫預覽」檢查動畫，再用「測試進場」確認指定觀眾、橫幅及歡迎語等已設定內容。沒有播放時畫面透明是正常待機。
若來源已存在但更新後沒有刷新，可按「修復 OBS」，完成後重新測試；這個按鈕也需要 WebSocket 已連線。
確認主播已實際開播後，填入真正的 TikTok 帳號並按「連線聊天室」。OBS 控制連線、特效畫面來源和聊天室是三件事，要分別確認。
常見問題
顯示伺服器未啟用，或無法連到 OBS
先確認 OBS 正在執行；回「工具 → WebSocket 伺服器設定」勾選啟用並套用。確認本程式手動連接埠與 OBS 一致，不要填成網頁來源的 17891。
顯示密碼不符／驗證失敗
重新從 OBS 複製目前密碼，切到「手動指定密碼」，貼上後儲存再測試。若曾按「產生專用密碼」，必須同時貼到 OBS 並套用；只在一邊儲存不會成功。
可攜版 OBS、另一個 Windows 帳戶，或自動讀取抓錯設定
改用「手動指定密碼」，填入目前這個 OBS 的連接埠及密碼。主機仍固定為本機 127.0.0.1；這個設定區不提供跨電腦連線。
無法讀取已儲存密碼
在目前登入的 Windows 帳戶重新輸入並儲存 OBS 密碼，或切回自動讀取。若設定區完全載入失敗，可按「恢復自動讀取」後再測試。
連線成功但沒有動畫或沒有聲音
WebSocket 成功只代表能控制 OBS。確認已加入正確瀏覽器來源、來源網址與畫布尺寸正確、圖層可見且未靜音，再按動畫預覽與測試進場；需要監聽時檢查第 7 步。
一直顯示同名來源衝突，音訊維持沒有生效
檢查「直播進場特效 - 獨立中文版」是否真的是本程式的瀏覽器來源及網址。其他內容若用了同名來源，先為它改成不同名稱，再用「加入 OBS」建立本程式來源。
需要開放路由器連接埠或全部改成管理員嗎？
本程式使用同一台電腦的 127.0.0.1 連線，不需為這個流程做路由器轉發或開放公網。先核對啟用狀態、連接埠與密碼；不要用關閉認證或全面停用防火牆來代替排查。
最後檢查
參考資料
- OBS Remote Control Guide
- OBS WebSocket official project — default port and authentication
- OBS Browser Source
- OBS WebSocket official Traditional Chinese labels
- OBS WebSocket official Simplified Chinese labels
公開文件請勿填入或分享你的授權碼與 WebSocket 密碼。