Live-API: ID3-Metadaten mit Zeitangabe einfügen

In diesem Thema wird erläutert, wie Sie zeitgesteuerte ID3-Metadaten mithilfe der Live-API in Ihren Live-Stream einfügen.

Ü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"
 }
}

Hinweis:

Nur id3_tag Objekt kann in einer Anfrage eingereicht werden
Wenn Sie das verwenden timecode -Eigenschaft speichert der Job nur die letzte Aufforderung zum Einfügen
Wenn Sie die timecode Eigenschaft verwenden, muss der Encoder den in der Eigenschaft tc gespeicherten Timecode im SMPTE-Format (HH:MM:SS:FF) über ONFi senden
Bei TS-Eingängen (RTP oder SRT) timecode wird der aus SEI-Bild-Timing-Nachrichten gelesen, die Teil des H.264-Videostreams sind. Diese Nachrichten haben separate Stunden-, Minuten-, Sekunden- und Rahmenfelder. Daher werden die Werte nicht in den SMPTE-formatierten String geparst.
Software-Encoder wie Wirecast und OBS nicht unterstützt das Senden von Timecode über OnFI-Pakete im RTMP-Stream
Elementare Hardware-Encoder tun unterstützt das Senden von Timecode über OnFI-Pakete im RTMP-Stream
ID3v2-Status-Tag name kann bis zu 4 Zeichen lang sein.
value kann bis zu 256 KB groß sein.
Timecode ist optional - wenn weggelassen, erfolgt das Einfügen sofort.

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 dies überprüfen, indem Sie in der VOD-Chunklist nach Tags wie #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

Jetzt gibt es einige Möglichkeiten, diese VOD-Wiedergabelisten anzusehen, um den Timecode zu überprüfen:

Sie könnten einen "Curl"-Befehl ausführen. Beispiel:


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

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 https://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.