プレミアム（サブボット）を有効にする — /admin
ヨンヒの「プレミアム」はサーバー単位の設定です。有効にすると、そのサーバーで1台のボットがすでにほかのボイスチャンネルを使っていても、サブボットが割り当てられて同時に再生できます。
この設定を変える方法は /admin スラッシュコマンド1つだけで、このコマンドは運営チームの管理サーバーでのみ表示されます。 一般のサーバー管理者は、ダッシュボードでプレミアムを有効にできません。
NOTE
このドキュメントは、ヨンヒ ボット自体のプレミアムだけを扱います。ヨンホン側のサーバーメンバーシップとは別の仕組みなので、オン・オフの方法も下の /admin コマンド1つだけです。
コマンドの形
/admin guild_id:<서버 ID> setting:<프리미엄(서브 봇 사용)|볼륨 동기화> action:<활성화|비활성화|상태 확인>（<서버 ID> はサーバー ID、프리미엄(서브 봇 사용) はプレミアム（サブボットを使う）、볼륨 동기화 は音量の同期、활성화 は有効化、비활성화 は無効化、상태 확인 は状態の確認です。）
3つのオプションはすべて必須です。
| オプション | 値 | 説明 |
|---|---|---|
guild_id | サーバー ID の文字列 | 設定を適用するサーバー |
setting | 프리미엄(서브 봇 사용) / 볼륨 동기화 | 変える設定 |
action | 활성화 / 비활성화 / 상태 확인 | 行う動作 |
オプションの名前は英字で、選択肢のラベルだけが韓国語です。Discord のオートコンプリートに英字の名前が表示されるのは正常です。
応答はすべて、本人にだけ見えるメッセージで返ってきます。
| 実行 | 応答 |
|---|---|
| プレミアム・状態の確認 | 서버 `<ID>` 프리미엄(서브 봇) 상태: 활성화（サーバー <ID> のプレミアム（サブボット）の状態: 有効）または 비활성화（無効） |
| プレミアム・有効化 | 서버 `<ID>` 프리미엄(서브 봇 사용)을 활성화했어요.（サーバー <ID> のプレミアム（サブボットを使う）を有効にしました） |
| 音量の同期・状態の確認 | 서버 `<ID>` 볼륨 동기화 상태: ON（サーバー <ID> の音量の同期の状態: ON）または OFF |
| 音量の同期・有効化 | 볼륨 동기화를 ON으로 설정했어요. (메인 봇 볼륨을 모든 봇이 따라가요)（音量の同期を ON にしました。（メインボットの音量にすべてのボットが合わせます）） |
| 音量の同期・無効化 | 볼륨 동기화를 OFF으로 설정했어요. (봇마다 볼륨을 따로 저장해요)（音量の同期を OFF にしました。（ボットごとに音量を別々に保存します）） |
音量の同期の意味は、音量ポリシーと音量の同期 にあります。
このコマンドを使える場所
/admin は運営チームの管理サーバーでのみ使えます。ほかのサーバーで呼び出すと、이 명령은 지정된 관리 서버에서만 사용할 수 있어요.（このコマンドは指定された管理サーバーでのみ使えます）で断られます。
WARNING
このコマンドは、対象のサーバーを直接指定して設定を変えるコマンドです。管理サーバーで サーバー設定 → 連携サービス（Integrations）→ ヨンヒ を開き、/admin を使えるロールを運営者のロールに制限しておくことをおすすめします。チャンネル単位でも制限できるので、運営者専用のチャンネルでだけ使うようにしておけば、ミスをさらに1段階減らせます。
設定したあとは、運営者ではないアカウントで管理サーバーから /admin と入力し、オートコンプリートに表示されないことを自分で確かめてください。
TIP
管理サーバーそのものを、最小限の人数だけがいる別のサーバーにしておくのがいちばん確実です。
対象サーバーの ID は自分で確かめてください
guild_id にはサーバー ID をそのまま入れます。対象のサーバーでサーバー名を右クリックし、サーバー ID をコピー で取ってくるのがいちばん安全です。
WARNING
サーバー ID を間違えて入れても、成功のメッセージが出ます。 存在しない ID を入れると、その ID で設定だけが作られ、応答は正常に「활성화했어요」（有効にしました）と出ます。実行したあとは、必ず action:상태 확인 で同じ ID をもう一度確認し、対象のサーバーで実際にサブボットが入るかを確かめてください。
プレミアムを有効にすると変わること
同じサーバーの複数のチャンネルで同時に再生
メインのボットがすでにそのサーバーのほかのボイスチャンネルを使っているとき、プレミアムが有効ならサブボットが割り当てられます。プレミアムが無効なら、2つ目のチャンネルの再生リクエストは断られます。
すでにどれかのボットが担当しているボイスチャンネルのリクエストは、プレミアムに関係なくそのボットがそのまま処理します。プレミアムが必要になるのは、新しいチャンネルにボットがもう1台入る必要があるときだけです。
ダッシュボードでサブボットのチャンネル指定のロックが外れる
設定画面のボットごとのコントローラーチャンネルの行で、サブボットの行のロックが外れます。詳しくは コントローラーメッセージのチャンネル固定・統合 にあります。
プレミアムを有効にしたのにサブボットが入らないとき
action:상태 확인 が有効と出ているのに、2つ目のチャンネルで再生が断られるときは、次を順番に確かめてください。
- サーバー ID を正しく入れたか — 対象のサーバーでサーバー ID をもう一度コピーし、
action:상태 확인で確認します。 - サブボットがすでにそのサーバーでほかのチャンネルを使っていないか — サイドバーのサーバー一覧に、それぞれのボットがどのボイスチャンネルにいるかが表示されます。空いているボットがなければ、新しいチャンネルには割り当てられません。
- 上の2つに問題がないのに断られ続けるときや、少し待ってから応答のタイムアウトのエラーが出るときは、運営チームにお問い合わせください。
プレミアムを無効にすると
それ以降の新しい割り当てだけが止まります。すでにサブボットが再生中のチャンネルはすぐには切れず、その再生が終わるまでそのまま続きます。