はじめての方へ
スタジオ・ヨンホンは Discord で使うボットを運営しています。 ヨンホンはチャットを声で読み上げ、ヨンヒは音楽を流します。 このページでは、2つのボットが何をしてくれるか、ボットを自分のサーバーに呼ぶ方法、コマンドの探し方をご案内します。
すでにボットがサーバーに入っているなら、いちばん下のどこを見ればいいかの表からすぐに選んでもかまいません。
ヨンホン ボット — チャットを読み上げるボット
ヨンホンはボイスチャンネルに入って、自分がチャットに書いた文を声で読み上げます。 マイクをオンにしなくても、ボイスチャンネルにいる人たちと話せます。 声、読み上げられるニックネーム、話す速度は、人ごとに別々に決められます。
ヨンホンは1人で働くわけではありません。ヨンホン・ヨンハなど複数のボットが一緒に働くので、複数のボイスチャンネルで同時に使えます。 コマンドはすべてヨンホンが受け取り、読み上げはそのとき空いているボットが担当します。詳しくは複数のボットで読み上げにあります。
いちばん早い使い方はこうです。
/join- 先にボイスチャンネルに入ります。
- 読み上げてほしいチャットチャンネルで
/joinを実行します。 - 空いているボットが自分のボイスチャンネルに入ります。ヨンホンのこともあれば、ヨンハなどほかのボットのこともあります。
- そのチャットチャンネルに何か書くと、すぐに読み上げます。
- 使い終わったら
/leaveで退出させます。
ボットは /join を実行したそのチャットチャンネル1つだけを読み上げます。詳しい使い方ははじめてのヨンホンにあります。
ヨンホン・ヨンハなどのボットは、メンバーシップがなくても使えます。 メンバーシップは選べるボイスを広げます。サーバーメンバーシップがあると、そのサーバーの人なら誰でもすべてのボットでプラスのボイスを使えます。→ メンバーシップで使える機能
NOTE
前からヨンホンを使っているなら、先に4.0.0 アップデートのご案内を見てください。 /サーバー …・/メンバーシップ … コマンドはなくなり、サーバー設定はダッシュボードで変更します。
ヨンヒ ボット — 音楽を流すボット
ヨンヒはボイスチャンネルで音楽を再生するボットです。曲名やリンクを入れるとキューに積んでおき、 順番に流します。YouTube・Spotify・SoundCloud のアドレスに対応しています。
再生が始まると、チャンネルにコントローラーカードが1つ表示されます。それからはコマンドを入力し直さなくても ボタンで操作でき、ウェブダッシュボードから操作することもできます。
/재생 검색어: 아이유 밤편지- 先にボイスチャンネルに入ります。
- どのチャットチャンネルでもよいので
/재생（再生）を実行し、曲名かリンクを入れます。 - ボットが入って再生を始め、そのチャンネルにコントローラーカードを表示します。
詳しい使い方はヨンヒ ボットをはじめるにあります。
NOTE
ヨンホンとヨンヒは別々のボットです。片方を招待しても、もう片方が一緒に入ることはなく、 声・音量などの設定も共有しません。メンバーシップもそれぞれ別です。 「ヨンハ」はヨンホンと一緒にチャットを読み上げるボットで、音楽ボットの「ヨンヒ」とは別のボットです。
ボットを自分のサーバーに呼ぶ
ボットをサーバーに追加するには、そのサーバーでサーバー管理権限が必要です。権限がない場合は、サーバーのオーナーに お願いしてください。
- ボットがすでに入っているサーバーで、ボットの名前を押してプロフィールを開きます。 招待リンクを受け取っている場合は、そのリンクを開いても同じです。
- アプリを追加（またはサーバーに追加）を押します。ボタンの名前は Discord のバージョンによって少し違います。
- ボットを入れるサーバーを選び、画面に表示された権限の一覧はそのままにして認証します。
WARNING
認証画面で権限のチェックを外すと、その機能だけが何の案内もなく動かなくなります。音声関連の権限を 外すとボットがボイスチャンネルに入れなくなり、スラッシュコマンドの権限を外すと / を入力してもコマンドが表示されません。 チェックはそのままにして認証してください。すでに招待した場合は、Discord のサーバー設定でボットのロールの権限をオンに戻せば大丈夫です。
TIP
招待した直後は、/ を入力してもコマンドがすぐには表示されないことがあります。新しいコマンドが Discord に行き渡るまで 最大1時間かかります。Discord を完全に終了してから起動し直すと、ほとんどの場合すぐに表示されます。
ヨンホンを招待したあと
ヨンホンを新しく招待すると、まずこのサーバーの代表言語をたずねます。代表言語は、ボットの名前と、チャンネルに投稿するボットの案内に使う言語です。
- ヨンホンがサーバーのシステムチャンネル（なければ書き込める一番上のチャットチャンネル）に、[한국어] [English] [日本語] のボタンが付いたメッセージを投稿します。
/はじめるを使える人（初期設定はアドミン — サーバーのオーナー、または Discord の「管理者」権限を持つ人）が言語を選びます。ほかの人が押すと、権限がないという案内が本人にだけ表示されます。- 選ぶと、このサーバーにいる私たちのボットの名前と案内がその言語に変わり、メッセージが
代表言語を日本語にしました。/はじめる で残りの設定を済ませましょう。に変わります。 /はじめるを実行すると、読み上げるチャット、参加のしかた、声、権限などの基本設定をステップごとに選べます。 同じ設定をダッシュボードの［初期設定アシスタント］で行ってもかまいません。
招待して1分ほどたつと、サーバーのオーナーに、ヨンホンのはじめかたをまとめた DM を一度送ります。 すでにヨンホンがいたサーバーには、言語をたずねるメッセージもこの DM も届きません。
詳しい手順はボットを招待したらにあります。 ヨンハなどのボットをもっと呼びたい場合は、複数のボットで読み上げの招待方法を見てください。
ヨンヒは音楽の権限設定から見てください。
コマンドの探し方
チャット欄に / を入力すると、使えるコマンドの一覧が表示されます。左の一覧でボットのアイコンを選ぶと、 そのボットのコマンドだけを絞り込んで見られます。このドキュメントに書かれたコマンド名をそのまま入力しても見つかります。
- ヨンホン側のコマンドはすべてヨンホンにあります。ヨンハなどほかのボットにはコマンドがありません。
/ユーザー 設定のようにスペースで区切られたものは、/ユーザーの中にあるサブコマンドです。/ユーザーまで入力すれば 残りが候補に表示されます。검색어:（検索ワード）のようにコロンが付いたものは、コマンドを選んだあとに埋める入力欄です。自分でタイプしなくても大丈夫です。- ボットが見られないチャンネルでは、コマンドの一覧にまったく表示されません。ほかのチャンネルで試してみてください。
- 多くのコマンドの応答は自分にだけ表示されます。 実行してもチャンネルに何も残らないのは正常です。
コマンドを1つずつ見ていきたい場合は、ヨンホンのコマンド一覧と ヨンヒのスラッシュコマンド一覧があります。
このドキュメントで使う表示
| 表示 | 意味 |
|---|---|
| 未対応 | 今は使えない機能です |
| 有料 | メンバーシップがないと使えない機能です |
どこを見ればいいか
| やりたいこと | 見るページ |
|---|---|
| チャットを読み上げてほしい | はじめてのヨンホン |
| 前と何が変わったか知りたい | 4.0.0 アップデートのご案内 |
| 自分の声・ニックネームを変えたい | 自分の設定 |
| どんなボイスがあるか見たい | ボイスの選び方 |
| ほかの言語のメッセージを翻訳して見たい | 翻訳する |
| 音楽を流したい | ヨンヒ ボットをはじめる |
| ウェブで音楽を操作したい | ウェブダッシュボードをはじめる |
| メンバーシップコードを登録したい | メンバーシップコードの登録 |
| 自分のサーバーのヨンホンの設定を変えたい | ダッシュボードのサーバー設定 |
| 自分のサーバーにヨンホンを招待したばかり | ボットを招待したら |
| 自分のサーバーのヨンヒの設定を変えたい | 音楽の権限設定 |