コントローラーメッセージのチャンネル固定・統合
ヨンヒは再生をはじめると、そのチャンネルにコントローラーメッセージ（再生中の曲、操作ボタン、キューのボタン、ダッシュボードのリンク）を送ります。初期値は「コマンドを使ったチャンネルについていく」で、これを特定のチャンネルに固定するのがコントローラーの設定です。
設定の場所はダッシュボードの 설정 → 컨트롤러（設定 → コントローラー）セクションで、サーバー管理者だけが開けます。アクセスの条件は ダッシュボードを使える人 を見てください。
画面にある項目
| 項目 | 意味 | 初期値 |
|---|---|---|
| 현재 재생중 메시지 고정（再生中メッセージの固定） | チャンネル固定の機能そのもののオン/オフ | 꺼짐（オフ） |
| 채널 통합（チャンネルの統合） | すべてのボットが1つのチャンネルを共有するかどうか | 꺼짐 |
| 고정 채널 (공통)（固定チャンネル（共通）） | 統合モードで使うチャンネル1つ | なし |
| 봇별 고정 채널（ボットごとの固定チャンネル） | ボットごとに別々に指定するチャンネル | 空 |
はじめて招待したサーバーは、固定も統合もオフの状態ではじまります。
どのチャンネルに表示されるか — 3段階の優先順位
- 固定がオフなら、再生をはじめたチャンネルに表示されます。スラッシュコマンドを使ったチャンネルで、ダッシュボードからはじめた場合はボットがすでに使っていたチャンネルです。
- 固定がオンで統合もオンなら、共通の固定チャンネル1つだけに表示されます。共通チャンネルが空なら、1番に下がります。
- 固定がオンで統合がオフなら、そのボットに指定されたチャンネル → 共通チャンネル → 再生をはじめたチャンネルの順で、最初に見つかったところに表示されます。
3番の意味が大切です。ボットごとの分離モードでも、ボットに指定されたチャンネルがなければ共通チャンネルに落ちます。 サブボットのチャンネルを指定せずに分離モードだけをオンにすると、結局すべてのボットが共通チャンネルに集まります。
統合モードとボットごとの分離モード
| チャンネルの統合 ON | チャンネルの統合 OFF（初期値） | |
|---|---|---|
| 画面 | チャンネルの選択が1つ | ボットごとに選択が1行ずつ |
| 結果 | すべてのボットのコントローラーが同じチャンネルに積まれる | ボットごとに別のチャンネルに1つずつ |
| 向いている状況 | メインのボットだけを使うサーバー | サブボットで複数のチャンネルで同時に流すサーバー |
ボットの一覧には、いま起動しているボットだけが出ます。停止しているサブボットは一覧に表示されません。
NOTE
「채널 통합」と「봇별 고정 채널」は、固定がオンのときだけ操作できます。固定がオフだと、2つの項目は薄く表示されます。固定をオフにして保存すると共通チャンネルの値は消えますが、ボットごとのチャンネルの値はそのまま残ります。 固定をもう一度オンにすると、以前のボットごとの指定が戻ってきます。
選べるチャンネル
一覧にはテキストチャンネルとボイスチャンネルの両方が出ます。ボイスチャンネルの中のチャットも、コントローラーを置ける場所だからです。項目の前に 텍스트 ·（テキスト ·）/ 음성 ·（ボイス ·）の接頭辞が付き、テキストチャンネルが先に出ます。
WARNING
保存するときに controller channel is invalid のエラーが出たら、選んだチャンネルがそのあいだに削除されたか、ボットがそのチャンネルを見られない場合です。設定画面を再読み込みして一覧を取り直してから、チャンネルを選び直してください。一覧にほしいチャンネルがまったくないときは、先にボットにそのチャンネルの閲覧権限を付けてください。
サブボットのチャンネル指定はプレミアムのサーバーだけ
ボットごとの分離モードで、メインのボットではない行は、プレミアムではないサーバーでは 프리미엄（プレミアム）バッジと一緒にロックされます。プレミアムではないサーバーにはサブボットが割り当てられないので、値を入れても使われません。プレミアムかどうかは プレミアム（サブボット）を有効にする で確かめてください。
保存するとコントローラーが新しく作られます
コントローラーの設定を保存すると、次の順番で動きます。
- 対象のチャンネルにコントローラーメッセージを新しく送ります。
- そのチャンネルにあった既存のコントローラーメッセージを削除します。
- 直前のコントローラーがほかのチャンネルにあったなら、それも削除します。
結果として、チャンネルを変えて保存すると、以前のチャンネルのコントローラーは消え、新しいチャンネルのいちばん下に新しいメッセージが表示されます。
NOTE
何も再生していないときは、保存してもメッセージは動きません。 設定は正常に保存されていて、次にボットがボイスチャンネルに入るときに、新しいチャンネルにコントローラーができます。
コントローラーメッセージは、1つのチャンネルに1つだけ残るようにボットが自動で整理します。ボットを再起動した直後は少しのあいだ複数に見えることがありますが、整理がまだそのチャンネルまで届いていないだけなので、少し待てば1つだけになります。
コントローラーのボタンと権限
| ボタン | 必要な権限 |
|---|---|
| 前の曲 | 이전 곡（前の曲） |
| 一時停止・再生 | 일시정지/재생（一時停止/再生） |
| 停止 | 정지（停止） |
| 次の曲 | 다음 곡（次の曲） |
| 音量 | 볼륨 조절（音量調整）（押すと入力画面が表示されます） |
| キュー | なし（本人にだけ見える一覧） |
権限レベルの意味は DJ ロールと操作ごとの権限 にあります。ボタンはボイスチャンネルに入っていなくても押せます — 権限レベルさえ通れば大丈夫です。そのため、誰でも入れるチャンネルにコントローラーを置くと、操作が多くなることがあります。
コントローラーの下にあるダッシュボードのリンクボタンのラベルは、英字で表示されることがあります。リンクそのものは正常に動作します。
サブボットが送ったコントローラーのボタンは、そのサブボットが処理します。 ボットごとの分離モードでチャンネルがそれぞれ違うなら、チャンネルごとに担当のボットが違うということです。