imgix APIsレンダリング APIフォーマットクライアントヒント

クライアントヒント

ch

警告: バージョン67以降、Chromeはサードパーティのオリジンにクライアントヒントを送信しなくなり、それらがそれ以外では利用できない情報にアクセスするのを防止します。この機能は今後復活する可能性があります。

注意: ch は imgix のキャッシュインフラストラクチャとの相互作用のため、ソースのデフォルトパラメーターとして設定できません。

ch パラメーターは、ブラウザヘッダーを使用して自動的なリソース選択を提供する クライアントヒント を使用する特定の画像をオプトインさせます。imgix は現在、次の3つのヒントをサポートしており、それぞれの imgix パラメーターをオーバーライドまたは変更します:

  • Width は imgix の w パラメーターをオーバーライドします
  • DPR は imgix の dpr パラメーターをオーバーライドします
  • Save-Data は画像品質を q=45 に低下させ、画像の出力形式を変更する場合があります

複数のクライアントヒントを使用することができます。値はカンマで区切られます。ブラウザがクライアントヒントをサポートしていない場合、URLに他の値が存在する場合はそれらが使用されます。たとえば、以下のURLは、ブラウザがそれらをサポートしていない場合、幅が400デバイス独立ピクセルで2 DPRの画像にフォールバックし、WidthDPR クライアントヒントを活用します。

https://assets.imgix.net/unsplash/bear.jpg?ch=Width,DPR&w=400&dpr=2

注意: Save-Data をサポートするすべてのブラウザは、ヘッダーを送信します。クライアントヒントメタタグが存在するかどうかに関係なく。ただし、他のクライアントヒントを使用する場合は、次のようにサイトの <meta> タグに次のコードを含める必要があります。

<meta http-equiv="Accept-CH" content="Width,DPR">

詳細や使用例については、次のリンクを参照してください:

Base64非対応

このパラメーターは、base64エンコードされた値を受け取りません。すべての値は標準のUTF8、URLエンコードされた文字列として提供する必要があります。