SinusBot
隨附於 Macro Deck控制 SinusBot 執行個體的音樂,並在面板上顯示正在播放的內容。
兩個正在播放曲目的音樂播放器小工具,一個為「完整封面」樣式,一個為「小封面」樣式,標題列都有 SinusBot 的名稱和標誌
- 在任何 SinusBot 執行個體上播放、暫停、跳過和跳轉
- 設定音量、隨機播放和重複播放
- 播放機器人音樂庫中的曲目
- 在音樂播放器小工具中顯示正在播放的曲目
- 可加入任意數量的機器人執行個體
SinusBot 是在自己的伺服器上執行、適用於 TeamSpeak 和 Discord 的音樂機器人。SinusBot 整合會將 Macro Deck 連線到 SinusBot 網頁介面,因此可以控制機器人執行個體播放的內容,並在面板上查看目前的曲目。只要 Macro Deck 能透過網路連到 SinusBot,無論是在同一台電腦、區域網路或伺服器上,都可以使用。
可以做什麼
- 播放、暫停、切換播放狀態、跳到下一首或上一首,以及跳到目前曲目中的某個位置。
- 設定、提高或降低音量,開啟或關閉隨機播放,以及開啟或關閉重複播放。
- 使用 Play Track 播放機器人音樂庫中的特定曲目。將曲目留空,即可在按下按鈕時再選擇。
- 在 Macro Deck 的 音樂播放器 小工具中顯示正在播放的曲目、演出者和封面,並透過變數在標籤中使用機器人的曲目、播放位置和音量。
設定範例:
- 為 TeamSpeak 頻道中的機器人放一排按鈕,分別使用 Previous Track、Toggle Play/Pause 和 Next Track。播放按鈕會顯示機器人是否正在播放。
- 將滑桿繫結到機器人的音量變數
sinusbot_<instance>_volume,說話時就能調低音樂。 - 為每個機器人放一個 音樂播放器 小工具,旁邊的按鈕透過
music_player_<player>_album_color變數讓顏色跟隨封面變化。
多個機器人與運作方式
每個要控制的 SinusBot 執行個體都是一個設定。可以加入任意數量的設定,也包括不同伺服器上的執行個體,並在每個動作的 Player 欄位中選擇執行個體。將 Player 留空時,動作會控制第一個執行個體。每個設定都有自己的一組變數,以設定名稱命名,例如 sinusbot_<instance>_volume。
Macro Deck 會在建立設定時檢查連線,並載入機器人的執行個體。執行期間會定期讀取播放狀態。機器人短暫無法連線時,面板會繼續顯示上一首曲目;持續無法連線時,sinusbot_<instance>_is_connected 變數會顯示為 false,動作在機器人再次回應之前都不會有作用。
需要準備
- 執行中的 SinusBot,且 Macro Deck 能連到其網頁介面,例如
http://your-bot:8087。 - SinusBot 的使用者名稱和密碼。
- 在 SinusBot 網頁介面中至少建立一個執行個體。
開始設定
步驟 1: 檢查 SinusBot 網頁介面
在瀏覽器中開啟 SinusBot 網頁介面並登入。記下含連接埠的位址,例如
http://192.168.1.20:8087,並確認至少有一個執行個體。步驟 2: 開啟 SinusBot 整合
在 Macro Deck 的側邊欄中按一下 整合,然後按一下 SinusBot。在 概覽 分頁的 設定 區段中按一下 新增設定。開啟右上角的開關也會開啟相同的對話方塊,設定完成後此整合就會啟用。
步驟 3: 輸入伺服器和登入資訊
在 連線到 SinusBot 對話方塊中輸入:
- 伺服器網址:SinusBot 網頁介面的位址,包含連接埠。
- 使用者名稱 和 密碼:登入 SinusBot 所用的帳戶。
按一下 繼續 後,Macro Deck 會測試連線並載入執行個體。
步驟 4: 選擇執行個體
在 選取執行個體 中,於 執行個體 下選擇機器人執行個體,然後按一下 繼續。設定會儲存為 SinusBot,後面以括號附上執行個體名稱。要控制其他執行個體時,請重複這些步驟。
步驟 5: 在按鈕上加入動作
在 面板 頁面上按一下一個按鈕。面板必須處於解鎖狀態:右上角顯示 鎖定 按鈕時,即表示已解鎖。編輯器開啟時會選取 短按。按一下 + 新增動作,在 新增動作 對話方塊左側選擇 SinusBot,選擇 Toggle Play/Pause,然後在 Player 下選擇執行個體。
步驟 6: 按下按鈕
在面板上按下按鈕。機器人會開始或暫停播放,按鈕則會顯示目前狀態。設為該執行個體的 音樂播放器 小工具會顯示正在播放的曲目。
動作13
可放在按鈕上,或從流程中執行。
- Play
- 繼續播放。
- Pause
- 暫停播放。
- Toggle Play/Pause
- 在播放和暫停之間切換,並在按鈕上顯示目前狀態。
- Next Track
- 跳到下一首。
- Previous Track
- 跳到上一首。
- Refresh State
- 立即重新讀取目前的播放狀態。
- Set Volume
- 設定播放音量(0 到 100%)。
- Volume Up
- 將播放音量提高 10%。
- Volume Down
- 將播放音量降低 10%。
- Seek
- 跳到目前曲目中的某個位置,以秒為單位。
- Toggle Shuffle
- 切換隨機播放,或將其開啟或關閉。
- Set Repeat Mode
- 開啟或關閉重複播放。SinusBot 只有一種重複模式,因此兩個重複選項都會將它開啟。
- Play Track
- 播放機器人音樂庫中的曲目。留空即可在按下按鈕時選擇曲目。
觸發器7
按鈕或流程可以對這些事件做出反應。
- 曲目已變更
- 開始播放另一首曲目(位於 音樂播放器 下)。
- 播放已開始
- 播放已開始或已繼續(位於 音樂播放器 下)。
- 播放已暫停
- 播放已暫停(位於 音樂播放器 下)。
- 播放已停止
- 播放已停止(位於 音樂播放器 下)。
- 音量已變更
- 機器人的音量已變更,並附上新值和先前的值(位於 音樂播放器 下)。
- 播放器已連線
- 機器人執行個體已可連線(位於 音樂播放器 下)。
- 播放器已中斷連線
- 機器人執行個體已無法連線(位於 音樂播放器 下)。
變數8
在按鈕和小工具上顯示這些值,或在條件中使用。
sinusbot_<instance>_current_track_name,sinusbot_<instance>_current_artist,sinusbot_<instance>_current_album- 目前的曲目及其演出者。SinusBot 不會回報專輯,因此
sinusbot_<instance>_current_album會保持空白。 sinusbot_<instance>_playback_state,sinusbot_<instance>_is_playing- 機器人是正在播放、已暫停還是已停止。
sinusbot_<instance>_volume- 以百分比表示的播放音量。也可以設定此值,例如使用滑桿。
sinusbot_<instance>_track_duration,sinusbot_<instance>_current_position,sinusbot_<instance>_progress_percentage- 曲目的長度和以秒為單位的播放位置,以及以百分比表示的播放進度。設定位置即可跳轉。
sinusbot_<instance>_album_art_url- 目前封面的位址。
sinusbot_<instance>_device_name- 機器人執行個體的名稱。
sinusbot_<instance>_shuffle_enabled,sinusbot_<instance>_repeat_mode- 隨機播放和重複播放是否已開啟。
sinusbot_<instance>_is_connected- Macro Deck 是否能連到機器人執行個體。
常見問題
可以控制多個機器人嗎?
可以。每個 SinusBot 執行個體新增一個設定,不同伺服器上的也可以。每個動作都有 Player 欄位,用來指定要控制的執行個體,而每個設定都有自己的變數。
SinusBot 必須在同一台電腦上執行嗎?
不必。Macro Deck 會透過網路與 SinusBot 網頁介面通訊,因此只要 Macro Deck 能連到其位址,機器人就可以在伺服器或其他電腦上執行。
設定時顯示找不到執行個體,該怎麼辦?
該帳戶沒有可使用的執行個體。請先在 SinusBot 網頁介面中建立執行個體,然後重新建立設定。
機器人離線時會怎麼樣?
短暫中斷不會清空面板:上一首曲目會保留一段時間。機器人持續無法連線時,sinusbot_<instance>_is_connected 變數會顯示為 false,而 Macro Deck 會持續嘗試連線。
密碼儲存在哪裡?
密碼會加密儲存在電腦上,只用於登入 SinusBot。
更多「聊天和語音」整合
Discord
隨附於 Macro Deck從面板在 Discord 中靜音、拒聽、加入語音頻道、變更語音設定,以及透過 Webhook 張貼訊息。
Discord Webhook
隨附於 Macro Deck透過 Webhook 將含有嵌入內容和提及的豐富訊息發布到 Discord 頻道,並提供即時預覽。