プラグインパネルを開かずに、FigmaのQuick ActionsからConvertifyのよく使う作業を実行できます。下記の名前付きショートカットを選んでください。詳細な設定や作成作業には、通常のプラグインパネルを使います。
Quick Actionを実行する
どのショートカットも、有効なライセンスの確認が取れているか、トライアル回数が残っている必要があります。確認に失敗した場合やトライアルの期限が切れている場合は、通常のプラグインパネルを開いてライセンスを有効にしてください。パネルはいつでも開けます。
- ショートカットが選択を使う場合は、対象のレイヤーを選択します。
- MacではCommand + /、WindowsではCtrl + / でFigmaのQuick Actionsを開きます。
- プラグインを検索し、下記の名前付きショートカットを選びます。
- 表示された項目を入力します。任意の項目は省略でき、Tabキーで編集できます。ショートカットを実行し、結果を確認するか保存ダイアログを完了します。
作成系のショートカットでは、名前やサイズを直接入力します。選択したレイヤーを使うショートカットは、現在の選択を自動的に使います。これらの日常的なショートカットでは、TargetやJSONの入力は求められません。通常のプラグインパネルを開くにはOpen Convertifyを選びます。
| ショートカット | 入力項目 |
|---|---|
| Export Selected Layers (Custom Settings…) | Format（任意） |
選択肢が決まっている項目には、わかりやすいラベルが表示されます。表示されたラベルでも、内部の値でも検索できます。エージェントからの入力には、引き続きコマンドリファレンスに記載された値を使います。
コンテキストメニューから実行する
対象のレイヤーを選択して右クリックし、Plugins → Convertifyを選びます（開発中のプラグインはDevelopmentの下に表示されます）。アクションと、その形式またはプリセットを選びます。必須の入力がないプリセットはすぐに実行されます。保存ダイアログが表示された場合は完了してください。
各プリセットは、それぞれの名前のオプションを設定します。省略した互換オプションには、プラグインに保存されている設定が引き継がれます。明示的に指定したアクションやオプションは、矛盾する保存済みの動作より優先されます。その実行に限って保存済みの設定を上書きするのは、明示的に入力した項目か、選んだメニュー項目だけです。一度も保存されていない設定には、通常の設定またはドキュメントに記載されたフォールバックが適用されます。エクスポート時の上書きは設定に保存されません。保存済みの形式がショートカットで使えない場合は、対応する形式を明示的に選ぶか、通常のパネルを使ってください。複数のオプションを組み合わせるには、アクション内でCustom Settings… を選び、パラメーターを入力します。テキスト、URL、名前、サイズが必要なアクションでは、引き続きそれらの必須項目の入力を求められます。Open Convertifyは通常のパネルを開きます。
| メニュー項目 | 次のステップ |
|---|---|
| Export Selected Layers → Use Saved Settings | すぐに実行 |
| Export Selected Layers → Adobe Photoshop (.psd) | すぐに実行 |
| Export Selected Layers → Canva (.psd) | すぐに実行 |
| Export Selected Layers → Sketch (.sketch) | すぐに実行 |
| Export Selected Layers → EPS Vector (.eps) | すぐに実行 |
| Export Selected Layers → Adobe XD (.xd) | すぐに実行 |
| Export Selected Layers → Adobe After Effects | すぐに実行 |
| Export Selected Layers → Adobe InDesign (.idml) | すぐに実行 |
| Export Selected Layers → Export Selected Layers (Custom Settings…) | Format（任意）を入力 |
詳細な編集
詳細な設定、長いコンテンツ、一括での作成、コンポーネントやテンプレートの閲覧には、通常のプラグインパネルを使います。ショートカットメニューには、上記の日常的なコマンドだけが含まれています。
貼り付ける項目は、それぞれ150文字未満にしてください。Figmaデスクトップアプリでは、貼り付けた入力がその長さで切り詰められることがあります。それより長い入力は通常のパネルで行ってください。
古いプラグインでAction、Target、Optionsが表示される場合は、プラグインをアップデートしてこれらの名前付きショートカットを使ってください。Targetの値はレイヤーIDまたは選択であり、新しく作成する項目の名前ではありません。
Convertifyのアクション
| アクション | 内容 | 対象 |
|---|---|---|
export | 既存のエクスポーターを使って、選択したレイヤーを変換します | 対象となる1つ以上のレイヤー |
export
既存のエクスポーターを使って、選択したレイヤーを変換します。対象となるレイヤーを1つ以上選択してください。
| オプション | 型 | 必須・デフォルト | 意味と使用できる値 |
|---|---|---|---|
format | string | フォールバック："psd" | ローカルでの変換形式。psd、canva、sketch、eps、xd、ae、idml |
ネストされた必須項目は、その親オブジェクトや配列の要素を指定した場合に適用されます。省略した任意の値には、デフォルトが記載されていない限り、既存の処理の動作が使われます。
Export Selected Layers (Custom Settings…) を選びます。次のプレーンな項目を入力します。JSONは不要です。
- Format：Adobe Photoshop (.psd)
エージェントホスト向けの入力
{"command":"shortcut-export","parameters":{"format":"psd"}}エージェントでショートカットを使う
下記リンクの機械可読なレジストリを読み、インストール済みプラグインのQuick Actionsの一覧にあるアクションを選びます。レジストリは、標準のJSON SchemaではなくHypermatic独自のオプション定義を使っています。minとmaxは、項目の型に応じて文字列の長さ、配列の長さ、または数値を制限します。ネストされた定義にはfieldsとitemを使います。不明な項目は拒否されます。
エージェントには、FigmaのQuick Actionsを呼び出し、通常のプラグインの結果を確認できるホストが必要です。パラメーターによってRESTやMCPの起動手段が追加されるわけではありません。展開できる例は、対応するホスト向けの入力データであり、実行可能なAPI呼び出しではありません。ショートカットの入力では、数値や形式の選択も含め、parametersにプレーンな文字列を使います。用意した入力だけをもとに、ショートカットが実行されたと主張してはいけません。
目に見える結果を確認してください。変更されたFigmaレイヤー、保存されたエクスポート、公開されたページなどです。通常の成功・エラー通知と、部分的なエクスポートに関する警告を確認します。必要に応じてネイティブの保存ダイアログを完了してください。ダウンロードが始まっただけでは、ファイルが保存されたことにはなりません。ユーザーが開発者ツールを開いたり、コンソールを確認したりする必要はありません。
トラブルシューティング
| 症状 | 次のステップ |
|---|---|
| アクションが使えない | プラグインをアップデートし、Quick Actionsの一覧を確認します。アクションが使えない場合は通常のパネルを使います。 |
| オプションが無効、または切り詰められた可能性がある | 個々のプレーンな項目の値を150文字未満にし、そのショートカットが受け付ける項目だけを使います。 |
| 対象がない、または対象として使えない | 正しいページを開き、アクションのレイヤー要件を確認して、対象のレイヤーを選択し直します。 |
| ライセンスまたはトライアルのエラーが表示される | 再実行する前に、プラグインの通常の有効化手順を完了します。 |
| ダウンロードを依頼したのに、保存されたファイルが見当たらない | ネイティブの保存ダイアログとダウンロード先を確認します。実際のファイルを確認してください。 |
| コマンドが失敗した、タイムアウトした、またはキャンセルされた | 再試行する前に、ドキュメントとリモートの保存先を確認します。それまでの変更やアップロードがすでに反映されている場合があります。 |
コマンドの制限時間は5分です。エラーが発生しても、すべてがロールバックされるとは限りません。作成、置き換え、アップロードを自動で再試行すると、作業が重複したり上書きされたりすることがあります。
機械可読なコマンドレジストリには、同じアクションIDとオプション定義が含まれています。
現在の制限事項
パラメーターのテキストではローカルファイルのデータを渡せないため、ファイルのインポートはすべて引き続き対話形式で行います。After Effectsでは既存のXD経由の受け渡し形式を使い、IDMLでは既存のZIPパッケージが作成されます。既存の変換処理と、ドキュメントを一時的に元に戻す動作はそのまま維持されます。