點歌系統 - ChiwaBots

點歌系統讓觀眾用聊天指令點 YouTube 上的歌，進入待播佇列，由整合播放器直接播出。你可以自訂佇列長度、每人上限與可點的範圍。

它解決什麼問題

背景音樂自己挑會膩，開放觀眾點又容易失控，重複的歌、一個人洗滿整排、點到根本不是音樂的影片。點歌系統把「開放」和「可控」放在一起：誰能點、能點多少、能點什麼範圍，全部有明確的閘門。

怎麼開始

啟用點歌模組，設定待播佇列上限與每人同時排隊數。
把播放器的 OBS 網址加進實況軟體。
視需要建立播放清單，把可點範圍限制在清單內。

播放清單與續播

播放清單是曲庫的分類方式，同一首歌可以同時屬於多個清單，而「全部歌曲」就是整個曲庫。設定目標播放清單之後，點歌與收藏都會掛到那個清單；佇列播完時也會從那個範圍隨機續播。不想續播就關掉，播完即停。

先審後播 (選用)

預設情況下觀眾點的歌會直接進待播佇列。開啟審核模式後，指令點歌、忠誠獎勵點歌與影片贊助點歌都會先進「審核」頁，由你 (或授權的 MOD) 核准才正式排入播放、拒絕即丟棄。適合開放點歌但想先過濾內容的場合。

常見誤解

YouTube 是歌曲來源，不是登入方式。 觀眾點的是 YouTube 影片，但 ChiwaBots 本身只支援 Twitch 登入，也不管理 YouTube 直播。
「僅限播放清單」會停用搜尋。 開啟後只接受清單內已有的歌，不會再去 YouTube 搜尋。這是把曲庫收斂成你審過的範圍，代價是觀眾不能點新歌。
「僅限音樂類別」擋的是 YouTube 的分類，不是你的主觀判斷。 它依 YouTube 對影片的分類過濾，所以偶爾會擋掉你覺得是音樂的東西，也可能放行你覺得不是的。
豁免身分是完全不受數量限制，不是上限加倍。 勾選的身分不受待播數量與每人上限管轄。
封鎖清單認影片 id，貼完整網址也可以。 系統會自動辨識，不用自己把 id 剪出來。
拒絕審核不會退還點數或款項。 拒絕忠誠獎勵點歌不退還已扣的忠誠點數，拒絕影片贊助點歌也不退款 (款項已入帳)；歌曲要核准後才會進待播播放。
字幕設定只管 YouTube 的 CC 字幕，而且 YouTube 會記住上次的選擇。 影片本身燒進畫面的字不是 CC，關不掉。選過顯示或隱藏之後改回「預設」，字幕會維持上次的狀態，不會回到 YouTube 原本的預設；想要固定的效果就直接選顯示或隱藏。

設定項目

以下內容取自後台介面的說明文字，與實際介面同步。

設定	說明
佇列上限	待播佇列最多可容納的歌曲數。
每人上限	每位觀眾最多可同時排隊的歌曲數。
僅限播放清單 (不搜尋 YouTube)	開啟後只接受目標播放清單內已有的歌曲 (未設定 = 全部歌曲)，不搜尋 YouTube。
僅限音樂類別	只接受 YouTube 音樂類別的影片。部分影片解析不到分類資料時，會被視為非音樂而拒絕。
目標播放清單	點歌與 !like 收藏會掛上此清單，佇列空續播也以此為範圍；未設定 = 全部歌曲。
自訂獎勵名稱	在 Twitch 建立忠誠點數自訂獎勵，把名稱填到這裡 (需完全相同)。觀眾兌換時輸入的歌名或 YouTube 網址會自動變成點歌。留空 = 不啟用。
點歌目標	點歌與收藏會使用此播放清單
這個清單還沒有曲目	用上方輸入框搜尋歌曲加入，或貼上 YouTube 播放清單網址整批匯入。
顯示進度條	關掉可把「純訊息」版型做成乾淨的一行字。
顯示播放時間	顯示「已播放 / 總長度」。贊助點歌的區間播放顯示的是買到的那一段，不是整支影片。
YouTube 字幕 (CC)	只控制 YouTube 的 CC 字幕，影片本身燒進畫面的字關不掉。
圓角 (px)	0 = 直角。外框與影片、訊息框、進度條會一起裁圓。
不受點歌上限限制的觀眾	被勾選的身分不受待播數量與每人上限限制。
佇列空了自動播放清單	待播佇列播完後，從播放清單隨機續播 (範圍依「目標播放清單」，未設定 = 全部歌曲)；關閉則播完即停。
離線時自動暫停	關台時自動暫停播放，開台時自動繼續播放；觀眾仍可正常點歌。
贊助影片優先播放	開啟時，斗內贊助點歌的影片會自動插到佇列最前面；關閉則依付款完成時間排隊。
審核模式	開啟後，指令點歌、忠誠獎勵點歌與影片贊助點歌都會先進「審核」頁，經你核准才進待播播放；拒絕即丟棄。注意：拒絕不會退還點數或款項。
顯示行數	超過這個行數的部分會以刪節號截斷。
上一首	重新播放最近一次播放的歌曲
收藏	把現正播放收藏進目標播放清單
取消收藏	從播放清單移除這首
置頂	插到最前 (下一首播這首)

