# Streamer.Bot 筆記

寫一下預防失億，英文不好再去重找資料好累。

:::danger
🚨 這邊只是寫一點基本操作，平常不太用到的東西我沒有講。
:::

## 初次執行
Q. 它是做什麼的？

A. 可以塞好塞滿的Bot設定軟體

> [軟體網址](https://streamer.bot/)

它東西真的太多，我講不完，總之就是能有個進階的聊天室管家！

下載之後直接解壓縮就可以用了，但這個Bot只有在開啟這個軟體時才運作。

打開執行輸入`shell:startup`並把軟體的捷徑放進去，就可以開機自己啟動。

<center>


用`Win+R`就可以開這個視窗了


然後把捷徑丟進去就好了(exe按住Alt之後拖進去)

</center>

:::info
記得要用最小化，不要把它關掉。
:::

## 連結資料

### 直播平台


首先進到Platforms登入帳號，我本身是圖奇播，所以就登圖奇帳號，也有YT的可以登入。

### OBS聯動

---


如果有需要OBS的聯動，要進到OBS的工具->**WebSocket 伺服器設定**，確認連接埠及密碼。

並在Streamer.Bot找到Stream Apps->OBS，在它空白的區域上按右鍵**Add**。

接著就是設定的部分了！

**Name**只是用來給Streamer.Bot**分辨**使用。

如果**OBS不是在其他主機上**，**Host**請不要改。

如果OBS的伺服器設定上連接埠是**4455**，版本請選擇**v5.x**，**4444**是**v4.9x**。

最後輸入在OBS伺服器設定的密碼在**Password**欄位就好，如果沒有密碼可以留空。

如果想在每次打開Streamer.Bot時它都**自動連接OBS，把下面兩個勾勾都勾起來**。

### Websocket設定


如果有Warudo之類的應用程式接收Websocket訊息的客戶端，在**Websocket Clients**新增即可。

勾選可以自動在程式啟動時自動連接、在沒連線的時候自動重連。

**Websocket Server**的部分也可以自動啟動。

## 聊天機器人

:::warning
1. 我這篇教學沒有使用額外帳號，都以主播帳號發訊息，如果有額外帳號，請記得給予機器人帳號**Mod**。

2. ~~使用twitch公告的格式發訊息，不會被聊天室擷取，不用特別去擷取的腳本內隱藏，後續查紀錄都沒有，不擔心常常被機器人訊息刷掉紀錄了，<u>**以下內容我都用它**</u>。~~

3. 更新: twitch的公告指令手機是看不到的，使用時還請注意。
:::

在這個軟體Actions包含觸發條件(**Triggers**)及結果(**Sub-Actions**)，觸發條件達成後就會執行結果，所有的添加方式都是在**對應的區域**使用**滑鼠右鍵**就可以從列表選擇想要的功能。

只要沒有額外新增Actions的排程(**Queues**)，它們都會即時觸發。

<center>


如果有需要在軟體內放提示音或warudo的動作怕卡住，可以新增一個**Blocking**的排程。<br>這樣會觸發完整動作後才繼續下個動作，還能添加delay在最後面把間格拉長，也可以藉此方式進行分組排程。

</center>

### 變數查詢方式

---

要怎麼讓機器人知道觸發條件的是誰呢？

這就需要知道怎麼使用變數了！


<Center>官網的文件位置在這裡</Center>
<br>


<Center>接著點一下API，或直接連進下面的triggers就好了</Center>
<br>


<Center>左邊這裡可以快速選到想要的區域，中間就可以選擇想要了解的功能了</Center>
<br>


<Center>選取功能後，可以選擇想找的分類</Center>

<br>

**Name**就是變數的名稱，**Type**除非寫Code不然可以不用看。

**Description**就是這個變數的說明，**Example**則是顯示的結果。

---
一般的使用方式分兩種，一種是塞到聊天訊息內，一種是明指的變數判斷。

兩者的區別只是格式不同而已。

<center>


聊天訊息需要在前後塞入`%`這個符號就行了。


如果有明指是**變數**的地方就不需要塞符號了。

</center>

### 分組

---

不管是Actions、指令、忠誠點數，都可以使用分組讓切換功能時不用太多行。

只需要在Group的位置上輸入名字就可以建立分組了。

也可以用右鍵選單更換、編輯視窗替換。


### 初見、打招呼 (if/else判斷)

---

使用的觸發條件在這裡(<u>Twitch->General->First Words</u>)

但要注意的是這個觸發條件預設是清除緩存時間後的第一次發言。

清除緩存的時間設定在**上面選單**，<u>Platforms->Twitch->Settings</u>，預設是12個小時。

也就是說發言後的12個小時內不管間隔多長或有沒有重開直播，都不會被視為第一次發言。

> 那要如何在執行Sub-Action時判斷是不是初見呢？

這就要使用<u>Core->Logic->If/else</u>了，接著要找到分辨[是不是初見](https://docs.streamer.bot/api/triggers/twitch/general/first-words)的變數。

<Center>


這一個就是了！</Center>

<br>

<Center>


想在公告tag他就用這個！</Center>

<br>

<Center>


如果是頻道的第一條訊息就繼續執行現在這個Action，如果不是就中斷(不會執行下一行之後)。</Center>

<br>

<Center>


判斷過後就是回覆訊息了，接在判斷條件下面就好了！</Center>

<br>

> 判斷一定要放在最上面喔，因為要條件判斷之後才會繼續執行Action！
> 如果是反向(firstMessage=false)則是每次開播時的自動打招呼，~~再也不擔心有人騙初見了。~~

:::danger
🚨 如果需要排除自己，或bot帳號，還得在最上面外加一條。
:::


### 追隨、揪團推薦 (隨機訊息、觸發條件修改)

---

觸發的條件慢慢找位置就可以了，下面我就不講了。

隨機訊息的部分分為兩種，一種是整個動作隨機，一種是群組內隨機。

<Center>


直接在動作列表上隨機！如果沒有其他內容時可以用，但機率是一樣的。</Center>

<br>

<Center>


群組隨機！<br>適用於動作內有其他內容，可以調整機率。</Center>

<br>

<Center>


除了隨機外還有權重(機率)可以改。<br>兩則訊息除了各0.5、各1.0，還能改0.9和0.1(90%&10%)等等。</Center>

---
揪團對於上面的觸發條件就不一樣了，可以設定範圍。

<Center>


小於10以內的揪團人數(不輸入最小值)</Center>

<br>

<Center>


10~29的的揪團人數(區間)</Center>

<br>

<Center>


30以上的揪團人數(不輸入最大值)</Center>

<br>

<Center>


分開3個條件設定結果</Center>

<br>

<Center>


加上自動推薦就像這樣</Center>

<br>

> 如果會加shoutout的話可以新增一個揪團用的Blocking排程組，並添加至少120秒的delay，就不會出現沒辦法推薦的問題了。


### 指令

---

指令需要在Commands新增才可以被Action觸發。


**Name**是分辨使用，具體輸入的指令在**Commands**，也可以使用多行當別名，甚至可以輸入關鍵字就觸發。

**Mode**的部分一般使用**Basic**就好，**Location**就是指令使用的方式。

- Start - 一定要指令開頭的訊息才會觸發
- Exact - 訊息只有指令內容時才觸發
- Anywhere - 只要包在訊息內就觸

**Options**的部分如果不用記數什麼的，可以只留第一個勾就好。

**Source**的部分可以選擇平台聊天室訊息使用(message)或私訊(Whisper)。

**Cooldown**就是使用這個指令的冷卻時間，分別是全體成員(Global)及單一使用者(User)。

**Premissions**的部分，如果預設全部的人都能用就是維持allow->allowed空白。

需要Mod才能用就選取Mod之後按一下`>>`就好，也可以指定使用者才能使用指令。

---

新增好指令之後就是使用Actions給指定觸發條件了(<u>Core->Commands->Command Triggered</u>)！


### 定時訊息

---

定時訊息要先建立一個定時器，觸發條件裡建立就好了(<u>Core->Timed Actions</u>)。

<Center>


我的設定，記得如果兩項都有設定就會同時達成才觸發</Center>

<br>


### 忠誠點數

---

> 建議是把原本的忠誠點數項目刪除之後重新添加，才可以在軟體內管理。

位子會在(<u>Platforms->Twitch->Channel Point Rewards</u>)

這邊一開始會匯入Twitch原有的項目，並添加紫色背景，但是無法修改其內容。

<Center>


匯入的忠誠點數項目無法編輯。</Center>

<br>

<Center>


建立過後，才可以編輯。</Center>

<br>

可以配合OBS更換場景之後自動暫停指定忠誠點數的兌換，或者兌換後的訊息回覆。

<Center>


可以使用多個觸發條件</Center>

<br>

<Center>


兌換後的回覆訊息</Center>

<br>

## 結語

到這邊基本的內容就差不多了～

這軟體的功能應該可以說是現成的機器人裡面功能最完善的了(吧?)，之後應該不會有其他變動。

官方的論壇也有[可以添加的額外項目](https://extensions.streamer.bot/)，比如YT版的忠誠點數，都可以看看。

有問題可以在下面問，就是程式碼的部分我應該不會XD

> [我的個人連結](https://nagongze.carrd.co)