即時 API：插入 ID3 計時的詮釋資料

本主題說明如何使用Live API將ID3定時元數據插入到Live流中。

概覽

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塊列表中的標籤，例如#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

    現在，有一些選項可以查看這些VOD播放列表以檢查時間碼：

  1. 您可以執行“捲曲”命令。範例：
    2. 
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
  2. 如果您使用Safari  在瀏覽器中，您可以播放主播放列表或塊列表之一。然後，打開開發人員網絡標籤並蒐索“清單列表”。選擇其中之一，然後查看“預覽”選項卡。
  3. 如果沒有Safari，則可以使用以下版本的Akamai播放器在其他瀏覽器中應用相同的過程https://players.akamai.com/hls/。將播放列表加載到Akamai播放器中，然後打開瀏覽器的“網絡”標籤並蒐索“列表”。
  4. 如果您具有代理服務器（例如“ Charles”），則原理相同。在Safari或Akamai HLS播放器中播放VOD播放列表之一，然後在代理中過濾結果以查看返回的塊列表之一。