モジュール

コンポジションについて理解する

両形式でプレビュー、色、画像、複数の埋め込み、埋め込みの開閉・コピー・削除・並べ替えを使えます。V1はDiscordの固定フィールド、V2は自由なブロックを使います。以下で入力項目と違いを説明します。

コンポジションの名前はダッシュボードでの管理にのみ使用され、Discord には送信されません。サーバーごとに、それぞれ最大 50 文字の名前を持つ最大 50 個のコンポジションを保存できます。

コンポーネント V1 / V2

新しい構成はV2で始まります。

初回保存前にV1またはV2を選びます。保存後は下書きでも公開を取り消した後でもバージョンは固定です。他の形式には新しい構成を作成してください。複製はバージョンを保持します。保存済みのV1メッセージは自動変換も削除もされません。

V1

V1はアクセントカラーと固定された領域を持つDiscordの従来の埋め込みを使います。最大10個です。表の数字は文字数上限です。全埋め込みの作成者、タイトル、説明、フッター、全フィールド名と値の合計は最大6000文字です。通常の本文には別の上限があります。 V1の埋め込みごとに最大25フィールドです。

装飾領域はすべて任意です。フィールドを追加したら名前と値の両方が必須です。不要なフィールドは削除してください。横並びはインライン表示を有効にし、最終配置はDiscordと画面幅によります。作成者のリンクとアイコンには作成者名、タイトルリンクにはタイトル、フッターアイコンにはフッター本文が必要です。任意のリンクは完全なHTTP(S)アドレスです。タイムスタンプは送信時刻を表示します。

ロールとチャンネルの選択は通常の本文、V1の説明、フィールド値で使えます。作成者、タイトル、フッター、フィールド名にはこれらのメンション選択はありませんが、サーバー絵文字は使えます。作成者URLとタイトルリンクはURL専用で、ロール、チャンネル、絵文字は挿入できません。従来の埋め込み内のメンションは通知しません。

リンクボタン

V2は1つのアクション行に最大5個のリンクボタンをまとめます。V1の5行上限ではなく全体のコンポーネント枠が適用されます。

リンクボタンはサイトを開き、ロールを付与しません。追加したボタンには最大80文字のラベルと最大512文字の完全なHTTP(S) URLが必須です。絵文字は任意です。並べ替えや削除が可能です。V1では埋め込みの下に1行最大5ボタン、全体最大5行、つまり25ボタンまで表示します。V2は所属コンテナ内に表示し、ボタンと行を40個の枠に数えます。

コンポジションを作成する

内部名は下書きだけを保存する場合も必須です。エディターでは最大50文字です。新しい構成には変更可能な推奨名が入り、ダッシュボードにのみ表示します。公開にはアクセス可能なチャンネルと表示本文、埋め込み、または完全なリンクボタンが必要です。説明や画像にタイトルは必須ではありません。空の下書きにはまだ内容が不要です。

必要な Discord 権限

V1の通常本文のメンションは通知できますが、従来の埋め込みは通知しません。V2のテキストブロックもメンションを通知できます。@everyone、@here、誰でもメンションできないロールには、対応するDiscord権限が必要です。公開前にメンションを確認してください。

公開にはチャンネルを見る・メッセージを送信の権限が必要です。従来の埋め込みと画像にはリンクを埋め込む権限が必要です。ローカル画像ファイルの一度だけの送信にはファイルを添付する権限が必要です。下書き保存ではまだDiscordに公開しません。

1. ダッシュボードで埋め込みを開きます。
2. 新しい構成を選択し、内部名を割り当てます。
3. 必要に応じて、通常のメッセージの内容を追加します。
4. 最初の埋め込みを設計し、必要に応じて追加の埋め込みを追加します。
5. Discord のプレビューで結果を確認します。
6. 公開するターゲット チャンネルを選択するか、チャンネルを空白のままにして下書きのみを保存します。

メッセージの内容

通常のメッセージ コンテンツは埋め込みの上に表示され、最大 2,000 文字を含めることができます。役割、チャネル、サーバー絵文字は、エディターで選択して使用できます。

V1の通常本文のメンションは通知できますが、従来の埋め込みは通知しません。V2のテキストブロックもメンションを通知できます。@everyone、@here、誰でもメンションできないロールには、対応するDiscord権限が必要です。公開前にメンションを確認してください。

デザインの埋め込み

Discord は作者名も設定されている場合にのみ作者アイコンを表示します。プレビューにアイコンを表示するには上で名前を入力してください。 Discord はフッターテキストも設定されている場合にのみフッターアイコンを表示します。プレビューにアイコンを表示するには上でテキストを入力してください。

V2

画像ブロックには最大10枚の画像を含むギャラリーを作成できます。「+ 画像を追加」で追加し、各画像を個別に削除できます。画像とサムネイルには最大80文字の説明とネタバレ設定を任意で指定できます。セクションには最大4000文字のテキストを3つまで設定できます。「+ テキストを追加」で最大2つ追加できます。アクセサリーではサムネイルまたはリンクボタンを選択します。リンクボタンには最大80文字のラベルと最大512文字の完全なHTTP(S) URLが必要です。絵文字と無効化は任意です。追加テキストとアクセサリーボタンはコンポーネント数に含まれます。ギャラリー内の各画像は追加コンポーネントとして数えません。

V2 ではコンテナや画像（サムネイルを含む）をスポイラーにできます。内容は最初は隠され、クリックすると表示されます。

V2は個別の色を持つ最大10個のコンテナを提供します。テキストブロックまたは右側に任意のサムネイルを持つセクションは、それぞれ最大4000文字とMarkdownに対応します。区切り線は線または余白のみで、小・大の間隔が選べます。ブロックの追加、コピー、削除、矢印による並べ替えが可能です。空のテキスト・画像ブロックは表示内容を作りません。 V2のテキスト領域にはロール、チャンネル、サーバー絵文字の選択があります。

