# Nightbot 點歌機器人教學

## 簡介
簡易教學 Nightbot 機器人的點歌功能使用

## 事前準備
1. Twitch 帳號

## 粗略流程
1. 邀請機器人到聊天室，綁定帳號方便後續設定 --> [Step 1](https://hackmd.io/6wU79DH2TheHrGiWjWMYeg?both#Step-1---%E5%B8%B3%E8%99%9F%E9%80%A3%E5%8B%95%E4%B8%A6%E5%B0%87%E6%A9%9F%E5%99%A8%E4%BA%BA%E6%8B%89%E8%87%B3%E8%81%8A%E5%A4%A9%E5%AE%A4)
2. 設定指令方便後續跟觀眾互動或個人使用 --> [Step 2](https://hackmd.io/6wU79DH2TheHrGiWjWMYeg?both#Step-2---%E5%9F%BA%E6%9C%AC%E6%8C%87%E4%BB%A4%E8%A8%AD%E5%AE%9A)
3. 啟用點歌功能 (超級重要，請一定要開啟) --> [Step 3](https://hackmd.io/6wU79DH2TheHrGiWjWMYeg?both#Step-3---%E5%95%9F%E5%8B%95%E9%BB%9E%E6%AD%8C%E5%8A%9F%E8%83%BD)
4. 後臺基本管理 --> [Step 4](https://hackmd.io/6wU79DH2TheHrGiWjWMYeg?both#Step-4---%E5%AF%A6%E4%BE%8B%E5%B1%95%E7%A4%BA)
5. 匯入自己喜歡的歌單 --> [Step 5](https://hackmd.io/6wU79DH2TheHrGiWjWMYeg?both#Step-5---%E6%AD%8C%E5%96%AE%E5%8C%AF%E5%85%A5)

## 詳細步驟

### Step 1 - 帳號連動並將機器人拉至聊天室

* 進入 [Nightbot網站](https://nightbot.tv/)


* 登入並聯動 Twitch


* 完成授權後自動進到下方頁面, 點 join Channel


* 到自己 Twitch 頻道的聊天室, 輸入指令 `/mod nightbot`

* 確認觀眾名單有 Nightbot 存在即可


### Step 2 - 基本指令設定

* 回到剛剛的Nightbot Dashboard , 點選左方的 Command , 選擇 **Dedault**


* 圖片中的三個 Enabled 指令打開, 其他都可以關掉(設定成Disabled)


* 左側目錄, 選擇 Custom , 按下 Add Command


* 設定部分可以參照下圖全部照著打, 設定兩個指令, 一個是**顯示歌單**一個是**點歌**, 記得歌單的ID部分要改成自己的唷!
* 此處幫大家附上網址 https://nightbot.tv/t/xxx/song_requests 自動將xxx替換成自己的ID唷

* 設定完成按下 **submit **

* **顯示歌單指令新增方法**

* **點歌指令新增方法**

* 點歌有智慧搜尋功能, 有三種模式, 詳細可以看圖片

* **透過名字直接進行搜尋和點歌(有一定的可能會點錯歌曲)**

---
* **透過歌曲網址進行點歌**

---
* **透過歌曲後方短代號點歌**
* 例如: https://www.youtube.com/watch?v=nWb_X3ZJQjw
* 我們就選取v= 後面那一段代碼即可
(此處是使用網址"v= "後方的短代碼進行點歌)

* 至此點歌設定已完成

### Step 3 - 啟動點歌功能

* 左邊的目錄列, 選擇Song Requests, 點選 AutoDJ



* **歌曲清單頁面, 記得要先將此功能打開(若是點歌功能關閉, **歌單和點歌指令也無法啟動**)**


* 點選 Setting , 選擇 Limits, 管理者可做點歌的限制(沒有中文解釋的可以先不管他, 跟著圖片即可)


* 選擇 Youtube


### Step 4 - 實例展示

* 在自己的聊天室測試指令是否正常


* 輸入 `!歌單`, 呼叫歌單出來


* 這是觀眾可以看到的樣子, 觀眾可以對自己點的歌做刪除


* 台主可以在 AutoDJ, 以管理者模式去看後台狀況並進行管理


* 可手動開關點歌系統, 對歌曲刪除或是跳過, 操作播放與暫停, 播完一首會自動把歌單的下一首接續撥放

* **恭喜 你學會基礎的使用囉**

### Step 5 - 歌單匯入

* Nightbot 本身也提供導入 Youtube(後續簡稱YT) 播放清單的功能
* 當沒有人點歌時, 就會自動導入已經預設好的歌單進行播放. 不怕沒有音樂囉!

* 先到 Song Request -> AutoDJ 右上方的 setting, 將 general 中的 platlist選項選成 channel, 這樣就能自定義歌單囉


* 轉到自己於YT建立的播放清單, 複製該清單的網址


* 然後到自己的 Nightbot 控制台, 找到 Song Request -> Playlist -> 選擇右方的 import 詳細位置看下圖


* 確定後按下 submit 即可自動加進播放清單內(可支援多個播放清單導入, 會自動打散隨機播放)

## 教學文撰寫者 雨日晴夜 OTsky