Hanakoの使い方ガイド。

CHAPTER 01 / GETTING STARTED

はじめかたは、4ステップ。

Hanakoは、呼んだ人がいるボイスチャンネルに参加して、呼ばれたテキストチャンネルの発言を読み上げます。面倒な設定はいりません。

STEP 1 ボイスチャンネルに入る 先にあなたが参加しておく

STEP 2 /plzと打つ 読んでほしいテキストチャンネルで

STEP 3 Hanakoが参加 そのチャンネルの発言を読み上げる

STEP 4 /byeで退出 誰もいなくなれば自動で退出

読み上げを始めてから終わるまでの流れ

覚えておくと便利なこと

• Hanakoが参加しているときに、別のテキストチャンネルでもう一度/plzを打つと、そのチャンネルも読み上げの対象に加わります。
• ボイスチャンネルに付いているテキストチャットで/plzを打てば、そこが読み上げの対象になります。
• ボイスチャンネルにHanakoだけが残ると、自動で退出します。
• メンテナンスで再起動したときは、元のボイスチャンネルに自動で再接続し、読み上げを再開します。

CHAPTER 02 / INPUT METHODS

コマンドの打ち方は、3通り。

同じコマンドを3通りの書き方で実行できます。使いやすいものを選びましょう。迷ったら、スラッシュコマンドがおすすめです。

おすすめ

スラッシュコマンド

/teach from:草 to:くさ

入力欄に/を打つと候補と説明が出ます。引数の名前が表示されるので打ち間違えにくく、一覧系の結果は自分にだけ表示されます。

テキスト

メンション

@はなこ teach 草 くさ

Hanakoにメンションして、コマンド名と引数をスペース区切りで続けます。教育のような日本語の別名も使えます。

テキスト

プリフィックス>

>teach 草 くさ

発言の先頭に>を付けます。いちばん少ない文字数で打てます。

スラッシュコマンドとテキストコマンドの違い

• スラッシュコマンドは、自分にだけ見える返事や確認ボタン、コマンドごとの使える人の設定など、Discordの機能をフルに使えます。
• テキストコマンドのほうが便利なのは、SEを複数まとめて追加・削除するときだけです。
• ふだんはスラッシュコマンド、SEをまとめて登録・整理したいときだけテキストコマンド、という使い分けがおすすめです。
• テキストコマンドは使える人を細かく変えられません。権限をきっちり管理したいサーバーでは、/text-commandsで止めておけます。

CHAPTER 03 / HOW IT READS

発言が声になるまでの、5つの手順。

発言は、次の5つの手順を順に通って声になります。思ったとおりに読まれなかったときや、まったく読まれなかったときは、この順番をたどると理由がわかります。

1. 読むかどうかを決める 読み上げ対象チャンネルの、人間の発言だけを通します（下の表を参照）。
   @ぴよ HANAKINの動画見た https://youtu.be/abc （拍手） 今更メントスコーラ？っておもったけどNOPEでやってる動画はじめてみたかも
2. 読める形に直す URLは「ユーアールエル」に、メンションは表示名に、絵文字は名前に置き換えます。
   @ぴよ HANAKINの動画見た ユーアールエル （拍手）:hanako_hey: 今更メントスコーラ？っておもったけどNOPEでやってる動画はじめてみたかも
3. 辞書で読み替える 教育した単語を置き換えます。SEのキーワード部分は書き換えません。
   @ぴよ ハナキンの動画見た ユーアールエル （拍手）:hanako_hey: 今更メントスコーラ？っておもったけどNOPEでやってる動画はじめてみたかも
4. 長すぎたら切る 文字数制限を超えた分を切り捨て、最後に「イか略。」と読みます。短すぎて途中で切れてしまう場合は、サーバー管理者が/limitで上限を増やすか、/limit number:0で制限をなくせます（06章を参照）。
   @ぴよ ハナキンの動画見た ユーアールエル （拍手）:hanako_hey: 今更メントスコーラ？っておもったけどNOPイか略。
   // 60文字を超えた「Eでやってる動画はじめてみたかも」を切り捨て
5. 声とSEに分けて再生する SEのキーワードは効果音に、それ以外は合成音声になり、順番に再生されます。
   🗣 @ぴよ ハナキンの動画見た ユーアールエル 🎺 （拍手） 🗣 :hanako_hey: 今更メントスコーラ？っておもったけどNOPイか略。

例：辞書に「HANAKIN → ハナキン」、SEに「（拍手）」を登録し、文字数制限を60文字にしているサーバーでの読み上げ

読み上げられない発言

読み上げを止める「成敗」

長文やSEが流れ続けて困ったときは/seibaiを使います。いま読んでいる音声と、その後ろで順番待ちしている音声をすべて中断します。Hanakoは退出しないので、次の発言からまた読み上げます。

• だれでも使えます。権限は要りません。荒らしや貼り付け事故を見かけたら、気づいた人がすぐ止められます。
• 止まるのは「いま溜まっている分」だけ。辞書やSE、読み上げ対象チャンネルの設定はそのまま残ります。
• テキストでも呼べます。>成敗や>stopと打っても同じです。
• 何も読んでいないときに打つと「安心せい、みねうちにゃ…」と返ります。

知らないと、長文が終わるまで全員で待つことになります。サーバーのメンバーにも教えてあげてください。

