在 Azure 中使用贊編碼器

Zencoder 可以從您的 Azure 容器上傳和下載文件(blob)。帳戶、容器和 blob 詳細信息必須嵌入到作業輸入的 URL 中 & 輸出。

使用 Azure

 

Azure URL 必須使用 azure://account-name:account-key@container/blob 格式。以下工作請求顯示瞭如何為輸入和輸出引用 Azure 位置:

{
    "api_key": "93h630j1dsyshjef620qlkavnmzui3",
    "input": "azure://account-name:account-key@container/file-name.avi",
    "outputs": [
    {
        "url": "azure://account-name:account-key@container/output-file-name.mp4",
        "width": "1280",
        "height": "720"
    }
    ]
}

account-nameaccount-key 應該是 CGI 轉義。與 Zencoder 中的其他 URL 一樣,不需要轉義任何其他內容。它們可以在 Azure 管理界面中找到。account-name 是存儲帳戶的名稱(鏈接到區域等)。密鑰位於帳戶概覽屏幕的底部。

每個 Azure 帳戶可以有多個容器。URL 中的 容器 字段必須先在 Azure 中定義和配置,然後才能在 Zencoder 作業中使用。

URL 中的 blob 字段表示文件的名稱。blob 是唯一不需要在 Azure 中預先配置的 URL 組件。

Azure SAS 令牌支持

Zencoder 中包含對授權 Azure 文件傳輸的支持。目前僅支持帳戶 SAS 令牌,並且至少需要“sv”、“si”、“sr”和“sig”參數作為令牌的一部分。

示例 SAS 令牌:

sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D

有兩種方法可以將 SAS 令牌與 Azure URL 一起包括在內:

  • 將令牌作為查詢字符串參數附加到 URL。
  • 使用“azure_sas”設置單獨提供令牌。

API 請求示例

輸入網址

查詢字符串版本
{  "input": "azure://account-name@container/path/to/input.mp4?sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"}
單獨的參數版本
{  "input": "azure://account-name@container/path/to/input.mp4",  "azure_sas": "sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"}

輸出網址

查詢字符串版本
{
  "outputs": [
    {
      "url": "azure://account-name@container/path/to/output.mp4?sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"
    }
  ]
}
單獨的參數版本
{
  "outputs": [
    {
      "url": "azure://account-name@container/path/to/output.mp4",  "azure_sas": "sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"
    }
  ]
}

縮略圖網址

對於縮略圖,基本 URL 通常不包含文件名。與輸出 URL 一樣,這將以保留包含 SAS 令牌的查詢字符串參數的方式進行更新。

查詢字符串版本

{
  "outputs": [
    {
      "thumbnails": [
        {
          "label": "my-thumbs",
          "number": 10,
          "base_url": "azure://account-name@container/path/to/thumbs/?sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"
        }
      ]
    }
  ]
}

單獨的參數版本

{
  "outputs": [
    {
      "thumbnails": [
        {
          "label": "my-thumbs",
          "number": 10,
          "base_url": "azure://account-name@container/path/to/thumbs/",
          "azure_sas": "sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"
        }
      ]
    }
  ]
}