媒體服務中的轉換和作業

媒體服務標誌 v3


警告

Azure 媒體服務將於 2024 年 6 月 30 日淘汰。 如需詳細資訊,請參閱 AMS淘汰指南

提示

想要產生縮圖、將兩個視訊結合在一起、子剪輯影片,或 () 旋轉影片? 您可以在 [ 範例 ] 頁面上找到媒體服務範例程序代碼。

本主題提供轉換作業的詳細資料,並說明這些實體之間的關聯性。

一般工作流程

轉換就像是配方。 它可協助您 (步驟 1) 建立配方,並使用該配方提交作業 (步驟 2) 。

  1. 建立轉換。
  2. 在該轉換下提交工作。
  3. 列出轉換。
  4. 如果不打算在未來使用轉換,請刪除此轉換。

例如

假設您想要將所有影片的第一個畫面擷取為縮圖影像,而您採取的步驟如下:

  1. 定義用於處理影片的配方或規則:「將影片的第一個畫面當作縮圖」。
  2. 針對每個影片,您要告知服務:
    1. 影片所在位置。
    2. 和寫入輸出縮圖映像的位置。

注意

日期時間類型的轉換作業屬性一律為 UTC 格式。

轉換

使用轉換可設定視訊編碼或分析的一般工作。 每個轉換描述用於處理影片或音訊檔案的配方或工作流程。 單一轉換可套用多個規則。 例如,轉換可以指定每個視訊以指定的位元速率編碼至 MP4 檔案,並從影片第一幀畫面產生縮圖映像。 您將為每個您要加入轉換的規則新增 TransformOutput 項目。 您使用預設告知「轉換」應該如何處理輸入媒體檔案。

檢視結構描述

在媒體服務 v3 中,預設是 API 本身的強型別實體。 您可以在 Open API 規格 (或 Swagger) 中找到這些物件的「結構描述」定義。 您也可以在 REST API.NET SDK 或其他媒體服務 v3 SDK 參考文件中檢視預設定義 (例如 StandardEncoderPreset)。

建立轉換

您可以使用 REST、CLI 或任何已發佈的 SDK 來建立轉換。 媒體服務 v3 API 是由 Azure Resource Manager 所驅動,因此您也可以使用 Resource Manager 範本,在您的媒體服務帳戶中建立及部署轉換。 角色型存取控制可用於鎖定對「轉換」的存取。

更新轉換

如果您需要更新轉換,請使用更新作業。 主要用於變更基礎 TransformOutputs 的描述或優先順序。 當所有進行中的作業都完成時,您應該完成更新。 如需重寫配方,您必須建立新的轉換。

工作

作業是實際要求媒體服務將轉換套用至指定的輸入影片或音訊內容。 一旦建立轉換,您就可以使用媒體服務 API 或使用任何已發佈的 SDK 提交作業。 作業會指定輸入影片的位置、輸出的位置等資訊。 您可以使用這幾項來指定輸入影片的位置:HTTPS URL、SAS URL 或資產

來自 HTTPS 的作業輸入

如果您的內容已經可透過 URL 存取,而且您不需要將來源檔案儲存在 Azure (例如,從 S3) 匯入,請使用來自 HTTPS 的作業輸入。 如果您在 Azure Blob 儲存體中有內容,但不需要將檔案放在資產中,則此方法也適用。 目前,此方法僅支援單一檔案作為輸入。

資產作為作業輸入

如果輸入內容已在資產中,或內容儲存在本機檔案中,請使用資產作為作業輸入。 如果您打算發佈可供串流或下載的輸入資產 (假設您想要發佈 mp4 供下載,還想要執行語音轉換文字或臉部偵測),這也是不錯的選擇。 此方法支援多檔案資產 (例如,本機編碼的 MBR 串流集)。

檢查作業進度

您可以透過事件格線的監視事件取得作業的進度和狀態。 如需詳細資料,請參閱使用事件格線監視事件

更新作業

提交作業後,作業實體上的更新作業可用於修改「描述」和「優先順序」屬性。 只有在作業仍處於排入佇列的狀態時,才能有效變更「優先順序」屬性。 如果作業已開始處理,或已經處理完成,則變更優先順序不會有任何作用。

編碼範例

如需編碼,請參閱編碼 範例 的廣泛清單。

取得說明及支援

您可以連絡媒體服務並提出問題,或遵循下列其中一種方法來追蹤我們的更新: