API en vivo: Insertar metadatos temporizados ID3

Este tema explica cómo insertar metadatos cronometrados ID3 en su transmisión en vivo usando la API en vivo.

Resumen

Los metadatos cronometrados ID3 se utilizan para enviar datos con una transmisión en vivo en un momento específico. Para insertar metadatos cronometrados ID3 para un trabajo en curso, haga un POST solicitud de:

https://api.bcovlive.io/v1/jobs/JOB_ID/id3tag

Cuerpo de solicitud de muestra

{
 "id3_tag": {
  "name": "cp1",
  "value": "Some information I want to send",
   "timecode": "15:50:49:16"
 }
}

Nota:

Solo id3_tag el objeto se puede enviar en una solicitud
Si usa el timecode propiedad, el trabajo solo almacena la solicitud de inserción más reciente
Si usa el timecode propiedad, el codificador debe enviar código de tiempo con formato SMPTE (HH: MM: SS: FF) almacenado en la propiedad tc a través de OnFI
Para entradas TS (RTP o SRT), el timecode se lee de los mensajes de temporización de imágenes SEI que forman parte del flujo de vídeo H.264. Esos mensajes tienen campos separados de horas, minutos, segundos y marcos. Por lo tanto, los valores no se analizan en la cadena con formato SMPTE.
Codificadores de software como Wirecast y OBS no hacer admite el envío de código de tiempo a través de paquetes OnFI en el flujo RTMP
Codificadores de hardware elementales hacer admite el envío de código de tiempo a través de paquetes OnFI en el flujo RTMP
Etiqueta de estados ID3v2 name puede tener hasta 4 caracteres.
value puede ser de hasta 256 KB.
Timecode es opcional: cuando se omite, la inserción será inmediata.

Respuesta de muestra

{
  "id": "JOB_ID",
  "id3_tag": {
    "tag_name": "BCOV",
    "tag_value": "my value"
  }
}

¿Existen códigos de tiempo SMPTE en la entrada?

No todos los codificadores envían códigos de tiempo SMPTE. Para comprobar si existen en su entrada, una forma de comprobarlo es buscar en la lista de bloques de VOD etiquetas como #VOD-TIMING:timecode=15:18:36:01,wallclock=1549047672441,tsvideo=25400,tsaudio=-1. La URL de la lista de bloques de vod debe estar disponible en output_media_files[0].playback_url_vod cuando recupera la información del trabajo.

Analice una lista de reproducción en vivo para obtener el código de tiempo

Cuando crea un trabajo de Brightcove Live, se devuelve una lista de reproducción maestra predeterminada. Por ejemplo:

https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/playlist.m3u8

Necesitaremos la lista de reproducción maestra de VOD para la cual necesitaremos agregar "_vod" en la última parte de nuestra extensión de URL como playlist_vod.m3u8

https://bcovlive-a.akamaihd.net/ade7a7b3aaea4a4d8107fb8bb262381e/eu-central-1/52725330351/playlist_vod.m3u8

La lista de reproducción estará compuesta por varias representaciones / perfiles, que si "riza" la lista de reproducción, podrá ver las representaciones. Ejemplo:


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 lista completa de reproducción / lista de reproducción de perfiles se parecen a estas URL "profile_0" y "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

Ahora hay algunas opciones para ver estas listas de reproducción de VOD y verificar el código de tiempo:

Podrías hacer un comando "curl". Ejemplo:


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 usa Safari navegador, puede reproducir la lista de reproducción maestra o una de las listas de fragmentos. Luego, abra la pestaña de la red de desarrolladores y busque "chunklist". Seleccione uno de ellos y mire la pestaña de vista previa.

Si no tiene Safari, puede aplicar el mismo proceso en otro navegador utilizando el reproductor Akamai en https://players.akamai.com/hls/. Cargue la lista de reproducción en Akamai Player, luego abra la pestaña de red de su navegador y busque "chunklist".
Si tiene un proxy, como "Charles", es el mismo principio. Reproduzca una de las listas de reproducción de VOD en el reproductor Safari o Akamai HLS y luego filtre los resultados en su proxy para ver una de las listas de partes devueltas.