指南

1. 安裝

使用Social Stream Ninja前需要先安裝。瀏覽器擴充功能有多種安裝方式：

• 手動安裝（建議）： 若要使用最新版本，請在開發人員模式中手動安裝。
• Chrome線上應用程式商店： 透過Chrome線上應用程式商店安裝，設定最為簡單。

詳細安裝說明請造訪 下載頁面.

2. 基本設定

安裝後，請依下列步驟開始使用Social Stream Ninja：

1. 在瀏覽器中開啟直播平台的聊天（如果支援，也可使用彈出聊天功能）
2. 點選瀏覽器工具列中的Social Stream Ninja擴充功能圖示
3. 點選「Enable Extension」啟用擴充功能（圖示應變為綠色）
4. 開啟擴充功能彈出選單提供的「Dashboard Link」
5. 在OBS中將「Overlay Link」作為瀏覽器來源開啟

3. 連接不同平台

Social Stream Ninja支援100多個平台。以下是連接常用平台的方法：

文字轉語音

Social Stream Ninja可以使用文字轉語音技術朗讀聊天訊息：

設定文字轉語音：

1. 新增 &speech=en-US 到featured.html或dock.html的URL
2. 對於其他語言，請選擇支援該語言的提供者和聲音。例如，葡萄牙語可使用Piper &pipervoice=pt_BR-faber-medium 或eSpeak &espeakvoice=pt-br，而西班牙語可以使用Piper &pipervoice=es_ES-davefx-medium 或eSpeak &espeakvoice=es.
3. 使用以下參數自訂語音設定： &pitch=1&volume=1&rate=1

免費的本機文字轉語音選項（不需API金鑰）：

• Kokoro TTS： 瀏覽器內建AI，效果出色 — &ttsprovider=kokoro
• Piper TTS： 快速、輕量的神經網路文字轉語音 — &ttsprovider=piper
• eSpeak-NG： 輕量級的語言備用方案，包括葡萄牙語 &espeakvoice=pt-br 以及西班牙語 &espeakvoice=es
• Kitten TTS： 占用最小，僅需CPU — &ttsprovider=kitten
• 自行代管的伺服器： 透過Docker在本機執行Kokoro-FastAPI或openedai-speech — &ttsprovider=openai&openaiendpoint=http://localhost:8880/v1/audio/speech

優質雲端文字轉語音選項：

• Google Cloud TTS： 專業級聲音（需要Google API金鑰）
• ElevenLabs： 超逼真聲音，支援自訂聲音訓練
• Speechify： 自然的優質聲音

AI搭檔、聊天機器人和瀏覽器助理

Social Stream Ninja可以用多種方式使用AI。請先選擇工作流程，再選擇提供者。

• 語音搭檔： 透過麥克風交談，同時讓即時聊天提問進入同一個搭檔工作階段。
• ChatGPT瀏覽器助理： 擷取聊天，或透過實驗性功能將聊天轉送到已開啟的 chatgpt.com 分頁，不需API金鑰。
• 主要聊天機器人： 在疊加畫面中、透過文字轉語音或在支援的聊天中回覆選取的觀眾。
• 處理工具： 內容管理、翻譯、摘要、RAG知識搜尋和AI建立的疊加畫面。

選擇AI設定

訊息排隊與置頂

安排訊息在疊加畫面中的顯示方式：

訊息排隊：

1. 按住CTRL（Mac上為Cmd）並點選儀表板中的訊息
2. 點選「Next in Queue」按鈕，逐則顯示訊息
3. 訊息將依排隊順序出現在疊加畫面中

置頂訊息：

1. 按住ALT並點選儀表板中的訊息
2. 訊息將保持置頂在儀表板頂端
3. 若要取消置頂，請按住ALT並再次點選已置頂訊息

直播事件擷取

從直播平台擷取新追隨、訂閱、揪團和贊助等非聊天事件。

啟用方法：

1. 點選Social Stream Ninja擴充功能圖示
2. 找到 「擷取直播事件」（Capture Stream Events） 設定中的開關
3. 啟用後即可開始接收提醒

各平台可擷取的事件：

有關完整的事件酬載和資料欄位清單，請參閱 事件參考 文件。

Hype Train頂端列

在OBS中以Twitch風格的頂端列顯示Hype Train和Treasure Train的進度。

• 從彈出選單複製專用的Hype Train Top Bar連結。
• 正式直播前，使用Fake Hype Train按鈕進行測試。
• 請參閱指南中的設定步驟、螢幕截圖和疑難排解。

開啟Hype Train頂端列指南

首次發言者

醒目顯示首次發言者，加入選用的葉子徽章，或只在首次發言時播放停駐面板提示音。

• 保持本機訊息資料庫啟用。
• 開啟首次發言者偵測。
• 選擇適合疊加畫面的醒目提示、徽章和提示音選項。

開啟首次發言者指南

Event Flow 編輯器

Event Flow編輯器是強大的節點式自動化系統，可用於建立自訂工作流程。它提供進階自動化功能，讓您編寫自己的路由邏輯。

