Streamer.bot 整合

Streamer.bot 為你的直播提供各種互動功能！你可以透過 TikFinity 的「動作與事件」系統觸發 Streamer.bot 動作，只需要設定一次。

初始設定

請下載最新版的 Streamer.bot，並啟用「Websocket Server」（位於「Server/Clients」分頁）。接著切換到 TikFinity，前往「設定」>「 Streamer.bot 連線」填寫連線資訊。大多數情況下，用預設值就可以了。點選「測試連線」確認連線是否正常。連線成功後，就可以在 TikFinity 的動作中使用 Streamer.bot 了。

使用 Streamer.bot 動作

在 TikFinity 前往「動作與事件」
點選「建立新動作」，然後選擇「Streamer.bot 動作」
選擇要觸發的 Streamer.bot 動作
點選「儲存」
為你的動作指定一個事件

另外請注意，觸發使用者的資訊（例如用戶名稱）會以預留位置參數的形式傳送，你可以在 Streamer.bot 中使用這些預留位置參數做進一步處理。依事件類型不同，可使用以下預留位置參數：

%userId% - TikTok 用戶 ID（數字）
%username% - TikTok 用戶名稱（@handle）
%nickname% - TikTok 暱稱（顯示名稱）
%profilePicturUrl% - 使用者大頭貼的 https 網址
%commandParams% - 使用者的留言，或寫在 !command 後面的參數
%giftId% - 禮物 ID（數字）
%giftName% - 禮物名稱
%coins% - 禮物事件中送出的金幣數
%repeatCount% - 禮物連送次數
%likeCount% - 按讚數
%totalLikeCount% - 使用者的累計按讚總數
%subMonth% - 訂閱月數（訂閱事件）
%emoteId% - 表情的 ID
%emoteImageUrl% - 表情的 https 網址

使用範例（Core -> File IO -> Write to File）：

從 Streamer.bot 傳送聊天訊息

你也可以透過 Streamer.bot 傳送訊息到你的 TikTok 聊天室。請前往 TikFinity 的聊天機器人設定，啟用「允許 Streamer.bot 推送訊息到 TikFinity」選項，接著建立一個 Streamer.bot 動作，並在 Sub-Actions 中加入以下步驟：

Core > Arguments > Set Argument： 建立一個名稱為「message」的變數，值就是你要傳送的訊息文字。你可以在訊息中使用上方列出的所有變數，例如用 %nickname% 提及觸發的使用者。
Core > C# > Execute C# Code: 複製並貼上以下程式碼，然後點選「Save and Compile」

using System;
using Newtonsoft.Json;

public class CPHInline
{
    public bool Execute()
    {
        CPH.WebsocketBroadcastJson(JsonConvert.SerializeObject(new { action = "sendChatbotMessage", args = args }));
        return true;
    }
}

看起來應該像這樣：

現在你可以觸發這個 Streamer.bot 動作，訊息就會傳送到你的 TikTok 聊天室。如果遇到任何問題，請透過 Discord 聯絡我們。