API en direct : Insérer des métadonnées programmées ID3

Cette rubrique explique comment insérer des métadonnées chronométrées ID3 dans votre flux Live à l'aide de l'API Live.

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 chronométrées ID3 pour une tâche en cours, envoyez une 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"
 }
}

Remarque :

Seul id3_tag objet peut être soumis dans une demande
Si vous utilisez le timecode propriété, le travail ne stocke que la demande d'insertion la plus récente
Si vous utilisez la timecode propriété, l'encodeur doit envoyer le code temporel au format SMPTE (HH:MM:SS:FF) stocké dans la propriété tc via OnFi
Pour les entrées TS (RTP ou SRT), les timecode messages de synchronisation d'image SEI qui font partie du flux vidéo H.264 sont lus. Ces messages comportent des champs distincts pour les heures, les minutes, les secondes et les trames. Par conséquent, les valeurs ne sont pas analysées dans la chaîne formatée SMPTE.
Encodeurs logiciels tels que Wirecast et OBS ne pas prend en charge l'envoi de timecode via des paquets OnFI dans le flux RTMP
Encodeurs matériels élémentaires faire prend en charge l'envoi de timecode via des paquets OnFI dans le flux RTMP
Balise d'état ID3v2 name peut contenir jusqu'à 4 caractères.
value peut aller jusqu'à 256 Ko.
Timecode est facultatif : en cas d'omission, l'insertion sera immédiate.

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

Il existe maintenant quelques options pour consulter ces listes de lecture VOD et vérifier le timecode :

Vous pouvez faire une commande "curl". Exemple :


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

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