지원 고객 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    정적 URL 전송

    이 항목에서는 브라이트코브 재생 API v2에서 정적 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과 관련된 기능은 다음과 같습니다.

    기능 코멘트
    VOD에 대한 정적 URL 지원 동적 전송을 통해서만 지원되는 비디오 형식:
    • HLS
    • 대시
    • HLS 가상 맵
    • 대시 VMAP
    • MP4
    권한 JSON 웹 토큰
    DRM VOD 전용
    배송 규칙 VOD 전용
    서버 측 광고 삽입 (SSAI) VOD 앤 라이브
    바이오 CDN 브라이트코브의 CDN은 매니페스트와 하위 매니페스트를 계속 제공할 것입니다.

    고객의 CDN은 비디오 세그먼트만 제공합니다.
    자막 현재 매니페스트 내 캡션만 지원됩니다.

    정적 URL 구현

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

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

    이러한 URL은 고객 생성 및 서명JSON Web Token (JWT) 을 사용하여 보호됩니다. 이 토큰을 사용하면 전달의 측면을 구성하고 적용할 수 있습니다. 자세한 내용은만들기JSON Web Token섹션을 참조하시기 바랍니다.

    도메인

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

    https://playback.brightcovecdn.com/playback/v1/

    엔드포인트

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

    배달 유형 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 VM맵[1-1]
    /accounts/{account_id}/videos/{video_id}/hls.vmap?bcov_auth={jwt}
    대시 VM맵[1-1]
    /accounts/{account_id}/videos/{video_id}/dash.vmap?bcov_auth={jwt}
    최고 비트레이트 MP4
    /accounts/{account_id}/videos/{video_id}/high.mp4?bcov_auth={jwt}
    최저 비트레이트 MP4
    /accounts/{account_id}/videos/{video_id}/low.mp4?bcov_auth={jwt}

    참고

    • [ 1-1] HLS 및 DASH vMaps는 JWT를 만들 때ssai클레임을 포함하는 경우에만 검색할 수 있습니다. 다음 섹션을 참조하십시오.

    쿼리 매개 변수

    쿼리 매개 변수
    쿼리 매개 변수
    bcov_auth JWT는아래를 참조하십시오.

    만들기JSON Web Token

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

    DRM (콘텐츠 보호) 사용

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

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

    와이드바인 라이선스 요청

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

    /accounts/{account_id}/videos/{video_id}/licenses/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클레임을 포함하지 마십시오.