編碼案例型移轉指引

---

重要

不再需要從 Azure 媒體服務 v2 移轉至 v3，因為 V2 API 的淘汰會與淘汰 Azure 媒體服務一致。 如需詳細資訊，請參閱 Azure 媒體服務淘汰指南 。

本文提供編碼案例型指引，可協助您從 Azure 媒體服務 v2 移轉至 v3。

必要條件

開始變更編碼工作流程之前，您應該先了解記憶體管理方式的差異。 在 AMS V3 中，Azure 儲存體 API 用來管理與媒體服務帳戶相關聯的儲存體帳戶。

注意

在 v2 中建立的作業和工作不會顯示在 v3 中，因為其與轉換沒有關聯。 建議是切換至 v3 轉換和作業。

編碼工作流程比較

請花幾分鐘的時間查看下面的流程圖，以取得 V2 和 V3 編碼工作流程的視覺效果比較。

V2 編碼工作流程

按一下下圖以查看更大的版本。

1. 安裝程式
   1. 建立資產或使用現有的資產。 如果使用新的資產，請將內容上傳至該資產。 如果使用現有的資產，您應該編碼已存在於資產中的檔案。
   2. 取得下列項目的值︰
      • 媒體處理器識別碼或物件
      • 您所要使用編碼器的編碼器字串 (名稱)
      • 新資產的資產識別碼或現有資產的資產識別碼
   3. 針對監視，建立作業或工作層級通知訂閱或 SDK 事件處理常式
2. 建立包含工作的作業。 每項工作都應包含上述項目和：
   • 需要建立輸出資產的指示詞。 輸出資產是由系統所建立。
   • 輸出資產的選用名稱
3. 提交作業。
4. 監視作業。

V3 編碼工作流程

1. 設定
   1. 建立資產或使用現有的資產。 如果使用新的資產，請將內容上傳至該資產。 如果使用現有的資產，您應該編碼已存在於資產中的檔案。 您不應該將更多內容上傳至該資產。
   2. 建立輸出資產。 輸出資產是將儲存所編碼檔案，以及輸入和輸出中繼資料的位置。
   3. 取得轉換的值：
      • 標準編碼器預設
      • AMS 資源群組
      • AMS 帳戶名稱
   4. 建立轉換或使用現有的轉換。 轉換可重複使用。 每次您想要提交作業，都不需要建立新的轉換。
2. 建立作業
   1. 針對作業，取得下列項目的值：
      • 轉換名稱
      • 資產 SAS URL 的基底 URI、檔案共用的 HTTP 來源路徑，或檔案的本機路徑。 JobInputAsset 也可以使用資產名稱作為輸入。
      • 檔案名稱
      • 輸出資產
      • 資源群組
      • AMS 帳戶名稱
3. 使用事件方格監視您的作業。
4. 提交作業。

從 V2 到 V3 編碼的自訂預設

如果您的 V2 程式碼使用自訂預設來呼叫標準編碼器，您必須首先使用自訂標準編碼器預設來建立新的轉換，然後再提交作業。

自訂預設現在是 JSON，不再是 XML 型。 遵循轉換 Open API (Swagger) 文件中所定義的自訂預設結構描述，在 JSON 中重新建立您的預設值。

來自編碼作業的輸入和輸出中繼資料檔案

在 v2 中，會產生 XML 輸入和輸出中繼資料檔案，作為編碼作業的結果。 在 v3 中，中繼資料的格式從 XML 變更為 JSON。 如需中繼資料的詳細資訊，請參閱輸入中繼資料和輸出中繼資料。

進階編碼器至 v3 標準編碼器或合作夥伴型解決方案

v2 API 不再支援進階編碼器。 如果先前使用工作流程型進階編碼器進行 HEVC 編碼，則應該移轉至新 v3 標準編碼器，其中具有 HEVC 編碼支援。

若需要進階編碼器的進階工作流程功能，建議開始使用 Azure 進階編碼合作夥伴解決方案 Imagine Communications、Telestream 或 Bitmovin。

輸入位於 HTTPS 裝載 URL 上的作業

您現在可以使用 HTTP(S) 作業輸入支援，從儲存在 Azure 儲存體 (本機儲存) 或儲存在外部網頁伺服器的檔案提交 V3 中的作業。

如果您先前曾使用工作流程將檔案從 Azure Blob 檔案複製到空白資產，然後再提交作業，則能夠直接將 Azure Blob 儲存體中檔案的 SAS URL 傳遞至作業，以簡化工作流程。

索引子 v1 音訊轉譯至新的 AudioAnalyzer「基本模式」

針對在 v2 API 中使用索引子 Indexer v1 處理器的客戶，您必須建立轉換，在提交作業之前，以AudioAnalyzer基本模式叫用新的 。

編碼、轉換和作業概念、教學課程和操作指南

• 使用媒體服務編碼影片和音訊
• 標準編碼器格式和轉碼器
• 使用自動產生的位元速率階梯進行編碼
• 使用內容感知編碼預設來尋找指定解析度的最佳位元速率值
• 編碼保留單元
• 輸入中繼資料
• 輸出中繼資料
• 媒體服務 v3 音訊轉碼器中的動態封裝

取得說明及支援

您可以連絡媒體服務並詢問問題，或依照下列其中一種方法追蹤我們的更新：

• 問與答
• Stack Overflow。 使用 azure-media-services標記問題。
• @MSFTAzureMedia 或使用 @AzureSupport 來要求支援。
• 透過 Azure 入口網站 開啟支援票證。