可以做什麼：

• 在平台之間轉送聊天 透過智慧篩選（例如將Twitch轉送到Discord，但封鎖指令）
• 建立自訂指令 透過AND／OR／NOT邏輯閘
• 觸發疊加畫面和音訊 根據指定事件或關鍵字
• 控制OBS 自動控制場景和來源
• 建立抽獎和贈獎活動 並管理佇列

入門：

1. 從主儀表板選單開啟Event Flow編輯器
2. 建立新流程並加入來源節點（如「Twitch Message」）
3. 連接邏輯節點以篩選訊息（Contains Keyword、User Role等）
4. 加入回應的動作節點（Send Chat、Play Audio、Display Overlay）
5. 正式直播前，使用內建模擬器進行測試

Flow Actions疊加畫面：

若要讓音訊、媒體疊加畫面和OBS動作生效，需要將Flow Actions頁面作為瀏覽器來源加入OBS：

1. 在彈出選單中找到「Flow Actions」區段並複製URL
2. 在OBS中將其加入為瀏覽器來源（建議1920×1080）
3. 保持疊加畫面開啟（可以隱藏，但不要關閉）

MIDI 與快速鍵控制

透過Stream Deck、MIDI控制器或鍵盤快速鍵直接控制Social Stream Ninja。

設定MIDI：

1. 連接MIDI裝置（Stream Deck、MIDI控制器等）
2. 開啟Social Stream Ninja彈出選單
3. 找到MIDI設定區段
4. 從下拉選單中選擇MIDI裝置
5. 將MIDI音符對應到指定動作

可用動作：

• 觸發自訂疊加畫面和媒體
• 傳送預設聊天訊息
• 切換OBS場景
• 播放音訊片段或文字轉語音
• 執行Event Flow觸發器

機器人指令與自動回覆

為聊天建立互動式機器人指令和自動回覆。

內建指令：

• !joke - 傳送一則隨機的科技冷笑話
• !hi - 自動問候觀眾
• !cycle - 允許觀眾切換OBS場景（需要權限）

設定自動回覆：

1. 開啟擴充功能彈出選單並找到Bot／Auto-Response區段
2. 啟用需要的指令
3. 保持聊天視窗可見，不要最小化，才能讓回覆生效
4. 確認已登入平台並具有發言權限

建立自訂指令：

對於更複雜的指令，請使用Event Flow編輯器：

1. 建立一個使用Message來源的新流程
2. 加入「Contains Keyword」節點來偵測指令（如「!social」）
3. 連接一個「Send Chat」動作並填寫回覆
4. 可加入User Role篩選器，將指令限制為僅管理員可用

Webhook與整合

連接外部贊助平台，在直播疊加畫面中顯示贊助和購買。

必要條件：

1. 記下擴充功能彈出選單中的工作階段ID
2. 保持Social Stream Ninja啟用
3. 位於 Global settings and tools → Mechanics，啟用 擴充功能的遠端 API 控制
4. 使用正常產生的停駐面板和疊加畫面連結；不要加入 &server, &server2，或 &server3 用於贊助Webhook
5. 如果停駐面板已經開啟，請重新載入一次

只需啟用一個API開關： 遠端API控制允許背景指令碼標準化贊助Webhook，並像一般訊息一樣傳遞。其他API傳輸開關可以保持關閉。

標準化後的贊助會共用給聊天、提醒、Event Flow，以及贊助罐／目標進度條。

支援的平台：

Stripe設定：

1. 建立一個 Stripe付款連結
2. 重要： 為付款連結加入自訂欄位：
   • 顯示名稱 或 使用者名稱 （必填）- 缺少此欄位會拒絕贊助
   • 訊息 （選填）- 允許贊助者留言
3. 前往 Stripe Webhooks 並建立新的端點
4. 將URL設定為： https://io.socialstream.ninja/YOUR_SESSION_ID/stripe
5. 選擇事件： checkout.session.completed
6. 不需簽章驗證（請改為保密工作階段ID）

測試： 使用Stripe測試模式，卡號為 4242 4242 4242 4242、任意未來到期日期和任意CVC。

創作者商店設定

使用 圖文設定指南 適用於Fourthwall、Ko-fi和Buy Me a Coffee，包括接收狀態、獨立預覽和商品匯入。

透過Webhook匯出聊天：

您也可以將聊天資料匯出到外部服務：

• 在設定中配置傳出Webhook URL
• 聊天訊息以包含JSON酬載的POST請求傳送
• 使用此功能記錄聊天、觸發外部自動化或與其他工具同步

1. 安裝

與瀏覽器擴充功能相比，獨立應用程式的安裝過程更簡單：

• Windows： 下載並執行Windows 10／11（x64）安裝程式
• macOS： 下載並執行macOS應用程式
• Linux： 大多數Linux發行版可使用AppImage檔案

詳細安裝說明請造訪 下載頁面.

2. 基本設定

安裝後，請依下列步驟開始使用Social Stream Ninja獨立應用程式：

