정적 URL 전송

서문

브라이트코브는 비디오 클라우드 라이브러리의 에셋에 대한 비디오 매니페스트 파일에 정적 URL을 제공합니다. 이를 통해 CMS에서 콘텐츠를 관리하고 사용자 지정 보안 스키마를 사용하여 콘텐츠를 제공할 수 있습니다.

이는 매니페스트 URL이 필요하기 전에 Playback API 호출을 허용하지 않는 기존 아키텍처를 사용하는 고객에게 중요합니다. 플레이어는이 기능을 사용할 수도 있으므로 한 번의 통화를 제거하여 재생 시작 시간을 줄일 수 있습니다.

재생 API v2 레퍼런스도 참조하세요 .

요구 사항

정적 URL에는 다음 요구 사항이 필요합니다.

브라이트코브 재생 API v2
동적 전송을 위해 자산이 수집됩니다.

분석 등록

정적 URL을 사용하면 브라이트코브 플레이어를 사용하지 않고 재생 API와 통합됩니다. 브라이트코브 플레이어가 분석 데이터를 브라이트코브에 자동으로 전송하지만 데이터 수집 API를 사용하여 이를 수행합니다.

데이터 수집 API에 익숙하지 않은 경우개요를 검토하세요. 데이터 수집 API문서.

데이터 수집기로 정보를 보내는 방법에 대한 자세한 내용은데이터 수집 API 샘플을 참조하십시오 .

Video Cloud

오늘날 VideoCloud를 통한 모든 재생에는 비디오 재생을 시작하기 위해 2개의 API 호출이 필요합니다. 정적 URL을 사용하면 API 호출 수를 하나만 줄일 수 있습니다.

다음 다이어그램은 정적 URL 없이 비디오 재생을 위한 API 호출을 보여 줍니다.

정적 URL

브라이트코브의 재생 API v2를 사용하면 정적 URL을 사용할 수 있습니다.

특징

정적 URL과 관련된 기능은 다음과 같습니다.

기능	코멘트
권한	JSON 웹 토큰
분류: 바이오 CDN	브라이트코브의 CDN은 매니페스트와 하위 매니페스트를 계속 제공할 것입니다. 고객의 CDN은 비디오 세그먼트만 제공합니다.
자막	현재 매니페스트 내 캡션만 지원됩니다.
배달 규칙	VOD 전용
DRM	VOD 전용
라이브 스트림	Dynamic Delivery를 통해 지원되는 형식: HLS HLS 가상 맵
재생 권한 서비스 (EPA)	자세한 내용은 고객 성공 관리자에게 문의하십시오.
서버 측 광고 삽입 (SSAI)	VOD 앤 라이브
VOD (주문형 비디오)	Dynamic Delivery를 통해 지원되는 비디오 형식: HLS 대시 HLS 가상 맵 대시 VMAP MP4
VOD 자산	축소판 및 포스터 이미지

정적 URL 구현

정적 URL은 다음과 같습니다.

계정 ID
비디오 ID (또는 참조)
배송 유형 (HLS, 대시)
구성 옵션 (SSAI, DRM, CDN 등)

고정 URL은 고객이 생성하고 서명된JSON Web Token (JWT) 을 사용하여 보호됩니다. 이 토큰을 사용하면 전달의 측면을 구성하고 적용할 수 있습니다. 자세한 내용은만들기JSON Web Token부분.

도메인

정적 URL에 사용되는 도메인은 재생 API v2 (PapiV2) URL입니다.

https://edge.api.brightcove.com/playback/v1/

쿼리 매개 변수

쿼리 매개 변수
쿼리 매개 변수	값
`bcov_auth`	JWT 아래 참조

주문형 비디오(VOD) 엔드포인트

각 배달 유형에 대한 정적 URL 예:

HL 마스터 매니페스트

/accounts/{account_id}/videos/{video_id}/master.m3u8?bcov_auth={jwt}

대시보드 매니페스트

/accounts/{account_id}/videos/{video_id}/manifest.mpd?bcov_auth={jwt}

HLS VMAP ^[1]

/accounts/{account_id}/videos/{video_id}/hls.vmap?bcov_auth={jwt}

대시 VMAP ^[1]

/accounts/{account_id}/videos/{video_id}/dash.vmap?bcov_auth={jwt}

최고 비트 전송률 MP4 ^[2]

/accounts/{account_id}/videos/{video_id}/high.mp4?bcov_auth={jwt}

최저 비트 전송률 MP4 ^[2]

/accounts/{account_id}/videos/{video_id}/low.mp4?bcov_auth={jwt}

썸네일 이미지

/accounts/{account_id}/videos/{video_id}/thumbnail.jpg?bcov_auth={jwt}

포스터 이미지

/accounts/{account_id}/videos/{video_id}/poster.jpg?bcov_auth={jwt}

참고 사항

^[1] HLS 및 DASH VMAP는 다음을 포함하는 경우에만 검색할 수 있습니다. ssai당신이 때 주장 JWT 생성 .
^[2]를 사용할 때high.mp4그리고low.mp4비디오에 MP4 변환이 포함되어야 합니다. 그렇지 않으면 다음 오류가 발생합니다.
```
404 (NO RESOURCE)
```

라이브 엔드포인트

실시간 스트림의 정적 URL 예시:

HL 마스터 매니페스트

/accounts/{account_id}/videos/{video_id}/master.m3u8?bcov_auth={jwt}

HLS VMAP ^[1]

/accounts/{account_id}/videos/{video_id}/hls.vmap?bcov_auth={jwt}

참고 사항

^[1] HLS VMAP는 다음을 포함하는 경우에만 검색할 수 있습니다. ssai당신이 때 주장 JWT 생성 .

만들기JSON Web Token

Brightcove의 재생 API와 통신할 때 사용할 토큰을 생성하려면 다음을 참조하십시오. 만들기JSON Web Token (JWT)문서. 정적 URL 전송에 사용할 수 있는 클레임을 찾을 수 있습니다.

DRM (콘텐츠 보호) 사용

위에서 정의한 대로pro클레임을 포함하여 보호 유형을 지정할 수 있습니다.

라이센스 요청의 경우 JWT에는 페이로드가 필요하지 않지만 매니페스트 요청 JWT와 동일한 RSA 키를 사용하여 서명해야합니다.

와이드바인 라이선스 요청

다음 끝점을 사용하여 Widevine용 DRM 라이센스를 얻을 수 있습니다.

/accounts/{account_id}/videos/{video_id}/licenses/cenc/widevine?bcov_auth={JWT}

페어플레이 앱 인증서

FairPlay 앱 인증서의 경우 엔드포인트는 다음과 같습니다.

/accounts/{account_id}/fairplay_app_cert

플레이레디 엔드포인트

PlayReady의 경우 라이선스 요청의 끝점은 다음과 같습니다.

/accounts/{account_id}/videos/{video_id}/licenses/cenc/playready?bcov_auth={JWT}

참고

정적 URL 전송에는 다음 참고 사항이 적용됩니다.

매니페스트 내 캡션이 지원됩니다. 대역 외 사이드카 캡션은 향후 릴리스에서 지원될 예정입니다.
고객의 BYO CDN은 비디오 세그먼트를 제공할 것이며 브라이트코브의 CDN은 매니페스트 및 하위 매니페스트를 지속적으로 제공할 것입니다.
브라이트코브는 만료되지 않는 JWT 사용을 지원합니다. 이렇게 하려면 토큰을 생성할 때exp클레임을 제외해야 합니다.