プラグインのパネルを開かずに、FigmaのQuick ActionsからPixelayのよく使うタスクを実行できます。下の名前付きショートカットから選んでください。詳細な設定や作成作業には、通常のプラグインパネルを使います。
Quick Actionを実行する
どのショートカットにも、確認済みの有効なライセンスか、残りのトライアル回数が必要です。確認に失敗した場合やトライアル回数を使い切った場合は、通常のプラグインパネルを開いてライセンスを有効にしてください。パネルはいつでも開けます。
- ショートカットが選択を使う場合は、作業したいレイヤーを選択します。
- MacではCommand + /、WindowsではCtrl + / でFigmaのQuick Actionsを開きます。
- プラグインを検索し、下の名前付きショートカットを選びます。
- 表示されたフィールドに入力します。任意のフィールドは省略できます。編集するにはTabキーを使います。ショートカットを実行し、結果を確認するか、保存ダイアログを完了します。
作成用のショートカットは、名前や寸法を直接たずねます。選択したレイヤー用のショートカットは、現在の選択を自動的に使います。これらの日常的なショートカットでは、TargetやJSONの入力は求められません。通常のプラグインパネルを開くにはOpen Pixelayを選びます。
| ショートカット | 入力 |
|---|---|
| Upload Selected Comparisons | なし。すぐに実行されます |
選択肢が決まっているフィールドには、わかりやすいラベルが表示されます。表示されたラベルか内部の値で検索できます。エージェントの入力では、引き続きコマンドリファレンスに記載された値を使います。
Upload Selected Comparisonsを使う前に、通常のパネルで、選択したフレームのURLとページ全体のベースURLを設定してください。
コンテキストメニューから実行する
対象のレイヤーを選択して右クリックし、Plugins → Pixelayを選びます（開発中のプラグインはDevelopmentの下に表示されます）。アクションと、その形式またはプリセットを選びます。必須の入力がないプリセットはすぐに実行されます。保存ダイアログが表示された場合は完了してください。
各プリセットは、その名前のオプションを設定します。省略した互換性のあるオプションには、プラグインに保存された設定が引き継がれます。明示的に指定したアクションやオプションは、矛盾する保存済みの動作よりも優先されます。その実行で保存済みの設定を上書きするのは、明示的に入力したフィールドか、選択したメニュー項目だけです。一度も保存されていない設定には、通常の設定か、ドキュメントに記載されたフォールバックが適用されます。エクスポートの上書き設定は、環境設定には保存されません。保存済みの形式がショートカットで使えない場合は、対応している形式を明示的に選ぶか、通常のパネルを使ってください。オプションを組み合わせるには、アクション内でCustom Settings… を選び、パラメーターを入力します。テキスト、URL、名前、寸法が必要なアクションでは、引き続きそれらの必須フィールドの入力を求められます。Open Pixelayを選ぶと、通常のパネルが開きます。
| メニュー項目 | 次のステップ |
|---|---|
| Upload Selected Comparisons | すぐに実行されます |
詳細な編集
詳細な設定、長いコンテンツ、一括での作成、コンポーネントやテンプレートの閲覧には、通常のプラグインパネルを使います。ショートカットメニューには、上に記載した日常的なコマンドだけが含まれています。
貼り付ける各フィールドは150文字未満にしてください。Figmaのデスクトップアプリでは、その長さで貼り付けた入力が切り詰められることがあります。それより長い入力は、通常のパネルで行ってください。
古いプラグインでAction、Target、Optionsが表示される場合は、プラグインを更新して、これらの名前付きショートカットを使ってください。Targetの値はレイヤーIDまたは選択であり、新しく作成する項目の名前ではありません。
Pixelayのアクション
| アクション | 内容 | 対象 |
|---|---|---|
publish | 保存済みの比較用URLを使って、選択したフレームをアップロードします | 1つ以上の対象レイヤー |
publish
保存済みの比較用URLを使って、選択したフレームをアップロードします。対象となるレイヤーを1つ以上選択してください。
このショートカットには入力フィールドがありません。
これは、プラグインの既存のHypermaticサービスへの明示的な外部書き込みです。保存済みのアカウント設定を再利用し、既存のワークフローでアカウントを作成する場合があります。アップロードのエラー後に自動で再試行しないでください。部分的な出力がないか、送信先を確認してください。
Upload Selected Comparisonsを選びます。現在の選択を使って、すぐに実行されます。
エージェントホスト用の入力
{"command":"shortcut-publish","parameters":{}}エージェントでショートカットを使う
下にリンクした機械可読なレジストリを読み、インストール済みのプラグインのQuick Actionsの一覧にあるアクションを選びます。このレジストリは、標準のJSON SchemaではなくHypermatic独自のオプション定義を使います。minとmaxは、フィールドの型に応じて、文字列の長さ、配列の長さ、数値を制限します。ネストした定義にはfieldsとitemを使います。未知のフィールドは受け付けられません。
エージェントには、FigmaのQuick Actionsを呼び出し、通常のプラグインの結果を確認できるホストが必要です。パラメーターによって、RESTやMCPの起動手段が追加されるわけではありません。展開できる例は、互換性のあるホスト向けの入力データであり、実行可能なAPI呼び出しではありません。ショートカットの入力では、数値や形式の選択も含めて、parametersにプレーンな文字列を使います。用意した入力だけを根拠に、ショートカットが実行されたと報告しないでください。
目に見える結果を確認してください。変更されたFigmaのレイヤー、保存されたエクスポート、公開されたページなどです。通常の成功・エラー通知と、部分的なエクスポートに関する警告を読んでください。必要に応じてOSの保存ダイアログを完了してください。ダウンロードが始まっても、ファイルが保存されたことにはなりません。ユーザーが開発者ツールを開いたり、コンソールを読んだりする必要はありません。
トラブルシューティング
| 症状 | 次のステップ |
|---|---|
| アクションが使えない | プラグインを更新し、Quick Actionsの一覧を確認します。アクションが使えない場合は、通常のパネルを使います。 |
| オプションが無効、または切り詰められた可能性がある | そのショートカットが受け付けるフィールドだけに、150文字未満のプレーンな値を個別に入力します。 |
| 対象がない、または対象外である | 正しいページを開き、アクションのレイヤー要件を確認して、対象のレイヤーをもう一度選択します。 |
| ライセンスまたはトライアルのエラーが表示される | 再実行する前に、プラグインの通常の有効化手順を完了します。 |
| ダウンロードを要求したが、保存されたファイルが見当たらない | OSの保存ダイアログとダウンロード先を確認します。実際のファイルを確認してください。 |
| コマンドが失敗した、タイムアウトした、キャンセルされた | 再試行する前に、ドキュメントと送信先を確認します。それまでの変更やアップロードがすでに反映されている場合があります。 |
コマンドの制限時間は5分です。エラーが起きても、すべてが元に戻るわけではありません。作成、置き換え、アップロードを自動で再試行すると、作業が重複したり上書きされたりすることがあります。
機械可読なコマンドレジストリには、同じアクションIDとオプション定義が含まれています。
現在の制限
Publishは、既存のアカウント設定とアップロード機能を使います。アカウントを作成する場合があり、保存済みの比較を選択したフレームで置き換えます。ConfigureはローカルのURLの対応付けを保存するだけです。公開する前に、WebサイトのベースURLを設定しておく必要があります。