라이브 API: ID3 시간 제한 메타데이터 삽입

이 항목에서는 Live API를 사용하여 ID3 시간 메타 데이터를 Live 스트림에 삽입하는 방법을 설명합니다.

개요

ID3 시간 메타 데이터는 특정 시점에서 라이브 스트림과 함께 데이터를 전송하는 데 사용됩니다. 진행 중인 작업에 대한 ID3 시간 제한 메타데이터를 삽입하려면 다음을POST 요청하십시오.

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

샘플 요청 본문

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

샘플 응답

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

입력에 SMPTE 타임 코드가 있습니까?

모든 인코더가 SMPTE 타임 코드를 보내는 것은 아닙니다. 입력에 해당 태그가 있는지 확인하려면 VOD 청크 리스트에서 다음과 같은 태그가 있는지 확인하는 것이#VOD-TIMING:timecode=15:18:36:01,wallclock=1549047672441,tsvideo=25400,tsaudio=-1좋습니다. vod 청크리스트 URL은 작업 정보를 검색할output_media_files[0].playback_url_vod때 사용할 수 있어야 합니다.

라이브 재생 목록을 분석하여 타임 코드 얻기

Brightcove Live 작업을 생성하면 기본 마스터 재생 목록이 반환됩니다. 예:

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

URL 확장자의 마지막 부분에 playlist_vod.m3u8로 “_vod”를 추가해야 하는 VOD 마스터 플레이리스트가 필요합니다.

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

재생 목록은 여러 개의 렌디션/프로필로 구성되며, 재생 목록을 “말리면” 해당 렌디션을 볼 수 있습니다. 예:


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

렌디션/프로필 재생 목록의 전체 목록은 다음과 같은 “profile_0" 및 “profile_1" URL과 같습니다.

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

    이제 시간 코드를 확인하기 위해 이러한 VOD 재생 목록을 볼 수있는 몇 가지 옵션이 있습니다.

  1. "curl"명령을 수행 할 수 있습니다. 예:
    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
  2. Safari를 사용하는 경우 브라우저에서 마스터 재생 목록 또는 청크 목록 중 하나를 재생할 수 있습니다. 그런 다음 개발자 네트워크 탭을 열고 "chunklist"를 검색합니다. 그중 하나를 선택하고 미리보기 탭을보십시오.
  3. Safari가 없는 경우, 의 Akamai 플레이어를 사용하여 다른 브라우저에서 동일한 프로세스를 적용할 수https://players.akamai.com/hls/있습니다. Akamai Player에서 재생 목록을로드 한 다음 브라우저 네트워크 탭을 열고 "chunklist"를 검색하십시오.
  4. "Charles"와 같은 프록시가있는 경우에도 동일한 원칙입니다. Safari 또는 Akamai HLS 플레이어에서 VOD 재생 목록 중 하나를 재생 한 다음 프록시에서 결과를 필터링하여 반환 된 청크 목록 중 하나를 확인합니다.