Live API:ID3 時限メタデータを挿入する
概要
ID3 時限メタデータは、特定の時点でライブストリームでデータを送信するために使用されます。進行中のジョブに ID3 時限メタデータを挿入するには、POST
以下のリクエストを実行します。
https://api.bcovlive.io/v1/jobs/JOB_ID/id3tag
リクエスト本文の例
{
"id3_tag": {
"name": "cp1",
"value": "Some information I want to send",
"timecode": "15:50:49:16"
}
}
レスポンスの例
{
"id": "JOB_ID",
"id3_tag": {
"tag_name": "BCOV",
"tag_value": "my value"
}
}
入力に SMPTE タイムコードが存在しますか?
すべてのエンコーダが SMPTE タイムコードを送信するわけではありません。入力にそれらが存在するかどうかをチェックするには、VOD チャンクリストでのようなタグを調べる方法の 1 #VOD-TIMING:timecode=15:18:36:01,wallclock=1549047672441,tsvideo=25400,tsaudio=-1
つがあります。vod チャンクリスト URL は、output_media_files[0].playback_url_vod
ジョブ情報を取得するときに利用可能である必要があります。
ライブプレイリストを解析してタイムコードを取得する
Brightcove Live ジョブを作成すると、デフォルトのマスタープレイリストが返されます。例:
https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/playlist.m3u8
VODマスタープレイリストが必要です。そのためには、URL拡張の最後の部分に「_vod」を playlist_vod.m3u8 として追加する必要があります。
https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/playlist_vod.m3u8
プレイリストは、 複数のレンディション/プロファイルで構成され、プレイリストを「カール」すると、レンディションを見ることができます。例:
curl -i "https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/playlist_vod.m3u8"
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-STREAM-INF:BANDWIDTH=4292608,CODECS="avc1.100.41,mp4a.40.2",RESOLUTION=1920x1080
profile_0/chunklist_vod.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=2654208,CODECS="avc1.100.41,mp4a.40.2",RESOLUTION=1280x720
profile_1/chunklist_vod.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=1937408,CODECS="avc1.77.41,mp4a.40.2",RESOLUTION=960x540
profile_2/chunklist_vod.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=1118208,CODECS="avc1.77.31,mp4a.40.2",RESOLUTION=640x360
profile_3/chunklist_vod.m3u8
レンディション/プロファイルプレイリストの完全なリストは、次の「profile_0」および「profile_1」URL のようになります。
https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/profile_0/chunklist_vod.m3u8
https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/profile_1/chunklist_vod.m3u8
- あなたは「カール" コマンドを行うことができます。例:
- Safariブラウザを使用している場合は、マスタープレイリストまたはチャンクリストの1つを再生できます。次に、開発者ネットワークタブを開き、「chunklist」を検索します。そのうちの 1 つを選択し、[プレビュー] タブを確認します。
- Safari をお持ちでない場合は、の Akamai プレーヤーを使用して、別のブラウザで同じプロセスを適用できます
http://players.akamai.com/hls/
。Akamai Player でプレイリストを読み込み、ブラウザのネットワークタブを開いて「チャンクリスト」を検索します。 - あなたがプロキシを持っているなら、「チャールズ」として、それは同じ原則です。Safari または Akamai HLS プレーヤーで VOD プレイリストの 1 つを再生し、プロキシで結果をフィルタリングして、返されたチャンクリストの 1 つを確認します。
これで、これらの VOD プレイリストを見てタイムコードをチェックするオプションがいくつかあります。
curl -i "https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/profile_0/chunklist_vod.m3u8"
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:8
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-DISCONTINUITY-SEQUENCE:0
#EXT-X-INDEPENDENT-SEGMENTS
#BCOV-RENDITION-DATA-X-STREAM-INF:BANDWIDTH=4292608,RESOLUTION=1920x1080,FRAME-RATE=25.000,CODECS="mp4a.40.2,avc1.100.41"
#VOD-STARTTIMESTAMP:1573207934483
#VOD-MANIFESTSTARTTIME:1573207934483
#VOD-TOTALDELETEDDURATION:0.0
#VOD-FRAMERATE:25.0
#VOD-TIMING:timecode=null,wallclock=1573207934483,tsvideo=3480040,tsaudio=3480007
#EXT-X-PROGRAM-DATE-TIME:2019-11-08T10:12:11.871+00:00
#EXTINF:7.2,
2etzot2c_66e2f8bc56774f4b9a2e26adee46c5b3_media_2.ts
#VOD-TIMING:timecode=null,wallclock=1573207941720,tsvideo=3487240,tsaudio=3487239
#EXT-X-PROGRAM-DATE-TIME:2019-11-08T10:12:19.071+00:00