サムネイルクエリーAPI

Ooyalaトランスコーディングシステムは、Backlotアカウントにアップロードされた各ビデオについて約15-30秒おきにサムネイル画像を作成します。

処理プロファイルにおけるエンコーディングの横幅が作成される画像のサイズを決定します。具体的にいうと、処理プロファイルでの各エンコーディング横幅Xに対して、サイズXとサイズX/3のサムネイル画像が作成されます。画像の特定サイズに関するサムネイルAPIへのクエリーも、これらのサイズに対して結果を検索します。完全な一致がない場合には、最も近いサイズのサムネイル画像が返されます。 ここで重要なのは、作成されるサムネイル画像は、Backlotにアップロードされた元のファイルのアスペクト比をそのまま維持することです。

Note: BacklotまたはAPI経由でアップロードされたカスタムプロモ画像は、サムネイルクエリーによって返されます。これらの画像は処理が行われず、利用可能な複数のサイズが作成されます。サムネイル画像はプロモ画像とは違います。元のプロモ画像はクエリーAPIインターフェース経由でアクセスすることが出来ます。

クエリーAPIサンプルにあるとおり、サムネイルクエリーはhttp://api.ooyala.com/partner/thumbnailsへの署名付きREST形式GETリクエストを使用して生成されます。

必須パラメータ:

  • pcode —アカウント識別子
  • expires – エポック(00:00:00 1/1/1970 GMT)からの秒単位のクエリー有効期限
  • embedCode — コンテンツ識別子
  • range — 返されるサムネイルインデックスを指定します。 形式: <from index>-<to-index>たとえば、最初の5つのサムネイル(インデックス0からインデックス4)を取得するには次の値を使用します: range=0-4.リクエストされた範囲が生成されたサムネイル数より大きい場合、利用可能なすべてのサムネイルが返されます。
  • resolution — サムネイルの表示に使用する画像サイズ。パラメータ形式は<横幅>x<高さ>です。例: resolution=320x240。 リクエストよりも大きい、ただし圧縮率がより高いJPEGが返されることがあることを留意して下さい。 この結果は希望のサイズにリサイズすることが出来ます。
  • signature — リクエストのデジタル署名。署名はSHA-256署名発行ルールを使用して算出されます。

リクエスト例

http://api.ooyala.com/partner/thumbnails?pcode=<pcode>&embedCode=<embedCode>
 &range=0-25&resolution=600x400&expires=<expiration>&signature=<signature>
 

サムネイルクエリー結果

クエリー結果はレスポンスボディの機能を果たすXML文書です。 ルートタグはそのリストの<thumbnail>タグとして含まれる一致したすべてのサブネイルを持つ<thumbnails>です。

ルート<thumbnails>タグには2つの属性があります。

  • embedCode — リクエストされたコンテンツID
  • aspectRatio — 約分されない分数で表わされる画像のアスペクト比。例:4/3 or 16/9。この属性には画像のアスペクト比が含まれており、実際の動画のアスペクト比を反映しています。

各<thumbnail>タグには以下が含まれます

  • index属性 — サムネイルのゼロから始まるインデックス。
  • timestamp属性 — サムネイルが作成されたビデオの時間(ミリ秒)
  • タグボディとしてのサムネイルURL

サムネイルクエリー結果の例

<?xml version="1.0" encoding="UTF-8"?>
<thumbnails aspectRatio="4/3" estimatedWidth="240" embedCode="kxYm06gFKXEleIHdyXNKeefx-QAu2yVp" requestedWidth="340">
  <thumbnail timestamp="0" index="0">http://ak.c.ooyala.com/kxYm06gFKXEleIHdyXNKeefx-QAu2yVp/Ut_HKthATH4eww8X5hMDoxOmc3O2T4mP</thumbnail>
  <thumbnail timestamp="9933" index="1">http://ak.c.ooyala.com/kxYm06gFKXEleIHdyXNKeefx-QAu2yVp/67AQECG82s3QgdEn5hMToxOmc3OwZ8Ex</thumbnail>
  <promoThumbnail>http://ak.c.ooyala.com/kxYm06gFKXEleIHdyXNKeefx-QAu2yVp/Ut_HKthATH4eww8X5hMDoxOmc3O2T4mP</promoThumbnail>
</thumbnails>
   

この記事はお役にたちましたか?