Esta página se ha movido; se le dirigirá a la nueva ubicacion en 3 segundos. ¡Actualiza tus marcadores!

API en vivo: Insertar metadatos cronometrados ID3

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

Descripción general

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

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:

  1. Podrías hacer un comando "curl". Ejemplo:
  2. 
    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
  3. 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.
  4. Si no tiene Safari, puede aplicar el mismo proceso en otro navegador utilizando el reproductor Akamai en http://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".
  5. 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.