CHAPTER 04 / DICTIONARY

読み方を、辞書で教える。

読み間違える単語や、内輪の呼び名の読み方を教える機能です。サーバーごとに10,000件まで覚えます。サーバーの中で使われている言葉を、Hanakoに教えていきましょう。

読み上げる直前に発言の中の単語を置き換えます。チャットに書かれた発言そのものは変わりません

登録するときの注意

• 置換前・置換後とも2〜50文字。1文字の単語は登録できません。
• 同じ「置換前」は1つだけ。読み方を変えたいときは、いちど/forgetしてから教え直します。
• 単語の一部にも反応します。短い単語を登録すると、思わぬ言葉の中で置き換わることがあります。
• SEのキーワードになっている部分は、辞書では置き換えません（SEが優先されます）。

CHAPTER 05 / SOUND EFFECTS

キーワードで、効果音を鳴らす。

キーワードに音声ファイルを結びつけると、その言葉が発言に出てきたとき、読み上げの代わりに音を鳴らします。チャットがライブ会場のようににぎやかになります。

SEを追加する3つの方法

スラッシュ / テキスト

URLで指定

/se-add keyword:（拍手） url:https://…/clap.mp3

ネット上の音声ファイルのURLを指定します。URLは300文字まで。

スラッシュ / テキスト

ファイルを1つ添付

/se-add keyword:（拍手）を打ち、fileに添付

手元のファイルをそのまま登録できます。テキストコマンドなら@はなこ se-add （拍手）と打って添付します。

まとめて登録

複数ファイルをまとめて

@はなこ se-addと打ち、複数のファイルを添付

キーワードを書かずに添付すると、拡張子を除いたファイル名がそのままキーワードになります。テキストコマンドだけで使えます。

登録できるファイル

探す・直す・消す

音量をそろえる「SE正規化」

SEはファイルごとに音量がばらばらです。正規化をオンにすると、小さすぎるSEを指定したレベルまで持ち上げて、聞こえ方をそろえます。

小さいSEが目標レベルまで持ち上がります（イメージ図）

• /se-normalize level:0〜100で設定します。初期値は50で、0にすると無効になります。
• サーバー全体の設定です。変更には「サーバー管理」の権限が必要です。

CHAPTER 06 / VOICE & LIMIT

声と、読む長さの設定。

「誰の声で」「どこまで」読むかの設定です。設定がおよぶ範囲がそれぞれ違うので注意してください。

自分の発言だけ

キャラクター変更

/speaker name:キャラクター名

あなたの発言を読む声を変えるコマンドです。ほかの人の声は変わりません。設定はサーバーごとに覚えます。

今のところ使える声はdefaultの1種類だけなので、実際には変更できません。

サーバー全体

文字数制限

/limit number:30

1つの発言で読む文字数の上限を、0〜2000で決めます。超えた分は読まず、最後に「イか略。」と付けます。

初期値は/limit number:0で、制限はありません。変更には「サーバー管理」の権限が必要です。

CHAPTER 07 / BLACKLIST

読み上げない人を、決めておく。

特定のユーザーの発言を読み上げないようにする機能です。Discord上のミュートやタイムアウトとは別で、Hanakoが「その人の発言を読まない」だけです。

• その人がコマンドを使うことは妨げません。止まるのは読み上げだけです。
• ほかのBotの発言はもともと読まないので、登録は不要です。

CHAPTER 08 / PERMISSIONS

コマンドを使える人と、権限の設定。

ほとんどのコマンドは誰でも使えます。影響の大きいコマンドだけは、サーバーで「サーバー管理」か「メンバーをタイムアウト」の権限を持つ人しか使えません。

コマンドを使える人の初期設定。「管理者」権限を持つ人はすべて使えます

使える人を変える

上の図は初期設定です。サーバー管理者は、Discordの「サーバー設定 → 連携サービス → はなこ」から、コマンドごとに使えるロール・メンバー・チャンネルを変更できます。たとえば、ブラックリストを全員が使えるようにしたり、/se-addを特定のロールだけに許可したりできます。

テキストコマンドを止める

/text-commands enabled:Falseを実行すると、そのサーバーでは@はなこや>で始まるコマンドに反応しなくなります。enabled:Trueで元に戻ります。

• 止めている間は、テキストコマンドに案内も含めて何も返しません。
• >で始まる発言を読み上げない動作は、そのまま変わりません。
• >をほかのBotのコマンドに使いたいサーバーにも向いています。

Hanako自身に必要な権限

Hanakoが動くには、対象のチャンネルで次の権限が必要です。足りないときは、Hanakoがどの権限が足りないかを教えてくれます。

データはサーバーごとに完全に分けて保存

辞書・SE・ブラックリスト・各種設定は、Discordサーバーごとに別々に保存されます。ほかのサーバーの設定が混ざったり、見えたりすることはありません。保存する情報の詳細はプライバシーポリシーをご覧ください。

CHAPTER 09 / COMMANDS

すべてのコマンドを、ひと目で。

下の欄に言葉を入れると、一覧を絞り込めます。

一致するコマンドはありません。別の言葉で探してみてください。

テキストコマンドは、表の別名のどれかを@はなこか>に続けて打ちます。たとえば>sや@はなこ お願いのように打ちます。