imgix APIs
動画 API
解像度

解像度

res

fm=mp4で提供されるビデオの解像度は、resパラメータで制御できます。 resパラメータはhighmedium、またはlowの値を受け入れますが、利用可能な解像度はアップロードされたビデオの解像度に依存します。

resパラメータは、fm=mp4が使用されている場合にのみビデオの解像度を変更します。

resが指定されていない場合、Video APIは最大1080pまでの解像度でMP4を提供します。これはMP4ビデオの最大解像度であり、res=highパラメータ値を使用しても返されます。ただし、これはアップロードされたビデオが少なくとも1080p以上である場合にのみ、1080pを返します。

res=mediumでリクエストされたビデオは、highから解像度が1段階低く、lowでのリクエストはmediumから解像度が1段階低くなります。

一般的に、highはFHDまたはHDビデオ(最大1080p)、mediumはSDビデオに対応し、lowmediumよりも低い解像度のビデオに対応します。

アップロードされたビデオの元の解像度に応じて、最大で3つの取得可能な解像度があります。

たとえば、元のビデオが480pの場合、取得可能な解像度は2つだけです:480p(res=medium)と480p未満の解像度、つまりres=lowです。このシナリオでは、このビデオをres=high(例:fm=mp4&res=high)でリクエストすると、利用可能な最高解像度(res=medium)が返されます。例として、480p SD元のビデオの可能な解像度レベルをいくつか示します:

  • https://{SUBDOMAIN}.imgix.video/480p-video?fm=mp4&res=high:利用可能な最高解像度ビデオ(480p)を返します
  • https://{SUBDOMAIN}.imgix.video/480p-video?fm=mp4&res=medium:SDビデオ(480p)を返します
  • https://{SUBDOMAIN}.imgix.video/480p-video?fm=mp4&res=lowres=mediumよりも低い解像度のビデオ(240p)を返します

元のビデオの解像度がSD未満の場合、利用可能な解像度はres=lowだけです。この場合、highmedium、およびlowはすべて同じビデオ解像度(唯一の解像度)に対応します。