Azure Media Services を使用した時間指定メタデータ

[アーティクル]
06/30/2023

警告

Azure Media Services は、2024 年 6 月 30 日に廃止されます。詳細については、 AMS 廃止ガイドを参照してください。

時間指定メタデータは、ライブストリームに挿入されるカスタムデータです。データとその挿入タイムスタンプの両方が、メディアストリーム自体に保持されます。これは、ビデオストリームを再生しているクライアントが、ビデオストリームに関連して同じカスタムメタデータを同時に取得できるようにするためです。時間指定メタデータを使用すると、次のことができます。

投票などのライブストリームに対話機能要素を追加します。
スピーカー、製品リンク、スポーツ選手の統計など、ビデオコンテンツに関連する情報を追加します。
GPS の場所、時刻などのビデオに関するメタデータを追加します。

配信、投稿 URL、要求

Azure Media Services は、ビデオストリームの一部として時間指定メタデータを配信します。時間指定メタデータは、時間指定メタデータのために 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 Content-type ヘッダーは 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	/秒

プレーヤーのデモと方法

タイミングが設定されたメタデータのシグナル通知を試すには、「タイミングが設定されたメタデータを通知する方法」を参照してください。

ヘルプとサポート

質問がある場合は Media Services に問い合わせるか、次のいずれかの方法で更新内容に従ってください。

Q & A
Stack Overflow。質問にタグを付けます azure-media-services。
@MSFTAzureMedia するか、@AzureSupport を使用してサポートを要求します。
Azure portalからサポートチケットを開きます。

Share via