直播商品與觀眾連結 | Social Stream Ninja

五步新增商品

哪些連結會自動載入？ 公開的 Gumroad、itch.io、Ko-fi、Buy Me a Coffee 和 Fourthwall 頁面。其他連結可能需手動填寫。無需商店帳戶。完整匯入支援 Shopify 和 Fourthwall.

Shop、Gift、Support 和 Join 只是連結標籤，不改變付款統計。卡片是快照，真實價格和庫存以結帳頁面為準。

加入 商品與支持連結 覆蓋層至 OBS（商品展示與提醒 也顯示提醒）。然後使用以下按鈕：

設定 顯示／隱藏秒數 。 0 表示保持到手動更改；1–3600 表示經過對應秒數後恢復排程。

實用說明

想在 OBS 內用按鈕？使用 OBS 商品控制停駐面板。不要把控制介面放到觀眾覆蓋層上。

商品 QR 碼指向這裡，商品離開螢幕後觀眾仍能找到。儲存和即時控制會更新同一連結。頁面每 15 秒重新整理，標記精選商品，即使卡片隱藏也列出全部商品。

我想要…	執行操作
下架頁面	點選取消發布。舊連結失效，QR 碼恢復指向各商品原來的連結。
找回相同連結	從同一電腦重新發佈。

保留 SSN 設定檔。 其中儲存著更新或刪除頁面所需的私密金鑰。

SSN 離線或伺服器中斷時

新增 預設命令 按鍵，來自 商品與支持：Show product、Next product、Hide products 或 Resume products。
對於 顯示商品，點選 重新整理商品和狀態 並選擇商品，也可貼上公開連結，或留白使用目前或首個商品。
對於 下一個 和隱藏，可按需加入秒數。

選用的 商品狀態 按鍵顯示已選擇、已隱藏或已排程的狀態，每五秒更新，長名稱會縮短。按鍵使用現有 P2P 或 WebSocket 連線，並等待 SSN 確認。

這些操作只改變顯示內容。 不會建立捐款、購買、聊天發言或付款觸發器。

工作階段遠端 API 接受 show, next, hide，或 resume. 主持人控制 必須開啟。省略 url ，以使用目前或首個商品。

{"action":"commerceControl","command":"show","url":"https://example.com/product","seconds":30}

切勿分享私人工作階段或控制連結。 向觀眾提供觀眾連結。

確認控制何時完成

指令僅傳送現有的 monetization_update 顯示狀態。 hasDonation 行為不變。
Products & Support 操作等待 SSN 回覆後才繼續流程。
在事件資料中， meta.commerceControlResult 包含 success ，再加上新的 commerce 狀態或一個 error.
失敗會停止同一操作鏈後面的動作。原始購買或打賞仍會送達其他流程和覆蓋層。
結果確認 SSN 的選擇、隱藏狀態或排程，不確認 OBS 是否正在顯示。
八秒內無回應即逾時。控制可能已經生效，再按 Next 前先檢查彈出選單或控制面板。
外部遠端用戶端應使用請求／回應協定並檢查結果，不能假設送出指令就已成功。
其他操作回報自己的結果：Print Thermal Label 提供 meta.thermalPrintResult （送出工作不等於已列印）；同步 Webhook 操作可回傳 HTTP 狀態和回應，並在失敗時停止。這些是操作結果，不是新的付款事件。

請參閱事件參考，查看完整結果格式。

問題	試試這個
Show now 呈灰色	點選儲存設定。
即時修改自行恢復了	SSN 已重新啟動或秒數已到期。設定顯示／隱藏秒數為 `0` 以保持設定。
Load details from link 未找到內容	手動填寫詳細資訊。
觀眾頁面顯示舊商品	保持 SSN 開啟以便重試，並檢查彈出選單中的錯誤。
Event Flow 操作逾時	操作可能已經成功，請先檢查彈出選單或控制面板，再重試。