媒體服務追蹤 API

---

警告

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

媒體服務資產包含相關聯 Azure 記憶體帳戶中的媒體檔案。 這些檔案包含音訊、視訊和文字播放軌的數據。 追蹤 API 可讓您瞭解和管理資產中的追蹤。 DASH 或 HLS 視訊播放程式會使用曲目來呈現音訊、視訊和字幕或字幕， (文字) 給觀眾。 媒體服務串流端點會在要求時透過 DASH 指令清單或 HLS 播放清單，將播放軌的相關信息傳達給播放程式。

使用追蹤 API，您可以：

• 取得資產中的音訊、視訊和文字播放軌清單。
• 新增或移除文字播放軌。
• 新增或移除曲目。
• 指定文字或音訊播放軌的輔助功能屬性。
• 編輯 Azure 入口網站 中的曲目，或將其下載回資產。
• 在視訊播放程式中顯示或隱藏文字播放軌。

注意

您只能在視訊隨選 (VOD) 資產上新增或更新文字播放軌。 此外，即時串流資產不支援音訊晚期綁定。

文字播放軌

搭配本機產生的媒體使用文字播放軌

在本機產生影片和導出的輔助字幕之後，您可以將這些字幕上傳至包含隨選媒體的資產。

搭配本機產生的文字使用文字播放軌的一般工作流程：

1. 建立影片，並將標題匯出至 VTT 或 TTML 格式的檔案。
2. 翻譯或編輯 VTT 或 TTML 檔案，並儲存複本：
   1. 具有描述性文字以符合輔助功能需求的其他語言追蹤。
   2. 適用於主管評論的其他文字的追蹤。
3. 重要事項：您必須將語言指示項新增至 VTT 標頭，才能在用戶端播放機中顯示正確的語言。 例如：

   WEBVTT
   Language: en-us
   

4. 將影片上傳至媒體服務。
5. 建立轉換和作業來編碼視訊。
6. 上傳其他文字播放軌。

使用文字播放軌搭配即時轉譯

當即時轉譯針對即時活動開啟時，除了檢視者在即時影片播放程式上看到的實時轉譯播放軌之外，還會建立額外的WebVTT文字播放軌。 此 WebVTT 檔案包含包含完整句子而非部分實時結果的最佳即時文字記錄版本。 您可以在整個文字記錄可用且即時輸出被刪除之後下載 .vtt 檔案。

警告

最終自動產生的即時轉譯 VTT 檔案會延遲處理。 除非您在刪除實時輸出之前等候幾分鐘，否則檔案中的內容將會遭到截斷。 此外，實時轉譯不適用於即時活動的多個輸入數據流。

使用即時轉譯文字播放軌的一般工作流程：

1. 建立已啟用即時轉譯的即時活動，並選取來源語言。
2. 當即時活動結束時，請等候數分鐘，然後刪除實時輸出。 封存的資產將可供隨選串流使用。 您的檢視者仍然可以存取有效的串流 URL。
3. 列出封存資產中的曲目，或在入口網站中檢視它們。 將會有包含 NBest 轉譯的 WebVTT 檔案。 其擴展名為 .vtt。 檔案命名為 auto-generated-best_XXX.vtt。
4. 編輯 Azure 入口網站 中的 VTT 檔案，或下載並加以編輯。
5. 若要以多種語言呈現文字播放軌，請將來源文字播放軌翻譯成這些語言，並使用 .vtt 擴展名將它們儲存為每個語言的個別檔案。
6. 上傳來源語言播放軌，以及每個語言的文字播放軌。
7. 如果您不使用 Azure 入口網站 來上傳檔案，請編輯 (或更新) .ism 檔案，告知玩家要使用的文字播放軌，以及其捲標和可見性，方法是：
   1. 使用 追蹤 API 以程式設計方式使用其中一個 SDK 或 CLI 來更新指令清單：
      1. Node.JS
      2. Python
      3. 。網
      4. CLI

重要

更新 .ism 檔案時，請確定您隱藏即時轉譯文字播放軌，並以適用於查看器的語言顯示文字播放軌。

曲目

您可以將其他音訊曲目新增至資產，以提供不同語言的音訊給檢視者、新增輔助功能的描述性音訊，或新增 Director 的音樂。

音訊播放軌的一般工作流程

1. 建立即時活動的其他音訊播放軌。 它們可以是不同語言的音訊，或用於輔助功能的描述性音訊。 您也可以使用音訊播放軌進行主管的評論。
2. 將音訊曲目上傳至封存的資產。
3. 在入口網站中編輯指令清單檔案，或使用 REST 或 SDK 更新追蹤數據，以更新追蹤數據。

注意

拿掉音訊或文字播放軌時，基礎檔案不會從記憶體容器中移除。 媒體服務會將動態封裝程式設定 (串流端點) ，以在視訊播放程式要求的指令清單或播放清單中顯示播放軌的相關信息。

如需詳細的追蹤 API 步驟，請參閱下面的範例。

範例

• Node.JS 資產中的清單追蹤
• Node.JS 將 WebVTT 檔案新增至資產

操作說明、教學課程和快速入門

• 如何在即時活動期間產生的 Azure 入口網站 中編輯和上傳 VTT 檔案。 您可以使用相同的方法來上傳其他 WebVTT 曲目。
• 搭配 Azure 媒體服務和 Azure 媒體播放機使用 WebVTT 檔案

取得說明及支援

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

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