プラグインパネルを開かずに、FigmaのQuick ActionsからBannerifyのよく使う作業を実行できます。下の名前付きショートカットから選んでください。詳細な設定や作成作業には、通常のプラグインパネルを使います。
Quick Actionを実行する
どのショートカットも、確認済みの有効なライセンスか、残りのトライアル回数が必要です。確認に失敗した場合やトライアルの期限が切れた場合は、通常のプラグインパネルを開いてライセンスを有効にしてください。パネルを開く操作は引き続き使えます。
- ショートカットが選択範囲を使う場合は、作業したいレイヤーを選択します。
- MacではCommand + /、WindowsではCtrl + / でFigmaのQuick Actionsを開きます。
- プラグインを検索し、下の名前付きショートカットを選びます。
- 表示された項目を入力します。任意の項目は省略でき、Tabキーで編集できます。ショートカットを実行して結果を確認するか、保存ダイアログを完了します。
作成系のショートカットでは、名前やサイズを直接入力します。選択レイヤー向けのショートカットは、現在の選択を自動で使います。これらの日常的なショートカットでは、TargetやJSONの入力は求められません。通常のプラグインパネルを開くには、Open Bannerifyを選びます。
| ショートカット | 入力項目 |
|---|---|
| Export Selected Banners (Custom Settings…) | Format（任意）、Frames or sections（任意） |
| Create Resized Copies (Custom Settings…) | Name、Width (px)、Height (px)、Resize mode |
選択肢が決まっている項目には、わかりやすいラベルが使われています。表示されたラベルでも、内部の値でも検索できます。エージェントからの入力には、引き続きコマンドリファレンスに記載された値を使います。
Create Resized Copiesは、元のバナーを残したまま新しいバナーを作成します。Standard ResizeかSmart Layoutを明示的に選んでください。保存済みのレイアウトモードで、この選択が上書きされることはありません。
コンテキストメニューから実行する
対象のレイヤーを選択して右クリックし、Plugins → Bannerifyを選びます（開発中のプラグインはDevelopmentの下に表示されます）。アクションと、その形式またはプリセットを選びます。必須の入力がないプリセットはすぐに実行されます。保存ダイアログが表示された場合は、最後まで操作してください。
各プリセットは、名前のとおりのオプションを設定します。省略した互換オプションには、プラグインに保存された設定が引き継がれます。明示的に指定したアクションやオプションは、矛盾する保存済みの動作より優先されます。その実行に限って保存済みの設定を上書きするのは、明示的に入力した項目か、選んだメニュー項目だけです。一度も保存されていない設定には、通常の設定またはドキュメントに記載のフォールバックが適用されます。エクスポート時の上書きは、設定に保存されません。保存済みの形式がショートカットで使えない場合は、対応している形式を明示的に選ぶか、通常のパネルを使ってください。複数のオプションを組み合わせるには、アクション内でCustom Settings… を選び、パラメーターを入力します。テキスト、URL、名前、サイズが必要なアクションでは、引き続きそれらの必須項目の入力を求められます。Open Bannerifyを選ぶと、通常のパネルが開きます。
| メニュー項目 | 次のステップ |
|---|---|
| Export Selected Banners → Use Saved Settings | すぐに実行 |
| Export Selected Banners → HTML5 Banners | すぐに実行 |
| Export Selected Banners → Google Ads | すぐに実行 |
| Export Selected Banners → MP4 Video | すぐに実行 |
| Export Selected Banners → WebM Video | すぐに実行 |
| Export Selected Banners → Animated GIF | すぐに実行 |
| Export Selected Banners → Animated WebP | すぐに実行 |
| Export Selected Banners → Animated PNG | すぐに実行 |
| Export Selected Banners → PNG Images | すぐに実行 |
| Export Selected Banners → JPG Images | すぐに実行 |
| Export Selected Banners → PDF Document | すぐに実行 |
| Export Selected Banners → Export Selected Banners (Custom Settings…) | Format（任意）、Frames or sections（任意）を入力 |
| Create Resized Copies → Smart Layout | Name、Width (px)、Height (px) を入力 |
| Create Resized Copies → Standard Resize | Name、Width (px)、Height (px) を入力 |
| Create Resized Copies → Create Resized Copies (Custom Settings…) | Name、Width (px)、Height (px)、Resize modeを入力 |
詳細な編集
詳細な設定、長めのコンテンツ、一括での作成、コンポーネントやテンプレートの閲覧には、通常のプラグインパネルを使います。ショートカットメニューには、上に挙げた日常的なコマンドだけが含まれています。
貼り付ける各項目は150文字未満にしてください。Figmaのデスクトップ版では、貼り付けた入力がその文字数で切り捨てられることがあります。それより長い入力は、通常のパネルで行います。
古いプラグインでAction、Target、Optionsが表示される場合は、プラグインを更新して、これらの名前付きショートカットを使ってください。Targetの値はレイヤーIDか選択範囲で、新しく作る項目の名前ではありません。
Bannerifyのアクション
| アクション | 内容 | 対象 |
|---|---|---|
export | 公開はせずに、保存済みのアニメーション設定で選択したバナーをエクスポートします | 対象となる1つ以上のレイヤー |
layouts | 指定したバナーフレームから、リサイズまたはスマートレイアウトのコピーを生成します（最大200件の出力） | 対象となる1つ以上のレイヤー |
export
公開はせずに、保存済みのアニメーション設定で選択したバナーをエクスポートします。対象となるレイヤーを1つ以上選択してください。
| オプション | 型 | 必須 / デフォルト | 意味と使える値 |
|---|---|---|---|
format | string | フォールバック："html" | HTMLプラットフォーム、アニメーション形式、または静止画のPNG/JPG/PDF。html、googleads、mp4、webm、gif、webp、apng、png、jpg、pdf |
source | string | フォールバック："frames" | フレームモードまたはセクション（シーン）モード。frames、sections |
ネストされた必須項目は、その親オブジェクトや配列の要素を指定した場合に適用されます。省略した任意の値には、デフォルトが記載されていないかぎり、既存の操作の動作が使われます。
Export Selected Banners (Custom Settings…) を選びます。次のシンプルな項目を入力するだけで、JSONは必要ありません。
- Format：MP4 Video
- Frames or sections：Frames
エージェントホストからの入力
{"command":"shortcut-export","parameters":{"format":"mp4","source":"frames"}}layouts
指定したバナーフレームから、リサイズまたはスマートレイアウトのコピーを生成します（最大200件の出力）。対象となるレイヤーを1つ以上選択してください。
| オプション | 型 | 必須 / デフォルト | 意味と使える値 |
|---|---|---|---|
name | string | 必須 | 新しい項目の名前。最小1文字、最大120文字 |
width | number | 必須 | 幅（ピクセル）。最小1、最大8192 |
height | number | 必須 | 高さ（ピクセル）。最小1、最大8192 |
relayoutLayers | boolean | 必須 | 既存のスマートレイアウトジェネレーターを使う |
ネストされた必須項目は、その親オブジェクトや配列の要素を指定した場合に適用されます。省略した任意の値には、デフォルトが記載されていないかぎり、既存の操作の動作が使われます。
Create Resized Copies (Custom Settings…) を選びます。次のシンプルな項目を入力するだけで、JSONは必要ありません。
- Name：
Square - Width (px)：
300 - Height (px)：
300 - Resize mode：Standard Resize
エージェントホストからの入力
{"command":"shortcut-layouts","parameters":{"name":"Square","width":"300","height":"300","relayoutLayers":"false"}}エージェントからショートカットを使う
下のリンク先にある機械可読のレジストリを読み、インストール済みプラグインのQuick Actionsの一覧にあるアクションを選びます。レジストリでは、標準のJSON SchemaではなくHypermatic独自のオプション定義を使っています。minとmaxは、項目の型に応じて文字列の長さ、配列の長さ、数値を制限します。ネストされた定義にはfieldsとitemを使います。未知の項目は拒否されます。
エージェントには、FigmaのQuick Actionsを呼び出し、通常のプラグインの結果を確認できるホストが必要です。パラメーターによってRESTやMCPのランチャーが追加されるわけではありません。展開できる例は、対応ホスト向けの入力データであり、実行可能なAPI呼び出しではありません。ショートカットの入力では、数値や形式の選択も含め、parametersにプレーンな文字列を使います。用意した入力だけを根拠に、ショートカットが実行されたと判断しないでください。
目に見える結果を確認してください。変更されたFigmaのレイヤー、保存されたエクスポート、公開されたページなどです。通常の成功・エラー通知と、一部のエクスポートに関する警告を読んでください。必要に応じて、OSの保存ダイアログを完了してください。ダウンロードが始まっても、ファイルが保存されたとは限りません。ユーザーが開発者ツールを開いたり、コンソールを読んだりする必要はありません。
トラブルシューティング
| 症状 | 次のステップ |
|---|---|
| アクションが使えない | プラグインを更新し、Quick Actionsの一覧を確認します。アクションが使えない場合は、通常のパネルを使います。 |
| オプションが無効、または切り捨てられた可能性がある | そのショートカットで使える項目だけを、150文字未満のプレーンな値で個別に入力します。 |
| 対象がない、または対象外 | 正しいページを開き、アクションのレイヤー要件を確認して、対象のレイヤーを選択し直します。 |
| ライセンスまたはトライアルのエラーが表示される | 再実行する前に、プラグインの通常の有効化手順を完了します。 |
| ダウンロードを要求したのに、保存されたファイルが見当たらない | OSの保存ダイアログと保存先を確認します。実際のファイルを確認してください。 |
| コマンドが失敗した、タイムアウトした、またはキャンセルされた | 再試行する前に、ドキュメントとリモートの保存先を確認します。それまでの変更やアップロードがすでに反映されている可能性があります。 |
コマンドの制限時間は5分です。エラーが起きても、すべてがロールバックされるわけではありません。作成、置き換え、アップロードを自動で再試行すると、作業が重複したり上書きされたりすることがあります。
機械可読のコマンドレジストリには、同じアクションIDとオプション定義が含まれています。
現在の制限
選択したバナーのエクスポートと、指定した1つのサイズでのリサイズコピーの作成ができます。新しいバナー、一括バリエーション、詳細なレイアウトの作成は、通常のパネルで行います。エクスポートのCustom Settingsでは、FramesかSectionsを選べます。