Discord Components V2：新しいメッセージのレイアウト

埋め込みとの違い

従来の形式では、ボットはメッセージの内容、最大十個の埋め込み、その下にボタンの列を送ります。レイアウトは固定されています。埋め込みは一つのブロックで、ボタンはいつも下にぶら下がります。

Components V2では、ボットはメッセージにフラグを立て、それをブロックのツリーとして記述します。一つのコンテナの中に、テキスト、その横のサムネイル、メディアのギャラリー、区切り線、ボタンをすべて入れられ、コンテナは埋め込みの側面のバーのようなアクセントの色でスタイルできます。

主な構成要素

• コンテナ：ほかのブロックをまとめるカード。
• セクション：ボタンやサムネイルを横に添えたテキスト。
• テキスト表示：マークダウンのテキストを、必要なだけのブロックで。
• メディアのギャラリーとファイル：カードの中の画像とダウンロード。
• 区切り：余白や区切り線。
• アクション行：ボタンとセレクトメニュー。従来どおり。

知っておくべきトレードオフ

V2のフラグが立ったメッセージは、古いcontentと埋め込みの欄を同時に使えないので、ボットはメッセージごとに一つの形式を選びます。V2に対応していない古いDiscordのクライアントでは、これらのメッセージが正しく表示されないため、多くのボットは今も両方を提供しています。V2のメッセージは、作成時にフラグが立つので、後から従来の形式に戻すこともできません。

利点は柔軟性です。インラインのボタン、操作する文章の横に置かれるドロップダウン、すっきりしたモバイルのレイアウトは、V2の方が作りやすくなります。

Noxyrの扱い方

Noxyrでは、機能ごとにV1かV2を選べます。V1は、下にボタンが付いた従来の埋め込みです。V2は、ボタンとドロップダウンをメッセージのカードの中に入れます。新しいサーバーはV2から始まります。チケットの操作、投票、音楽のプレーヤーを、一つのドロップダウンにまとめることもできます。ダッシュボードのButtons and Menusにあるか、/styleを使ってください。設定はボタンとメニューのドキュメントに説明があります。

チケットのパネルがあるなら、V2でどう見えるかはチケットのパネルのドキュメントでご覧ください。

切り替えるべきか？

メンバーのほとんどが最新のDiscordアプリを使っているなら、V2の方がすっきりしたパネルになります。最大限の互換性がほしいなら、重要なメッセージは従来の見た目のままにしてください。V2と従来の埋め込みの比較の記事に、並べた例があります。