OBS 控制停駐面板指南 - Social Stream Ninja

快速設定

在 Social Stream Ninja 中，開啟 全域設定與工具 → 運作方式.
開啟 OBS Control Dock and copy its link. Keep Social Stream Ninja active during the stream.
The copied link includes your session, password, and connection settings.
在 OBS 中，開啟 停駐面板 → 自訂瀏覽器停駐面板.
將停駐面板命名為 Social Stream 控制項 and paste the copied link. For a session without a password or server settings, the URL is:

https://socialstream.ninja/obs-control-dock.html?session=YOUR_SESSION_ID

選擇套用，關閉設定視窗，然後將新停駐面板放到 OBS 中所需位置。
確認停駐面板顯示 已連線。如果 URL 不含工作階段，請在停駐面板中輸入並選擇 儲存並連線.

開啟控制停駐面板

需要哪些伺服器設定？

The generated control link follows Social Stream's connection settings. Normal links use P2P. When 停駐面板透過伺服器向擴充功能傳送指令 is enabled, controls use that server connection.

For a manually configured API connection, add &server （或 &server=wss://YOUR_SERVER) and enable 擴充功能的遠端 API 控制.

OBS's WebSocket 伺服器設定 與此無關，可以保持關閉。

搭配直播結束謝幕名單使用

直播前，設定謝幕名單的 觸發模式 為 背景收集。這樣即使謝幕名單瀏覽器來源關閉，應用程式也能收集聊天參與者、會員與贊助者。
使用相同工作階段 ID，將產生的謝幕名單 URL 新增至 OBS 結束場景。
直播結束時，先切換至結束場景，使謝幕名單瀏覽器來源完成載入與連線。
選擇 開始致謝名單 ，位於 OBS 控制停駐面板中。

開始前先載入： 背景收集可以在謝幕名單頁面關閉時運作，但開始、預覽與測試需要已連線的謝幕名單瀏覽器來源才能顯示內容。

請參閱捲動致謝名單指南了解收集模式、篩選器及姓名缺漏的疑難排解。

各謝幕名單按鈕的功能

按鈕	結果
開始致謝名單	播放實際收集的名單。
預覽	播放真實名單，但不消耗頁面收集的項目。
測試謝幕名單	顯示內建的參與者、會員與贊助者範例。這並不能證明已收集真實姓名。
重設已儲存的謝幕名單	清除目前 Social Stream 工作階段儲存的背景收集資料。

商品與支持連結

在 Social Stream 中，開啟營利，儲存並啟用商品，然後選擇 開啟 OBS 控制停駐面板。將該私人控制 URL 複製至 OBS 的自訂瀏覽器停駐面板。若只需要商品停駐面板，請使用 obs-control-dock.html?session=YOUR_SESSION_ID&commerce.

Keep Social Stream on and use the generated Product Controls link. Add the separate monetization overlay URL as an OBS Browser Source for viewers. The control dock is for you; never share its session URL with viewers.

OBS 商品控制項，包含已儲存商品選擇器、持續時間、顯示、下一個、隱藏商品、恢復排程與選取商品狀態

顯示： 選擇一個已儲存的商品並固定顯示。 下一個： 從目前商品前進至下一個。
隱藏商品： 隱藏推廣卡片；活動提醒仍會繼續。 恢復排程： 恢復已儲存的首個商品或輪播設定。
持續時間： 顯示、下一個與隱藏操作在指定秒數後恢復已儲存的排程。使用 0 可保持覆寫狀態，直到再次變更。
狀態： 在此區段開啟時每五秒重新整理一次。它回報 Social Stream 的選取，不代表 OBS 場景是否可見。連線中斷或未確認時，商品按鈕會停用，直到狀態再次可用。

停駐面板、彈出選單、Stream Deck 與 Event Flow 共用相同控制項。在 Social Stream 中編輯並儲存目錄。參閱商品控制項了解設定與自動化。

其他控制項及其所需頁面

精選聊天： 保持一般直播聊天停駐面板與精選疊加畫面連線至相同工作階段。
計時器： 如果需要顯示計時器，請讓計時器頁面保持連線至相同工作階段。
候補名單與抽獎： 先在 Social Stream 中設定候補名單；重設會清除目前項目。

如果 API 連線中斷，停駐面板會自動重新連線。綠色的 已連線 狀態僅確認控制連線；當命令要顯示內容時，目標頁面仍須開啟。

直接 API 範例

相同按鈕可以透過 HTTP GET 請求以指令碼呼叫：

https://io.socialstream.ninja/SESSION_ID/creditsStart
https://io.socialstream.ninja/SESSION_ID/creditsPreview
https://io.socialstream.ninja/SESSION_ID/creditsTest
https://io.socialstream.ninja/SESSION_ID/creditsReset

替換 SESSION_ID ，使用目前 Social Stream 工作階段。參閱指令與 API 或完整 API 沙箱了解更多操作。

疑難排解

需要工作階段： 使用 Social Stream 中完全相同的工作階段 ID，不包含單字 session=.
已中斷連線： confirm Social Stream is active and reopen the generated control link after changing connection settings.
謝幕名單提示沒有來源接受命令： 顯示結束場景，等待其瀏覽器來源載入，然後重試。
測試有效但開始播放為空： 測試使用內建姓名。直播前選擇背景收集，並確認一般聊天來源正在擷取。
精選聊天按鈕沒有可見效果： 確認直播聊天停駐面板與精選疊加畫面使用相同工作階段且已載入。