---
url: "/ja/tinyimage/automation/parameters.md"
description: "シンプルな名前付きの入力と、現在の選択を使うショートカットで、TinyImageのQuick Actionsを実行します。"
---

# TinyImageのQuick Actions

> シンプルな名前付きの入力と、現在の選択を使うショートカットで、TinyImageのQuick Actionsを実行します。

プラグインのパネルを開かずに、FigmaのQuick ActionsからTinyImageのよく使うタスクを実行できます。下の名前付きショートカットから選んでください。詳細な設定や作成作業には、通常のプラグインパネルを使います。

## Quick Actionを実行する {#run-a-quick-action}

開いているパネルにしか保持されないFigma Motionのコントロールは、実行間で保存されません。これらのコントロールには、ショートカットで明示的に入力した値か、ドキュメントに記載されたフォールバックが使われます。

どのショートカットにも、確認済みの有効なライセンスか、残りのトライアル回数が必要です。確認に失敗した場合やトライアル回数を使い切った場合は、通常のプラグインパネルを開いてライセンスを有効にしてください。パネルはいつでも開けます。

1. ショートカットが選択を使う場合は、作業したいレイヤーを選択します。
2. Macでは**Command + /**、Windowsでは**Ctrl + /** でFigmaのQuick Actionsを開きます。
3. プラグインを検索し、下の名前付きショートカットを選びます。
4. 表示されたフィールドに入力します。任意のフィールドは省略できます。編集するにはTabキーを使います。ショートカットを実行し、結果を確認するか、保存ダイアログを完了します。

作成用のショートカットは、名前や寸法を直接たずねます。選択したレイヤー用のショートカットは、現在の選択を自動的に使います。これらの日常的なショートカットでは、TargetやJSONの入力は求められません。通常のプラグインパネルを開くには**Open TinyImage**を選びます。

| ショートカット | 入力 |
| --- | --- |
| **Compress Selected Layers (Custom Settings…)** | Quality (1–100)（任意） |
| **Convert Selected Layers (Custom Settings…)** | Convert format、Quality (1–100)（任意） |
| **Export Selected Layers as PDF** | なし。すぐに実行されます |
| **Export Selected Figma Motion (Custom Settings…)** | Format（任意）、Frames per second（任意） |
| **Arrange Selected Layers (Custom Settings…)** | Layout（任意）、Horizontal gap (px)（任意）、Vertical gap (px)（任意） |

選択肢が決まっているフィールドには、わかりやすいラベルが表示されます。表示されたラベルか内部の値で検索できます。エージェントの入力では、引き続きコマンドリファレンスに記載された値を使います。

## コンテキストメニューから実行する {#run-from-the-context-menu}

対象のレイヤーを選択して右クリックし、**Plugins → TinyImage**を選びます（開発中のプラグインは**Development**の下に表示されます）。アクションと、その形式またはプリセットを選びます。必須の入力がないプリセットはすぐに実行されます。保存ダイアログが表示された場合は完了してください。

各プリセットは、その名前のオプションを設定します。省略した互換性のあるオプションには、プラグインに保存された設定が引き継がれます。明示的に指定したアクションやオプションは、矛盾する保存済みの動作よりも優先されます。その実行で保存済みの設定を上書きするのは、明示的に入力したフィールドか、選択したメニュー項目だけです。一度も保存されていない設定には、通常の設定か、ドキュメントに記載されたフォールバックが適用されます。エクスポートの上書き設定は、環境設定には保存されません。保存済みの形式がショートカットで使えない場合は、対応している形式を明示的に選ぶか、通常のパネルを使ってください。オプションを組み合わせるには、アクション内で**Custom Settings…** を選び、パラメーターを入力します。テキスト、URL、名前、寸法が必要なアクションでは、引き続きそれらの必須フィールドの入力を求められます。**Open TinyImage**を選ぶと、通常のパネルが開きます。

**Compress Selected Layers**は、通常のパネルで変換が保存されていても、常に元のエクスポート形式を維持します。WebP、AVIF、Tiny SVGを選ぶには**Convert Selected Layers**を使います。変換には形式の明示的な指定が必要です。品質を省略した場合や、その他の圧縮の環境設定は、引き続き保存済みの設定を引き継ぎます。品質を明示的に指定すると、その実行では保存済みのロスレスモードと目標サイズモードが無効になります。高度な呼び出し元は、これらのモードを明示的に有効にできます。エクスポートのショートカットが、Figmaの元のレイヤーの画像塗りを縮小することはありません。**Arrange Selected Layers**は常に整列を行い、レイアウトと間隔だけを引き継ぎます。名前の変更、並べ替え、インスタンスの折り返し、ページ番号テキストの更新は行いません。必要な場合は、詳細オプションでこれらの操作を明示的に指定してください。印刷用キャンバスの作成と印刷設定の調整は、通常のパネルで行います。Motionのフレームレートは、引き続きCustom Settingsで指定できます。

| メニュー項目 | 次のステップ |
| --- | --- |
| **Compress Selected Layers → Use Saved Settings** | すぐに実行されます |
| **Compress Selected Layers → Compress Selected Layers (Custom Settings…)** | Quality (1–100)（任意）を入力 |
| **Convert Selected Layers → JPG and PNG to WebP** | すぐに実行されます |
| **Convert Selected Layers → Only JPG to WebP** | すぐに実行されます |
| **Convert Selected Layers → Only PNG to WebP** | すぐに実行されます |
| **Convert Selected Layers → JPG and PNG to AVIF** | すぐに実行されます |
| **Convert Selected Layers → SVG to Tiny 1.2 SVG** | すぐに実行されます |
| **Convert Selected Layers → Convert Selected Layers (Custom Settings…)** | Convert format、Quality (1–100)（任意）を入力 |
| **Export Selected Layers as PDF** | すぐに実行されます |
| **Export Selected Figma Motion → Use Default Settings** | すぐに実行されます |
| **Export Selected Figma Motion → Animated GIF** | すぐに実行されます |
| **Export Selected Figma Motion → MP4 Video** | すぐに実行されます |
| **Export Selected Figma Motion → WebM Video** | すぐに実行されます |
| **Export Selected Figma Motion → Export Selected Figma Motion (Custom Settings…)** | Format（任意）、Frames per second（任意）を入力 |
| **Arrange Selected Layers → Use Saved Layout and Spacing** | すぐに実行されます |
| **Arrange Selected Layers → Automatic** | すぐに実行されます |
| **Arrange Selected Layers → Rows** | すぐに実行されます |
| **Arrange Selected Layers → Columns** | すぐに実行されます |
| **Arrange Selected Layers → Arrange Selected Layers (Custom Settings…)** | Layout（任意）、Horizontal gap (px)（任意）、Vertical gap (px)（任意）を入力 |

## 詳細な編集 {#detailed-editing}

詳細な設定、長いコンテンツ、一括での作成、コンポーネントやテンプレートの閲覧には、通常のプラグインパネルを使います。ショートカットメニューには、上に記載した日常的なコマンドだけが含まれています。

貼り付ける各フィールドは150文字未満にしてください。Figmaのデスクトップアプリでは、その長さで貼り付けた入力が切り詰められることがあります。それより長い入力は、通常のパネルで行ってください。

古いプラグインでAction、Target、Optionsが表示される場合は、プラグインを更新して、これらの名前付きショートカットを使ってください。Targetの値はレイヤーIDまたは選択であり、新しく作成する項目の名前ではありません。

## TinyImageのアクション {#tinyimage-actions}

| アクション | 内容 | 対象 |
| --- | --- | --- |
| [`compress`](#compress) | Figmaのエクスポート形式を変えずに、選択したレイヤーを圧縮します | 1つ以上の対象レイヤー |
| [`pdf`](#pdf) | 選択したフレームを、画面表示用の1つのPDFに結合します | 1つ以上の対象レイヤー |
| [`motion`](#motion) | 1つのソースから、ネイティブのFigma Motionをエクスポートします | ちょうど1つの対象レイヤー |
| [`convert`](#convert) | 選択したレイヤーを、明示的に選んだ出力形式に変換します | 1つ以上の対象レイヤー |
| [`tidy`](#tidy) | 明示的に指定した兄弟レイヤーを整列します。並べ替え、折り返し、名前の変更、ページ番号の更新には明示的なオプションが必要です | 1つ以上の対象レイヤー |

### compress {#compress}

Figmaのエクスポート形式を変えずに、選択したレイヤーを圧縮します。対象となるレイヤーを1つ以上選択してください。

| オプション | 型 | 必須 / デフォルト | 意味と使える値 |
| --- | --- | --- | --- |
| `quality` | number | フォールバック：`90` | 圧縮の品質。最小1、最大100 |

ネストした必須フィールドは、その親オブジェクトまたは配列の項目を指定した場合に適用されます。省略した任意の値には、デフォルトが記載されていない限り、既存の操作の動作が使われます。

**Compress Selected Layers (Custom Settings…)** を選びます。次のプレーンなフィールドに入力します。JSONは必要ありません。

- **Quality (1–100)**：`90`

エージェントホスト用の入力

```json
{"command":"shortcut-compress","parameters":{"quality":"90"}}
```

### pdf {#pdf}

選択したフレームを、画面表示用の1つのPDFに結合します。対象となるレイヤーを1つ以上選択してください。

このショートカットには入力フィールドがありません。

**Export Selected Layers as PDF**を選びます。現在の選択を使って、すぐに実行されます。

エージェントホスト用の入力

```json
{"command":"shortcut-pdf","parameters":{}}
```

### motion {#motion}

1つのソースから、ネイティブのFigma Motionをエクスポートします。対象となるレイヤーをちょうど1つ選択してください。

| オプション | 型 | 必須 / デフォルト | 意味と使える値 |
| --- | --- | --- | --- |
| `format` | string | フォールバック：`"GIF"` | アニメーションの形式。`GIF`、`MP4`、`WEBM` |
| `fps` | number | フォールバック：`30` | フレームレート（1秒あたりのフレーム数）。ネイティブのプランによる制限は引き続き適用されます。`10`、`15`、`24`、`25`、`30`、`60` |

ネストした必須フィールドは、その親オブジェクトまたは配列の項目を指定した場合に適用されます。省略した任意の値には、デフォルトが記載されていない限り、既存の操作の動作が使われます。

**Export Selected Figma Motion (Custom Settings…)** を選びます。次のプレーンなフィールドに入力します。JSONは必要ありません。

- **Format**：**Animated GIF**
- **Frames per second**：**30 fps**

エージェントホスト用の入力

```json
{"command":"shortcut-motion","parameters":{"format":"GIF","fps":"30"}}
```

### convert {#convert}

選択したレイヤーを、明示的に選んだ出力形式に変換します。対象となるレイヤーを1つ以上選択してください。

| オプション | 型 | 必須 / デフォルト | 意味と使える値 |
| --- | --- | --- | --- |
| `convert` | string | 必須 | 出力の変換。元の形式を維持するにはcompressを使います。`webp`、`webpjpg`、`webppng`、`avif`、`tinysvg` |
| `quality` | number | フォールバック：`90` | 圧縮の品質。最小1、最大100 |

ネストした必須フィールドは、その親オブジェクトまたは配列の項目を指定した場合に適用されます。省略した任意の値には、デフォルトが記載されていない限り、既存の操作の動作が使われます。

**Convert Selected Layers (Custom Settings…)** を選びます。次のプレーンなフィールドに入力します。JSONは必要ありません。

- **Convert format**：**JPG and PNG to WebP**
- **Quality (1–100)**：`90`

エージェントホスト用の入力

```json
{"command":"shortcut-convert","parameters":{"convert":"webp","quality":"90"}}
```

### tidy {#tidy}

明示的に指定した兄弟レイヤーを整列します。並べ替え、折り返し、名前の変更、ページ番号の更新には明示的なオプションが必要です。対象となるレイヤーを1つ以上選択してください。

| オプション | 型 | 必須 / デフォルト | 意味と使える値 |
| --- | --- | --- | --- |
| `layout` | string | フォールバック：`"auto"` | レイアウトの方向。`auto`、`rows`、`columns` |
| `horizontalSpacing` | number | フォールバック：`100` | 水平方向の間隔（ピクセル）。最小0、最大10000 |
| `verticalSpacing` | number | フォールバック：`100` | 垂直方向の間隔（ピクセル）。最小0、最大10000 |

ネストした必須フィールドは、その親オブジェクトまたは配列の項目を指定した場合に適用されます。省略した任意の値には、デフォルトが記載されていない限り、既存の操作の動作が使われます。

**Arrange Selected Layers (Custom Settings…)** を選びます。次のプレーンなフィールドに入力します。JSONは必要ありません。

- **Layout**：**Automatic**
- **Horizontal gap (px)**：`100`
- **Vertical gap (px)**：`100`

エージェントホスト用の入力

```json
{"command":"shortcut-tidy","parameters":{"layout":"auto","horizontalSpacing":"100","verticalSpacing":"100"}}
```

## エージェントでショートカットを使う {#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/tinyimage.json)には、同じアクションIDとオプション定義が含まれています。

## 現在の制限 {#current-limits}

圧縮では、選択したレイヤーのFigmaのエクスポート形式が使われます。変換には形式の選択が必要です。エクスポートのショートカットは、元の画像塗りを縮小しません。Motionが受け付けるソースは1つで、フレームレートはCustom Settingsで設定します。Arrangeが変更するのは、レイアウトと間隔だけです。印刷用キャンバス、ロゴ用キャンバス、動画の一括作成、Tidyの詳細なコントロールには、通常のパネルを使います。

## 関連ドキュメント {#related-documentation}

- [TinyImageのインストールと実行](/ja/tinyimage/overview/install)
- [Figma plugin parameters](https://developers.figma.com/docs/plugins/plugin-parameters/)
- [Figma hidden UI options](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)