従来のボットのメッセージは、embedの下にボタンの列が付いたものでした。Discord Components V2は、テキスト、画像、ボタン、ドロップダウンを1つのコンテナの中にまとめます。そのため、チケットパネル、プレイヤーカード、商品一覧は、後からコントロールを取り付けた箱ではなく、1枚のカードとして読めるようになります。Noxyrは両方に対応しており、機能ごとに選択できます。切り替えると、ライブのパネルを投稿し直すので、何も壊れません。

Side by side: the classic V1 embed with buttons underneath, and the V2 layout where buttons and menus live inside the card. A switch flips between them. V1 · classic embed Open ticket FAQ Choose a department ▾ buttons sit under the embed V2 · Components V2 container Open ticket FAQ Choose a department ▾ everything inside one card buttons and menus live in the card /style set

Components V2の実体

Components V2は、Discordの新しいメッセージレイアウトの仕組みです。従来の「embed」(テキスト、色、画像)と、その下の行に並ぶ「components」(ボタンとセレクトメニュー)という分かれ方の代わりに、V2のメッセージはレイアウトのブロックから構成されます。アクセントカラーを持つコンテナ、テキストブロック、テキストとボタンまたはサムネイルを組み合わせるセクション、区切り線、メディアギャラリー、そしておなじみのボタンとドロップダウンが、すべてその中に入れ子になります。結果として、特にモバイルで引き締まって見え、コントロールは、それが操作する対象のすぐ隣に配置されます。

注意点は、1つのメッセージで両方の仕組みを混在させられないことです。V2のコンポーネントを含むメッセージに、従来のembedを併せて載せることはできません。だからこそボットはメッセージごとに選択しなければならず、Noxyrは機能ごとにその選択を記録しています。

V1:従来のembed

  • 2016年以来、すべてのDiscordユーザーに馴染みがあり、新しい形を覚える必要がありません。
  • 古いクライアントやブリッジを含め、どこでも動作します。
  • ボタンとメニューは、embedの下に最大5行まで並びます。
  • タイトル、フィールド、フッターにより、多くの構造が無料で得られます。

V2:コンテナのレイアウト

  • ボタンとドロップダウンは、関連するテキストのすぐ隣で、カードの中に配置されます。
  • モバイルではより見やすく、メッセージとコントロールの間の縦方向の余白が少なくなります。
  • 区切り線とセクションにより、長いパネル(カタログのページ、ヘルプメニュー)が見やすくなります。
  • 一部の要素は変わります。従来のタイトルとフィールドのグリッドは、テキストブロックとセクションに置き換えられます。

Noxyrでの扱い

すべてのサーバーには、ボタンのデフォルトのスタイルと、ドロップダウンメニュー用の別のデフォルトがあり、さらに機能ごとの任意の上書き設定があります。対象となる機能は、チケット、カタログとチェックアウト、認証、レビュー、提案、投票、音楽プレイヤー、ウェルカムと退出のメッセージ、ヘルプと公開コマンド、ダイレクトメッセージです。V2の公開前から存在していたサーバーは、管理者が変更するまでV1のままです。今Noxyrを追加するサーバーはV2から始まります。ギブアウェイは、そのメッセージ形式がそれに依存しているため、常に従来のレイアウトを使います。

切り替えは、1つのコマンド、または1つのダッシュボードのページ(コントロールの下のButtons & Menus)で行えます。

  • /style view:現在、各機能が使っているスタイルを表示します。
  • /style set feature:all buttons:v2 dropdowns:v2:サーバー全体のデフォルトを設定します。
  • /style set feature:tickets buttons:v1:1つの機能だけに設定します。
  • /style reset:上書きを削除し、機能がサーバーのデフォルトに再び従うようにします。

デフォルトでは、変更するとライブのパネル(チケットパネル、カタログ、認証など)が投稿し直されるため、メンバーは次回の編集を待つことなく、すぐに新しいレイアウトを見られます。パネルを次回保存したときに切り替えたい場合は、repost:falseを指定してください。

どちらを選ぶべきか?

  • 公開向けのパネル(チケット、認証、カタログ):V2。メンバーが最も頻繁に操作するもので、カードの中のボタンは、スマートフォンでもタップしやすくなります。
  • 音楽プレイヤー:V2。コントロールはカードに含まれるべきものです。
  • ウェルカムと退出のメッセージ:どちらでも構いません。その下にフィールドのグリッドを伴う大きなバナー画像に頼っている場合はV1です。
  • スクリーンリーダーや古いクライアントに依存するもの:V1がより安全な選択です。

選択は機能ごとなので、サーバーのデフォルトを切り替える前に、1つずつパネルを移して、メンバーの意見を聞くことができます。

よくある質問

切り替えると何か失われますか?いいえ。設定は変わりません。変わるのは、投稿されたメッセージのレイアウトだけです。元に戻すのも、同じコマンドで行えます。

カスタムボットも同じ設定に従いますか?はい。スタイルはサーバーに保存されるため、カスタムボットとNoxyrは、同じレイアウトで投稿します。

ドロップダウンのメッセージが、ボタンのメッセージと異なるスタイルを使うのはなぜですか?1つのメッセージで両方の仕組みを混在させられないため、ドロップダウンを含むメッセージはドロップダウンの設定に従い、ボタンだけのメッセージはボタンの設定に従います。

試すには、ダッシュボードを開き、Buttons & Menusに進んで、チケットパネルをV2に切り替えてください。パネル自体に何を載せるかについては、ボタンとドロップダウンのガイドで説明しています。