簡介
快速發布允許您使用 CAE 並且仍然可以通過創建一個或多個可以立即播放的臨時字幕來使視頻盡快上線。 然後,將滿足以下條件:
- 一旦有動態再現,就將使用它們而不是臨時再現進行播放
- 在處理完所有動態再現後的某個時間點,臨時再現將自動刪除
要求
為了使用快速發布,您必須:
- 啟用了一個帳戶 動態設計livery
- 為該帳戶啟用 CAE
- 使用以下命令創建自定義CAE接收配置文件 Ingest Profiles API (說明 下面)
自定義配置文件,可快速發布
創建啟用了快速發布的自定義配置文件非常簡單。 它看起來像是常規的CAE配置文件,但有一個區別: renditions
數組 dynamic_origin
對象將包含一個 temporary_renditions
包含一個或多個快速發布副本的數組。
快速發布的格式通過名稱和 必須的, 來自以下列表(以下數字 視頻或音頻 是演繹的目標比特率)。 如果願意,您可以在視頻再現之外還包括純音頻再現。
由於快速發布的目的是使演繹盡可能快地可供播放,因此對於至少一個臨時演繹,使用低到中檔的比特率可能是有意義的。
創建自定義配置文件的步驟
以下是使用一個臨時副本創建自定義快速發布配置文件的步驟。 在以下步驟中,我們將使用 multi-platform-standard-dynamic
標準配置文件作為自定義配置文件的基礎,但是您可以使用任何 CAE 配置文件。
獲取客戶端憑證 Ingest Profiles API
- 登錄Studio並轉到 API身份驗證部分 在管理員下(您必須是管理員或在帳戶上獲得管理員才能執行此操作)
- 點擊 註冊新申請 創建一組新的客戶端憑據。
- 選擇適當的帳戶,然後 至少 這些憑據的權限:
提取配置文件權限 - 保存 客戶ID 以及 客戶機密 因為您以後將需要它們。
為自定義配置文件創建JSON
- 複製下面的JSON(對於 多平台標準動態 個人資料)進入文本編輯器:
{ "name": "multi-platform-standard-dynamic", "display_name": "Multiplatform Standard (CAE)", "description": "Deliver a wide range of content types across a variety of platforms on mobile and desktop.", "account_id": YOUR_ACCOUNT_ID, "digital_master": { "rendition": "passthrough", "distribute": false }, "renditions": [], "packages": [], "dynamic_origin": { "renditions": [ "default/audio64", "default/audio128", "default/audio96" ], "images": [ { "label": "thumbnail", "height": 90, "width": 160 }, { "label": "poster", "height": 720, "width": 1280 } ], "dynamic_profile_options": { "min_renditions": 2, "max_renditions": 6, "min_resolution": { "width": 320, "height": 180 }, "max_resolution": { "width": 1280, "height": 720 }, "max_frame_rate": 30, "max_bitrate": 2400, "max_first_rendition_bitrate": 250, "keyframe_rate": 0.5, "select_baseline_profile_configuration": true } } }
- 更改以下值:
name
:“多平台標準動態快速發布”display_name
:“快速發布標準(CAE)”account_id
:“ YOUR_ACCOUNT_ID”
- 之後
dynamic_origin>renditions
數組,添加以下數組:"temporary_renditions": [ {"name": "default/video450"}, {"name": "default/video700"}, {"name": "default/video900"} ]
- 您的自定義配置文件的完整JSON現在應如下所示:
{ "name": "multi-platform-standard-dynamic-fast-publish", "display_name": "Fast Publish Standard (CAE)", "description": "Deliver a wide range of content types across a variety of platforms on mobile and desktop.", "account_id": "account_id", "digital_master": { "rendition": "passthrough", "distribute": false }, "renditions": [], "packages": [], "dynamic_origin": { "renditions": [ "default/audio64", "default/audio128", "default/audio96" ], "temporary_renditions": [ {"name": "default/video450"}, {"name": "default/video700"}, {"name": "default/video900"} ], "images": [ { "label": "thumbnail", "height": 90, "width": 160 }, { "label": "poster", "height": 720, "width": 1280 } ], "dynamic_profile_options": { "min_renditions": 2, "max_renditions": 6, "min_resolution": { "width": 320, "height": 180 }, "max_resolution": { "width": 1280, "height": 720 }, "max_frame_rate": 30, "max_bitrate": 2400, "max_first_rendition_bitrate": 250, "keyframe_rate": 0.5, "select_baseline_profile_configuration": true } } }
將自定義配置文件添加到您的帳戶
現在我們將使用 Ingest Profiles API 將自定義配置文件添加到您的帳戶。
獲取訪問令牌
每個API請求都需要使用訪問令牌進行身份驗證(您將在後面的步驟中確切看到操作方式)。
- 你需要 獲取訪問令牌 從:
https://oauth.brightcove.com/v4/access_token
- 如果您使用的是 失眠 or 郵差,則可以使用鏈接文檔中的說明來設置OAuth2身份驗證,以使它們為您獲取訪問令牌。
- 如果您使用的是cURL,則可以使用以下cURL命令獲取訪問令牌-您需要替換
ENCODED_AUTHENTICATION_STRING
使用Base64編碼的字符串,其中包含client_id:client_secret:
curl --request POST \ --url 'https://oauth.brightcove.com/v4/access_token?grant_type=client_credentials' \ --header 'Authorization: Basic ENCODED_AUTHENTICATION_STRING' \ --header 'Content-Type: application/x-www-form-urlencoded'
- 請注意,訪問令牌會在5分鐘後過期-如果發生這種情況,只需獲取一個新令牌(失眠會在需要時自動為您提供一個)。
添加自定義提取配置文件
- 如果您使用的是 失眠 or 郵差,將新的POST請求設置為:
https://ingestion.api.brightcove.com/v1/accounts/account_id/profiles
請求主體將是您先前創建的自定義配置文件的JSON。
包括一個
Content-Type: application/json
頭根據使用失眠或郵遞員的指南中的說明設置OAuth2身份驗證。
- 如果使用的是cURL,則可以使用以下請求,將account_id替換為您自己的訪問令牌值:
curl --request POST \ --url https://ingestion.api.brightcove.com/v1/accounts/57838016001/profiles \ --header 'authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'content-type: application/json' \ --data '{ "name": "multi-platform-standard-dynamic-fast-publish", "display_name": "Fast Publish Standard (CAE)", "description": "Deliver a wide range of content types across a variety of platforms on mobile and desktop.", "account_id": "YOUR_ACCOUNT_ID", "digital_master": { "rendition": "passthrough", "distribute": false }, "renditions": [], "packages": [], "dynamic_origin": { "renditions": [ "default/audio64", "default/audio128", "default/audio96" ], "temporary_renditions": [ {"name": "default/video450"}, {"name": "default/video700"}, {"name": "default/video900"} ], "images": [ { "label": "thumbnail", "height": 90, "width": 160 }, { "label": "poster", "height": 720, "width": 1280 } ], "dynamic_profile_options": { "min_renditions": 2, "max_renditions": 6, "min_resolution": { "width": 320, "height": 180 }, "max_resolution": { "width": 1280, "height": 720 }, "max_frame_rate": 30, "max_bitrate": 2400, "max_first_rendition_bitrate": 250, "keyframe_rate": 0.5, "select_baseline_profile_configuration": true } } }'
- 發送請求後,您應該會在響應中看到新的配置文件回顯給您。
通知
創建快速發布的臨時演繹後,您將收到 DYNAMIC_RENDITION
“創建”通知的方式與常規格式相同:
{
"entity": "contextAwareEncoding5",
"entityType": "DYNAMIC_RENDITION",
"version": "1",
"action": "CREATE",
"jobId": "413a9938-6d73-478c-b4d9-fdeb45927a4b",
"videoId": "5600255921001",
"dynamicRenditionId": "contextAwareEncoding5",
"bitrate": 364,
"width": 512,
"height": 384,
"accountId": "1910141566001",
"status": "SUCCESS"
}
刪除臨時移交後,將發送新的通知:
{
"entity": "fastpublishRendition1",
"entityType": "DYNAMIC_RENDITION",
"version": "1",
"action": "DELETE",
"jobId": "413a9938-6d73-478c-b4d9-fdeb45927a4b",
"videoId": "5600255921001",
"dynamicRenditionId": "fastpublishRendition1",
"accountId": "1910141566001",
"status": "SUCCESS"
}