Live-API: Fügen Sie zeitgesteuerte ID3-Metadaten ein
Überblick
ID3-getaktete Metadaten werden verwendet, um Daten mit einem Livestream zu einem bestimmten Zeitpunkt zu senden. Um zeitgesteuerte ID3-Metadaten für einen laufenden Job einzufügen, machen Sie a POST
Anfrage zu:
https://api.bcovlive.io/v1/jobs/JOB_ID/id3tag
Beispielanfragetext
{
"id3_tag": {
"name": "cp1",
"value": "Some information I want to send",
"timecode": "15:50:49:16"
}
}
Beispielantwort
{
"id": "JOB_ID",
"id3_tag": {
"tag_name": "BCOV",
"tag_value": "my value"
}
}
Existieren SMPTE-Timecodes in der Eingabe?
Nicht alle Encoder senden SMPTE-Timecodes. Um zu überprüfen, ob sie in Ihrer Eingabe vorhanden sind, können Sie die VOD-Chunkliste nach Tags wie . überprüfen #VOD-TIMING:timecode=15:18:36:01,wallclock=1549047672441,tsvideo=25400,tsaudio=-1
. Die Vod-Chunklist-URL sollte verfügbar sein auf output_media_files[0].playback_url_vod
wenn Sie die Jobinformationen abrufen.
Analysieren Sie eine Live-Playlist, um den Timecode zu erhalten
Wenn Sie einen Brightcove Live-Auftrag erstellen, wird eine Standard-Master-Wiedergabeliste zurückgegeben. Zum Beispiel:
https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/playlist.m3u8
Wir benötigen die VOD-Master-Playlist, für die wir am letzten Teil unserer URL-Erweiterung "_vod" hinzufügen müssen, als playlist_vod.m3u8
https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/playlist_vod.m3u8
Die Playlist besteht aus mehrere Wiedergaben/Profile, dass Sie die Wiedergaben sehen können, wenn Sie die Wiedergabeliste "aufrollen". Beispiel:
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
Die vollständige Liste der Wiedergabeliste für Wiedergabeversionen/Profile wird sehen wie diese URLs "profile_0" und "profile_1" aus:
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
- Sie könnten einen "Curl"-Befehl ausführen. Beispiel:
- Wenn Sie die Safari verwenden Browser können Sie die Master-Playlist oder eine der Chunklists abspielen. Öffnen Sie dann die Registerkarte "Entwicklernetzwerk" und suchen Sie nach "chunklist". Wählen Sie eine davon aus und sehen Sie sich die Registerkarte Vorschau an.
- Wenn Sie Safari nicht haben, können Sie den gleichen Vorgang in einem anderen Browser mit dem Akamai-Player in anwenden
http://players.akamai.com/hls/
. Laden Sie die Playlist in den Akamai Player, öffnen Sie dann den Netzwerk-Tab Ihres Browsers und suchen Sie nach der "Chunklist". - Wenn Sie einen Stellvertreter als "Charles" haben, gilt das gleiche Prinzip. Spielen Sie eine der VOD-Wiedergabelisten im Safari- oder Akamai-HLS-Player ab und filtern Sie dann die Ergebnisse in Ihrem Proxy, um eine der zurückgegebenen Stücklisten anzuzeigen.
Jetzt gibt es einige Möglichkeiten, diese VOD-Wiedergabelisten anzusehen, um den Timecode zu überprüfen:
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