聊天指令

以下為預設指令名稱，可在後台自訂或設定別名。

!song — 顯示目前歌曲的標題.
!songrequest — 點一首歌加入待播清單 (預設別稱 !sr)。
!songlist — 查看點歌清單的網址.
!songskip — 跳過當前歌曲
!songpause — 暫停音樂播放器 (如果已開啟且播放中)
!songplay — 播放音樂播放器 (如果已開啟且暫停中)
!songvolume — 將目前音量變更為指定數字.
!songlike — 輸入連結、搜尋或留白引用當前播放，新增至播放清單。
!songdislike — 將當前播放之曲目從播放清單中移除。
!songignore — 將指定使用者加入點歌忽略名單。

其他說明

同一首歌可同時屬於多個清單；「全部歌曲」即整個曲庫。
貼上 YouTube 播放清單網址 (youtube.com/playlist?list=…) 會整批匯入。
即時控制 OBS 點歌小工具。
切換小工具的內容排版。隱藏畫面不影響聲音，音樂照播；版型與下方的視窗外框各自獨立，可以自由搭配。
為整個小工具加上圓角與視窗外框。霧光/雲母/像素三款會多一條裝飾標題列 (會多佔一點高度)，其餘只有外框與陰影。外框顏色沿用下方調的背景色與進度條色。
審核已關閉，以下為關閉前遺留的待審項目；核准或拒絕後即清空，新的點歌不會再進審核。
以下為點歌系統的聊天室指令；實際啟用、冷卻、別稱與權限請到「指令」頁調整。
點歌主要透過聊天指令 !songrequest 觸發；目前該指令未啟用，觀眾在聊天室輸入將沒有反應。
最近播放過的歌曲 (最多 20 首)。非永久保留，伺服器重新啟動即清空。
此清單每 12 秒自動更新；手動加歌與聊天室點歌都會出現在這裡。
以 YouTube 影片 id 或網址精確封鎖特定影片，貼上完整網址會自動辨識。
歌名包含以下任一關鍵字即拒絕點播，不分大小寫，自動忽略空白與標點的繞過。
上傳頻道名稱包含以下任一關鍵字即拒絕點播 (比對顯示名稱，非頻道 id)。
名單內的使用者點歌時一律靜默忽略，不會有任何回覆；已在待播佇列中的歌不受影響。

其他設定項目

這些設定在後台介面上沒有額外說明文字，此處僅列出名稱。

最短時長 (秒)
最長時長 (秒)
播放清單
新增曲目
匯入
全部歌曲
這首歌已在曲庫中
清空此清單
清空曲庫
刪除清單
載入更多
在 YouTube 開啟
編輯所屬清單
所屬清單
已更新所屬清單
從此清單移除
從曲庫刪除
播放控制
播放
暫停
跳過
音量
套用音量
靜音
開啟聲音
啟用點歌模組以使用播放器。
點歌播放器
關閉播放器
拖曳調整大小
小工具外觀
儲存外觀
字型大小 (px)
字型
邊框留白 (rem)
行高 (rem)
文字特效
版型
影片 (預設)
音樂播放器
靜態縮圖
純訊息 (無畫面)
預設
顯示
隱藏
視窗外框
經典 (無外框)
浮空卡片
霧光視窗
雲母視窗
像素視窗
霓虹外框
Bot 語系
無
驚喜
波動
扭動
訊息覆蓋在影片框內
訊息置頂
隱藏訊息
訊息模板
點歌訊息
贊助斗內點歌訊息
一般顏色
背景
進度條
基本文字
使用者
標題
斗內顏色
斗內背景
金額
留言
新增播放清單失敗 (僅限 Pro)
刪除失敗 (清單非空？)
新增曲目失敗
匯入失敗
更新所屬清單失敗
小工具外觀目前無法載入。
點歌者
歌名
斗內金額
點歌規則
播放行為
審核模式尚未開啟
開啟後，觀眾的點歌會先進這裡等你核准才播出。到設定頁開啟「審核模式」。
前往設定
拒絕不會退還點數或款項
拒絕忠誠獎勵點歌不會退還已扣的忠誠點數；拒絕影片贊助點歌不會退款 (款項已入帳)。核准後歌曲才會進待播播放。
目前沒有待審的點歌
新的點歌進來時會顯示在這裡。
點歌
贊助點歌
核准
已核准，排入待播
拒絕
已拒絕
觀眾指令
管理指令
限 MOD
搜尋字串
使用者名稱
管理指令設定
點歌指令尚未啟用
待播清單
目前沒有待播歌曲。
播放歷史
還沒有播放記錄。
加入點歌
重新整理
移除
加入失敗，請確認關鍵字或網址。
版面與字型
點歌變數
未知的變數
{username} 點播：{title}
{username} 贊助 {amount}$ 點播：{title}
預覽點歌
預覽贊助斗內
訊息位置
頂部
底部
顯示模式
跑馬燈
固定行數
跑馬燈速度
現正播放
目前沒有播放歌曲。
已收藏到播放清單
這首已在播放清單中
已從播放清單移除
封鎖影片
尚無封鎖的影片
封鎖歌名關鍵字
尚無封鎖的歌名關鍵字
封鎖上傳者/頻道關鍵字
尚無封鎖的頻道關鍵字
忽略使用者
複製全部
已複製