Azure Media Services を使用した時間指定メタデータ
警告
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 | /秒 |
プレーヤーのデモと方法
タイミングが設定されたメタデータのシグナル通知を試すには、「タイミングが設定 されたメタデータを通知する方法」を参照してください。
関連情報
時間指定メタデータ信号のペイロードと形式の詳細については、 Common Media Application Format (CMAF) 仕様の「Alliance for Open Media Carriage of ID3 Timed Metadata」を参照してください。
ヘルプとサポート
質問がある場合は Media Services に問い合わせるか、次のいずれかの方法で更新内容に従ってください。
- Q & A
-
Stack Overflow。 質問に タグを付けます
azure-media-services
。 - @MSFTAzureMedia するか 、@AzureSupport を使用してサポートを要求します。
- Azure portalからサポート チケットを開きます。