使用 Azure 媒體服務的計時元數據

  • 發行項

媒體服務標誌 v3

警告

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

計時元數據是插入即時串流中的自定義數據。 數據及其插入時間戳都會保留在媒體數據流本身中。 如此一來，播放視訊數據流的用戶端可以取得與視訊串流完全相同的相同自定義元數據。 使用計時元資料，您可以：

  • 將互動專案新增至即時串流，例如投票。
  • 新增影片內容的相關信息，例如說話者、產品鏈接、運動球員統計數據等。
  • 新增有關 GPS 位置、時間等影片的元數據。

傳遞、張貼 URL 和要求

Azure 媒體服務會將計時元數據當作視訊串流的一部分傳遞。 計時元數據會透過POST傳送至端點進行計時元數據的即時活動。

注意

計時元數據僅適用於使用 RTMP 和 RTMPS 擷取所建立的即時活動。

POST URL

計時元數據端點的格式是以即時活動的 RTMP 內嵌 URL 為基礎。 例如：

https://<<LIVEEVENTNAME>.channel.media.azure.net/<LIVE_INGEST_ID>/ingest.isml/eventdata

例如：

rtmps://mylivestream.channel.media.azure-test.net:2935/live/0251458ba5df44b2b807ea02f40fed76

變成

https://mylivestream.channel.media.azure-test.net/0251458ba5df44b2b807ea02f40fed76/ingest.isml/eventdata

標頭和要求本文

HTTP 內容類型標頭 必須 設定為 application/json，因此請確定已正確設定。

POST https://mylivestream.channel.media.azure-test.net/0251458ba5df44b2b807ea02f40fed76/ingest.isml/eventdata
Content-Type: application/json

{

“message”: “Hello world!”

}

計時元數據限制

資源 預設限制 每個
訊息本文承載大小總計 最大值為 256 kb 要求
Requests 2 每秒

玩家示範和操作說明

若要試用訊號計時元數據，請參閱 如何發出計時元數據的訊號。

其他資訊

如需有關計時元數據訊號承載和格式的詳細資訊，請參閱 Common Media Application Format (CMAF) 規格中的 Open Media Carriage of ID3 Timed Metadata。

取得說明及支援

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