V2には従来の作成者欄、タイトルリンク欄、インラインフィールド、フッターアイコン、時刻スイッチはありません。見出しとリンクはテキストにMarkdownで書きます。下の例で小さなフッター、時刻トークンでタイムスタンプを作れます。V1には自由配置のV2ブロックはありません。1つのメッセージで両形式は混在できません。

-# ... · {time.full}

V2はメッセージ全体で40コンポーネントが上限です。コンテナ、テキスト、セクション、サムネイル、画像ギャラリー、区切り線、アクション行、ボタン、メニューを数えます。メニューの選択肢は個別には数えません。自動追加の区切り線や操作部品も含みます。例えば、テキスト、画像、区切り線、アクション行付きボタンのあるコンテナは6個を使います。 そのため10個のコンテナすべてを無制限には埋められません。

画像を使用する

画像制限はファイルごとです。V1の作成者アイコン、サムネイル、フッターアイコンは各5 MBまでです。大きな画像は下記のV2画像ブロックと同じ上限です。PNG、JPG/JPEG、WebP、GIFに対応します。ファイル選択で画像を置換し、削除で欄を空にします。作成者とフッターのアイコンは対応する本文なしでは表示しません。

PNG、JPG/JPEG、WebP、GIFを選択できます。画像は保存時にアップロードされます。サムネイルは最大5 MB、画像ブロックは最大10 MBです。埋め込みモジュールでの一回送信は、ローカル画像最大10枚、合計20 MBまで対応します。

保存して公開

管理対象メッセージがDiscordで既に消えていれば、再保存で再公開します。複製は形式を保持しますが公開先なしで始まり、元の構成から独立しています。

下書きとして保存

チャンネル選択を空白のままにして保存します。 Discord メッセージを作成しなくても、下書きはダッシュボードで利用可能なままになります。

永久に公開

チャンネルを選択して保存します。作成された Discord メッセージは、コンポジションにリンクされたままになります。後続の変更は保存時に同じメッセージ内で更新されます。

公開を延期する

すでに公開されている作品に対して別のチャンネルを選択した場合、次回保存するときに、最初に新しいメッセージが作成され、その後古いメッセージが削除されます。

パブリケーションを削除

投稿を削除では、管理対象の Discord メッセージのみが削除されます。コンポジションは保存されたドラフトとして残ります。

コンポジションを削除

構成の削除は保存済みレコードと保存画像を削除します。既に送ったDiscordメッセージは削除せず、画像参照が失われる可能性があります。管理対象メッセージも消すには、先に公開の取り消しを明示的に行ってください。一度だけ送ったメッセージは後から管理しません。

管理と複製

保存したコンポジションは、開いたり、名前を変更したり、複製したり、削除したりできます。コンポジション内で最大 10 個のエンベディングを作成、再配置、複製できます。 Discord の数またはテキストの制限を超える場合、重複は防止されます。

モジュール内ではコンポジションと概要を切り替えられ、未保存の変更は保持されます。モジュールを離れる前に、すべての変更を保存するか破棄してください。 共通の保存バーは概要でも表示されます。保存すると全コンポジションの未保存の変更が反映され、キャンセルすると破棄されます。現在開いていないコンポジションの変更も対象です。

エラーを修正する

構成のプレースホルダー

以下の変数は両バージョンの通常本文とV1の従来のテキスト欄に使えます。送信・更新時に置換され、継続的には更新されません。現在V2ブロックではこれらのサーバー・チャンネル・ボット変数は置換しません。上記の時刻トークンは使えます。メンバー変数や動的アバター画像は歓迎モジュールの機能です。

要件と制限

有効なデザインにすべての任意領域は不要です。色だけや空ブロックは公開に必要な表示内容にはなりません。プレビューは送信せず、送信先での実際のテストを代替しません。どちらのエディターも投票、スタンプ、フォーム、自由にプログラムする操作を提供しません。データと編集可能範囲は付与されたダッシュボード権限にも依存します。

プレビュー、スポイラー、画像ファイル

V2プレビューでは、ギャラリーの画像が1枚の場合は縦横比を保ちます。複数の画像は同じ大きさの16:9の切り抜きでグリッド表示されます。2枚または4枚は2列、3枚および5～10枚は3列です。サムネイルはセクションのテキストの右側に表示されます。画像の説明は代替テキストであり、追加の見えるキャプションではありません。

画像とコンテナのスポイラースイッチはV2エディターにあります。ギャラリー内の画像とサムネイルは個別に隠せます。コンテナのスポイラーは外枠を表示したまま内容を隠します。クリックでプレビューを表示しても、保存済みの設定は変わりません。Discordでもメンバーがクリックしてスポイラーを表示できます。

メッセージ画像はPNG、JPG/JPEG、WebP、GIFに対応します。ファイル形式と画像の内容が一致する必要があります。HTMLやSVGの拡張子を変更しても対応画像にはなりません。画像表の容量制限は各ファイルに適用されます。ローカル画像が拒否されたり読み込めなくなった場合は、元のファイルを選び直して再度保存してください。

Markdownのテキスト欄ではウェブとメールのリンクを使えます。プレビューはHTTP(S)とmailtoのリンクを開きますが、ローカルファイルやBlobアドレスは開きません。作者リンク、タイトルリンク、リンクボタンには完全なHTTP(S) URLが必要です。プレビューはメッセージを公開しません。Discordで保存後の結果を確認してください。表示はクライアントや画面幅によって変わることがあります。