1. 啟動Social Stream Ninja應用程式
2. 點選左側欄中要加入的平台對應的按鈕
3. 依提示輸入使用者名稱、Video ID或URL
4. 點選「Activate source」或「Select Live Sources」進行連接
5. 複製「Streaming Chat」連結，並在OBS中加入為瀏覽器來源

3. 連接不同平台

獨立應用程式簡化了各個平台的連接：

4. 影片教學

觀看以下影片，瞭解獨立應用程式的使用流程：

TikTok 指南

需要TikTok設定、回覆、連線模式或TikFinity備用方式的協助？請使用專門的TikTok指南。

• 應該選擇哪種模式：TikTok WS＋Auto、Standard、Local Signer、Polling、Euler Proxy或Euler Signing
• 如何從SSN回覆TikTok聊天
• 如何透過Other chat sites使用TikFinity OBS Dock作為備用方式
• TikTok顯示您離線、漏收訊息、聊天重複或關閉驗證視窗時，可嘗試的方法

開啟TikTok指南

雙向聊天

獨立應用程式在支援的平台上提供雙向聊天訊息功能：

• 直接從儀表板傳送訊息
• 訊息會同時出現在所有已連接的平台
• 使用機器人指令和自動回覆

YouTube自訂專案設定

如果希望桌面應用程式使用您自己的YouTube API配額，請參閱專門的設定指南。其中介紹Google Cloud設定、正確的重新導向URL、API金鑰限制和基本安全建議。

開啟YouTube專案設定指南

Hype Train頂端列

使用專用的Hype Train Top Bar連結，在OBS中顯示Twitch Hype Train和Treasure Train的進度。

• 從彈出選單複製Hype Train Top Bar URL。
• 自訂對齊、縮放、不透明度和背景設定。
• 使用Fake Hype Train按鈕進行測試。

開啟Hype Train頂端列指南

首次發言者

使用首次發言者偵測來醒目顯示新觀眾、顯示葉子徽章，或僅在首次發言時觸發提示音。

• 保持本機訊息資料庫啟用。
• 開啟首次發言者偵測。
• 請參閱指南中的設定步驟、螢幕截圖和疑難排解。

開啟首次發言者指南

LLM整合

桌面應用程式支援相同的AI提供者工具，包括：

• 語音搭檔： 結合麥克風對話、即時聊天提問和語音回覆。
• 主要機器人和私人機器人： 公開聊天回覆，或獨立的一對一助理。
• AI處理： 內容管理、翻譯、摘要和RAG知識搜尋。
• 提供者選擇： 本機模型、自行代管端點或支援的雲端API。

開啟完整AI指南

直播事件擷取

擷取新追隨、訂閱、揪團和贊助等非聊天事件。

啟用方法：

1. 開啟Social Stream Ninja應用程式
2. 進入設定並找到 「擷取直播事件」（Capture Stream Events）
3. 啟用後即可開始接收提醒

可擷取的事件：

• YouTube： 會員、Super Chat、訂閱人數
• Twitch： 訂閱者、追隨者、Bits、揪團、頻道點數
• TikTok： 追隨者、禮物、觀眾人數
• Kick： 訂閱、贊助和追隨提醒

請參閱 事件參考 ，其中包含完整的事件酬載文件。

Event Flow 編輯器

使用節點式Event Flow編輯器建立強大的自動化流程。

可以做什麼：

• 轉送聊天 透過智慧篩選在平台之間轉送
• 觸發疊加畫面和音訊 根據事件或關鍵字
• 控制OBS 自動控制場景和來源
• 建立自訂指令 透過邏輯閘（AND／OR／NOT）
• 建立抽獎和遊戲 並管理佇列

入門：

1. 從應用程式選單開啟Event Flow編輯器
2. 建立包含來源節點的流程（Message、Timer、Manual Trigger）
3. 加入邏輯節點進行篩選（Contains Keyword、User Role等）
4. 連接動作節點（Send Chat、Play Audio、Display Overlay）
5. 正式直播前，使用模擬器進行測試

Flow Actions疊加畫面：

在OBS中將Flow Actions URL加入為瀏覽器來源，讓音訊和疊加畫面動作生效。此URL位於應用程式的「Flow Actions」區段。

MIDI 與快速鍵控制

透過Stream Deck、MIDI控制器或鍵盤快速鍵直接控制應用程式。

設定方法：

1. 連接MIDI裝置
2. 開啟設定並找到MIDI區段
3. 從下拉選單中選擇裝置
4. 將MIDI音符對應到動作

可用動作：

• 觸發疊加畫面和媒體
• 傳送聊天訊息
• 切換OBS場景
• 播放音訊片段
• 執行Event Flow觸發器

Webhook與整合

連接外部贊助平台和服務。

支援的整合：

• Stripe： 付款事件
• Ko-Fi： 贊助提醒
• Buy Me A Coffee： 贊助
• 自訂Webhook： 任何HTTP POST服務

設定：

1. 在應用程式設定中找到Webhook轉送URL
2. 將其加入贊助平台的Webhook設定中
3. 事件會自動出現在儀表板和流程中