此頁面已移動 - 您將在 3 秒內轉到 新位置 。請更新您的書籤!

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