---
url: "/ja/pixelay/faq/troubleshooting.md"
description: "Pixelayの拡張機能の設定、URLの問題、エクスポートの不具合、ネットワークの制限に関するトラブルシューティングガイドです。"
---

# Pixelayのトラブルシューティング

> Pixelayの拡張機能の設定、URLの問題、エクスポートの不具合、ネットワークの制限に関するトラブルシューティングガイドです。

## URLでPixelayが読み込まれない（Chrome拡張機能が必要）

PixelayでデザインとURLを比較するには、[Pixelay Chromeプラグイン](https://chrome.google.com/webstore/detail/pixelay-for-figma/gnbafbeabkbkecmbedfgebgboicpnkpp)をインストールしてください。バックグラウンドで動作し、ブラウザでプラグインのURLを検出するとPixelayを読み込みます。

## Next.js（Vercel）のアプリが読み込まれない

PixelayでNext.jsのアプリを比較しようとすると、「Application error: a client-side exception has occurred」というメッセージが表示され、ページが読み込まれないことがあります。その場合は、Chrome拡張機能を使わない以下のリンクにPixelayのIDを入れてお試しください：https://pixelay.hypermatic.com/YOUR_PIXELAY_PROJECT_ID_HERE （例：https://pixelay.hypermatic.com/n4ok457201973 ）

## URLの有効期限

安全なリンクと画像は、180日間使われない（リンクが最後にアクセス・表示されてから180日が経過する）と自動的に削除されます。役目を終えたあとに、うっかり残ったままにならないようにするためです。

## エクスポートした画像の周りに細い白線が出る

まれに、画像の端にうっすらとした細い白線が入ることがあります。レイヤーの位置が整数のピクセル値になっていない場合（たとえばY: 156.76やX: 56.3）、Figmaは[この動作](https://twitter.com/Skcrub/status/1255544876701270017)によって、サブピクセルの線を自動的にエクスポートに含めてしまいます。この問題を解決するには、レイヤーの位置がすべて整数のピクセル値になっていることを確認してください。

## CSSの「vh」単位を使っているWebサイト

WebサイトのCSSで要素に「vh」単位を使っている場合、Pixelayはビューポートの高さをFigmaのモックアップ全体の高さに合わせるため、一般的なブラウザの高さで見るよりもずっと縦長に表示されることがあります。

## Figmaファイル用にまったく新しいURLを作成する

扱いに注意が必要な機能のため、クリックするボタンやアイコンは用意せず、プラグインの実行中にキーボードで「コナミコマンド」を入力したときだけ有効になるようにしています。

`Up, Up, Down, Down, Left, Right, Left, Right, B, A`

この順番でキーを入力すると、PixelayプラグインがFigmaファイル用にまったく新しいURLを作成します。たとえば複製したFigmaファイルでこれを入力すれば、元のファイルとは別の新しいURLを割り当てられます。

## エクスポートした画像が粗くなる

Figmaの画像アセットが段階的に読み込まれている途中でデザインをアップロードすると、画像がFigmaファイル内で完全に読み込まれる前にエクスポートされるため、ピクセル化した見た目になることがあります。これを解決するには、すべての画像が100%読み込まれ、Figmaファイル内で鮮明に表示されていることを確認してから、Pixelayプラグインで画像をアップロードしてください。

さらに、[「Downsizer」機能](/ja/tinyimage/downsize)を使って画像塗りをレイヤーのサイズに合わせて縮小すると、ファイルサイズが小さくなり、Figmaファイル内での読み込みもずっと速くなります。

## プラグインからデザインがアップロードされない、またはWebアプリで画像が読み込まれない

原因のひとつとして、インターネットサービスプロバイダー（ISP）がQUICプロトコルをブロックしている可能性があります。ブラウザまたはFigmaで開発者コンソールを開き、`ERR_QUIC_PROTOCOL_ERROR`というエラーメッセージが出ているかで確認できます。

この問題には、次の回避策があります。

1. コンピューターのインターネット接続を、スマートフォンのWi-Fiホットスポット・テザリングに切り替える
2. ブラウザで[QUICを無効にする](https://kinsta.com/knowledgebase/err_quic_protocol_error/)

## NetskopeによってPixelayのフレームの読み込みがブロックされる

[Netskope](https://www.netskope.com/)がFirebaseのデータベースへのアクセスをブロックするという既知の問題があります。解決するには、（[こちらのスレッド](https://stackoverflow.com/questions/52441316/firestore-grpc-behind-a-corporate-firewall-proxy)にあるとおり）`firestore.googleapis.com:443`を許可してください。

## 中国ではVPNが必要な場合がある

中国にお住まいの場合、アカウントサーバーが「グレート・ファイアウォール」によってブロックされている*可能性*があります。有効なキーを使っているのに有効化エラーが表示される場合は、おそらく[VPN](https://protonvpn.com/free-vpn/)を使って解決する必要があります。

## 「An error occurred while loading the plugin environment」と表示される

これは、Figmaデスクトップアプリで[Use Developer VM](https://www.figma.com/plugin-docs/debugging/#developer-vm)というデバッグ設定が誤って有効になっている場合に起こることがあります。オフになっているかを確認するには、Figmaキャンバス上の任意の場所を**右クリック**し、**Plugins**、**Development**の順にマウスカーソルを合わせて、**Use Developer VM**の*チェックが外れている*ことを確認します。チェックが外れたら（横にチェックマークが*付いていない*状態になったら）、Figmaプラグインを再実行すると正常に動作するはずです。
