API en vivo: Insertar metadatos cronometrados ID3
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
- Podrías hacer un comando "curl". Ejemplo:
- 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
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". - 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.
Ahora hay algunas opciones para ver estas listas de reproducción de VOD y verificar el código de tiempo:
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