API en direct : Insérer des métadonnées programmées ID3
Aperçu
Les métadonnées temporelles ID3 sont utilisées pour envoyer des données avec un flux en direct à un moment précis. Pour insérer des métadonnées temporisées ID3 pour un travail en cours, effectuez un POST
demande à:
https://api.bcovlive.io/v1/jobs/JOB_ID/id3tag
Exemple de corps de requête
{
"id3_tag": {
"name": "cp1",
"value": "Some information I want to send",
"timecode": "15:50:49:16"
}
}
Exemple de réponse
{
"id": "JOB_ID",
"id3_tag": {
"tag_name": "BCOV",
"tag_value": "my value"
}
}
Existe-t-il des timecodes SMPTE dans l'entrée ?
Tous les encodeurs n'envoient pas de timecodes SMPTE. Pour vérifier s'ils existent dans votre entrée, une façon de vérifier est de regarder la liste de morceaux VOD pour les balises comme #VOD-TIMING:timecode=15:18:36:01,wallclock=1549047672441,tsvideo=25400,tsaudio=-1
. L'URL de la liste de morceaux vod devrait être disponible sur output_media_files[0].playback_url_vod
lorsque vous récupérez les informations sur le travail.
Analysez une liste de lecture en direct pour obtenir le code temporel
Lorsque vous créez une tâche Brightcove Live, une liste de lecture principale par défaut est renvoyée. Par exemple :
https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/playlist.m3u8
Nous aurons besoin de la liste de lecture principale VOD pour laquelle nous devrons ajouter "_vod" à la dernière partie de notre extension d'URL comme playlist_vod.m3u8
https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/playlist_vod.m3u8
La liste de lecture sera composée de plusieurs rendus/profils, que si vous "courbez" la liste de lecture, vous pourrez voir les rendus. Exemple :
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
La liste complète des playlists de rendus/profils sera ressemblent à ces URL "profile_0" et "profile_1" :
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
- Vous pouvez faire une commande "curl". Exemple :
- Si vous utilisez Safari navigateur, vous pouvez lire la liste de lecture principale ou l'une des listes de morceaux. Ensuite, ouvrez l'onglet du réseau de développeurs et recherchez « chunklist ». Sélectionnez l'un d'entre eux et regardez l'onglet Aperçu.
- Si vous n'avez pas Safari, vous pouvez appliquer le même processus dans un autre navigateur en utilisant le lecteur Akamai dans
http://players.akamai.com/hls/
. Chargez la liste de lecture dans Akamai Player, puis ouvrez l'onglet réseau de votre navigateur et recherchez la « chunklist ». - Si vous avez un mandataire, comme "Charles", c'est le même principe. Lisez l'une des listes de lecture VOD dans le lecteur Safari ou Akamai HLS, puis filtrez les résultats dans votre proxy pour consulter l'une des listes de morceaux renvoyées.
Maintenant, il y a quelques options pour regarder ces listes de lecture VOD pour vérifier le timecode :
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