--- url: "/ja/pitchdeck/automation/parameters.md" description: "名前付きのシンプルな入力項目と、現在の選択に使えるショートカットで、PitchdeckのQuick Actionsを実行します。" --- # PitchdeckのQuick Actions > 名前付きのシンプルな入力項目と、現在の選択に使えるショートカットで、PitchdeckのQuick Actionsを実行します。 プラグインのパネルを開かずに、FigmaのQuick ActionsからPitchdeckのよく使うタスクを実行できます。下の名前付きショートカットから選んでください。詳細な設定や作成作業には、通常のプラグインパネルを使います。 ## Quick Actionを実行する {#run-a-quick-action} どのショートカットも、有効なライセンスの確認が取れているか、トライアル回数が残っている必要があります。確認に失敗した場合やトライアル回数を使い切った場合は、通常のプラグインパネルを開いてライセンスを有効にしてください。パネルはいつでも開けます。 1. ショートカットが選択範囲を使う場合は、対象のレイヤーを選択します。 2. Macでは**Command + /**、Windowsでは**Ctrl + /** でFigmaのQuick Actionsを開きます。 3. プラグインを検索し、下の名前付きショートカットを選びます。 4. 表示されたフィールドに入力します。オプションのフィールドは省略できます。編集するにはTabキーを使います。ショートカットを実行し、結果を確認するか、保存ダイアログを完了します。 作成用のショートカットでは、名前やサイズを直接入力します。選択したレイヤー用のショートカットは、現在の選択を自動的に使います。これらの日常的なショートカットでは、TargetやJSONの入力は求められません。通常のプラグインパネルを開くには**Open Pitchdeck**を選びます。 | ショートカット | 入力項目 | | --- | --- | | **Export Selected Slides (Custom Settings…)** | Format（オプション）、Presentation content (PPTX only)（オプション） | 選択式のフィールドには、わかりやすいラベルが表示されます。表示されたラベルでも、内部の値でも検索できます。エージェントの入力には、引き続きコマンドリファレンスに記載された値を使います。 **Presentation content (PPTX only)** では、PowerPoint、Keynote、Google Slides向けに**Editable**と**Flattened**を選べます。このオプションを指定するときは、プレゼンテーションの形式を選んでください。省略すると、保存済みの設定が維持されます。編集可能なテキストには、出力先のアプリに元のフォントがインストールされている必要があります。テキストの編集よりも見た目の再現を優先する場合は、Flattenedを選んでください。画像、PDF、Canvaのエクスポートでは、引き続きそれぞれの形式の設定が使われます。 ## コンテキストメニューから実行する {#run-from-the-context-menu} 対象のレイヤーを選択して右クリックし、**Plugins → Pitchdeck**を選びます（開発中のプラグインは**Development**の下に表示されます）。アクションと、その形式またはプリセットを選びます。必須の入力がないプリセットはすぐに実行されます。保存ダイアログが表示された場合は完了してください。 各プリセットは、その名前のオプションを設定します。省略された互換オプションは、プラグインに保存された設定を引き継ぎます。明示的に指定したアクションやオプションは、矛盾する保存済みの動作より優先されます。その回の実行で保存済みの設定を上書きするのは、明示的に入力したフィールドか、選択したメニュー項目だけです。一度も保存されていない設定には、通常の設定またはドキュメントに記載されたフォールバックが適用されます。エクスポート時の上書き設定は、環境設定には保存されません。保存済みの形式がショートカットで使えない場合は、対応している形式を明示的に選ぶか、通常のパネルを使ってください。複数のオプションを組み合わせるには、アクション内の**Custom Settings…** を選んでパラメーターを入力します。テキスト、URL、名前、サイズが必要なアクションでは、引き続きそれらの必須フィールドの入力を求められます。**Open Pitchdeck**では通常のパネルが開きます。 | メニュー項目 | 次の手順 | | --- | --- | | **Export Selected Slides → Use Saved Settings** | すぐに実行されます | | **Export Selected Slides → PowerPoint (.pptx file)** | すぐに実行されます | | **Export Selected Slides → Keynote (.pptx file)** | すぐに実行されます | | **Export Selected Slides → Google Slides (.pptx file)** | すぐに実行されます | | **Export Selected Slides → PDF Deck (.pdf file)** | すぐに実行されます | | **Export Selected Slides → PDF for macOS Tahoe 'Preview' (.pdf)** | すぐに実行されます | | **Export Selected Slides → PNG Images (.zip file)** | すぐに実行されます | | **Export Selected Slides → JPG Images (.zip file)** | すぐに実行されます | | **Export Selected Slides → Canva (.psd files)** | すぐに実行されます | | **Export Selected Slides → PowerPoint Template (.potx file)** | すぐに実行されます | | **Export Selected Slides → Canva (Download PPTX)** | すぐに実行されます | | **Export Selected Slides → Pitch Presentation (.pptx file)** | すぐに実行されます | | **Export Selected Slides → MP4 Slideshow (.mp4 file)** | すぐに実行されます | | **Export Selected Slides → AI Agent Handoff (.zip file)** | すぐに実行されます | | **Export Selected Slides → Markdown & Images (.zip file)** | すぐに実行されます | | **Export Selected Slides → Local HTML Presentation (.zip file)** | すぐに実行されます | | **Export Selected Slides → Printable Handouts (.zip file)** | すぐに実行されます | | **Export Selected Slides → Export Selected Slides (Custom Settings…)** | Format（オプション）、Presentation content (PPTX only)（オプション）を入力 | ## 詳細な編集 {#detailed-editing} 詳細な設定、長いコンテンツ、まとめての作成、コンポーネントやテンプレートの閲覧には、通常のプラグインパネルを使います。ショートカットメニューには、上に記載した日常的なコマンドだけが含まれます。 貼り付ける各フィールドは150文字未満にしてください。Figmaデスクトップアプリでは、貼り付けた入力がその文字数で切り捨てられることがあります。それより長い入力は、通常のパネルで行ってください。 古いプラグインでAction、Target、Optionsが表示される場合は、プラグインを更新してこれらの名前付きショートカットを使ってください。Targetの値はレイヤーIDまたは選択範囲で、新しく作成する項目の名前ではありません。 ## Pitchdeckのアクション {#pitchdeck-actions} | アクション | 内容 | 対象 | | --- | --- | --- | | [`export`](#export) | 選択したスライドを公開せずにエクスポートします | 対象となる1つ以上のレイヤー | ### export {#export} 選択したスライドを公開せずにエクスポートします。対象となるレイヤーを1つ以上選択します。 | オプション | 型 | 必須 / デフォルト | 意味と使用できる値 | | --- | --- | --- | --- | | `format` | string | フォールバック：`"powerpoint"` | ローカルに保存するプレゼンテーションのエクスポート形式。`powerpoint`、`keynote`、`google`、`pdf`、`qpdf`、`png`、`jpg`、`canva`、`potx`、`canva-pptx`、`pitch-pptx`、`mp4`、`ai-handoff`、`markdown`、`offline-html`、`handouts` | | `editable` | boolean | フォールバック：`true` | PowerPointの要素を編集可能なまま保持する | ネストされた必須フィールドは、親のオブジェクトまたは配列の項目を指定した場合に適用されます。省略したオプションの値は、デフォルトが記載されていない限り、既存の処理の動作に従います。 **Export Selected Slides (Custom Settings…)** を選びます。次のプレーンなフィールドを入力します。JSONは不要です。 - **Format**：**PowerPoint (.pptx file)** - **Presentation content (PPTX only)**：**Editable** エージェントホスト用の入力 ```json {"command":"shortcut-export","parameters":{"format":"powerpoint","editable":"true"}} ``` ## エージェントでショートカットを使う {#using-shortcuts-with-an-agent} 下にリンクした機械可読なレジストリを読み、インストール済みのプラグインのQuick Actionsの一覧にあるアクションを選びます。レジストリは標準のJSON Schemaではなく、Hypermatic独自のオプション定義を使います。`min`と`max`は、フィールドの型に応じて文字列の長さ、配列の長さ、または数値を制限します。ネストされた定義には`fields`と`item`を使います。不明なフィールドは拒否されます。 エージェントには、FigmaのQuick Actionsを呼び出し、通常のプラグインの結果を確認できるホストが必要です。パラメーターによって、RESTやMCPの起動手段が追加されるわけではありません。展開できる例は対応ホスト向けの入力データで、実行可能なAPI呼び出しではありません。ショートカットの入力では、数値や形式の選択も含め、`parameters`にプレーンな文字列を使います。準備した入力があるだけで、ショートカットが実行されたと主張してはいけません。 目に見える結果を確認してください。変更されたFigmaのレイヤー、保存されたエクスポート、公開されたページなどです。通常の成功・エラー通知と、一部のエクスポートに関する警告を読みます。必要に応じてOSの保存ダイアログを完了してください。ダウンロードが始まっただけでは、ファイルが保存されたことの証明にはなりません。ユーザーが開発者ツールを開いたり、コンソールを読んだりする必要はありません。 ## トラブルシューティング {#troubleshooting} | 症状 | 次の手順 | | --- | --- | | アクションが使えない | プラグインを更新し、Quick Actionsの一覧を確認します。アクションが使えない場合は通常のパネルを使います。 | | オプションが無効、または切り捨てられた可能性がある | そのショートカットが受け付けるフィールドだけを使い、それぞれ150文字未満のプレーンな値を入力します。 | | 対象がない、または対象外 | 正しいページを開き、アクションのレイヤー要件を確認して、対象のレイヤーを選択し直します。 | | ライセンスまたはトライアルのエラーが表示される | 再実行する前に、プラグインの通常の有効化手順を完了します。 | | ダウンロードを要求したのに、保存されたファイルが見当たらない | OSの保存ダイアログとダウンロード先を確認します。実際のファイルを確認してください。 | | コマンドが失敗した、タイムアウトした、またはキャンセルされた | 再試行する前に、ドキュメントとリモートの送信先を確認します。それまでの変更やアップロードがすでに反映されている場合があります。 | コマンドの制限時間は5分です。エラーが発生しても、すべてが元に戻るとは限りません。作成、置き換え、アップロードを自動で再試行すると、作業が重複したり上書きされたりすることがあります。 [機械可読なコマンドレジストリ](/automation/parameters/pitchdeck.json)には、同じアクションIDとオプション定義が含まれています。 ## 現在の制限 {#current-limits} Figma Designでは、対象が既存のスライドの対象条件を満たしている必要があります。表示されているトップレベルのフレーム、コンポーネント、インスタンスで、幅が250 pxより大きく、高さが140 pxより大きいものが対象です。Figmaのネイティブ機能でスキップしたSlidesは除外されます。公開、アニメーションの編集、その他のプレゼンテーション形式は、引き続きインタラクティブに操作します。EditableまたはFlattenedのコンテンツは、エクスポートのCustom Settingsで設定します。スライドの作成や、テンプレート・テーマの選択は、通常のプラグインパネルで行います。 ## 関連ドキュメント {#related-documentation} - [Pitchdeckのインストールと実行](/ja/pitchdeck/overview/install) - [Figmaのプラグインパラメーター](https://developers.figma.com/docs/plugins/plugin-parameters/) - [Figmaの非表示UIオプション](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)