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

    개요: 플레이어 관리 API

    플레이어 관리는 퍼블리셔에 대한 리소스로 플레이어의 생성, 편집 및 관리를 말합니다. 플레이어 관리는 소비자가 플레이어 인스턴스를 생성, 구성, 미리 보기 및 게시할 수 있는 서버 측 REST API에 의해 이루어집니다.
     

    서문

    플레이어 생성 및 업데이트는 2 단계 접근 방식으로 수행됩니다. 모든 변경 사항이 프로덕션 플레이어에 자동으로 적용되지 않고 변경 사항이 미리보기로 분리되어 게시됩니다. 이제 최종 사용자에게 표시되는 내용에 영향을주지 않고 미리보기 플레이어에 원하는 모든 업데이트를 수행 할 수 있습니다. 원할 때마다 변경 사항을 게시하도록 선택할 수 있습니다.

    플레이어 관리 API를 통해 사용자는 다음을 수행 할 수 있습니다.

    1. 플레이어 생성
    2. 플레이어의 설정 보기
    3. 플레이어의 설정 변경
    4. 게시자와 관련된 모든 플레이어 나열
    5. 소비자가 사용할 수 있도록 플레이어를 게시

    또한 참조 API 참조 .

    기본 URL

    API의 기본 URL은 다음과 같습니다.

        https://players.api.brightcove.com/v2

    서문

    플레이어 관리 시스템은 세 가지 주요 개체로 구성됩니다. 기본 템플릿, 플레이어 및 하위 플레이어입니다.

    Brightcove 기본 템플릿 -템플릿은 사용자에게 제공되는 시청 경험을 생성하기위한 기초로 사용되는 파일 및 설정의 집합이며 생성 된 모든 플레이어의 기초가됩니다. 이러한 파일은 결국 사용자 정의 된 플레이어 설정으로 컴파일되어 브라우저 (플레이어)에로드되는 실제 코드가됩니다. 현재 시스템 전체에서 사용되는 단일 템플릿 만 있습니다. 따라서 API를 통해 템플릿을 볼 수 없습니다.

    플레이어 -플레이어는 템플릿에 적용 할 일반 정보 및 사용자 지정을 캡처하는 고객 별 설정입니다. 이러한 설정은 API 및 플레이어 개체 결과로 전송됩니다. 사용자 정의에는 설정, 스타일 및 플러그인이 포함될 수 있습니다. 사용자 정의 가능성의 전체 목록은플레이어 구성 가이드 .

    어린이 플레이어 -Embed API를 사용하여 생성 된 하위 플레이어는 플레이어의 여러 인스턴스를 생성 한 결과입니다. 플레이어는 플레이어에게 원하는 속성의 대부분을 가지고 있으며 하위 플레이어를 사용하여 다른 플레이어 인스턴스의 속성 하위 집합을 사용자 지정할 수 있습니다. 자식 플레이어는 지정된 플레이어에 추가 할 미디어 만 정의하거나 자신이 속한 일반 플레이어를 변경하는 설정 또는 스타일 재정의를 정의 할 수 있습니다. 부모 플레이어 설정에 대한 변경 사항은 부모 플레이어에서 스폰 된 모든 자식 플레이어에 적용됩니다. 확인 Embed API 가이드자세한 내용은.

    이 다이어그램은 기본 템플릿, 플레이어 및 하위 플레이어 간의 관계를 보여줍니다.

    플레이어 개체 계층
    플레이어 개체 계층

    플레이어 관리 API를 처음 사용하면 계정에 Brightcove 기본 플레이어가 생성됩니다. 그 플레이어 오브젝트는 당신이 선택한대로 할 수있는 것입니다. 그대로 사용하거나 설정을 변경하거나 스타일을 변경하거나 플러그인을 추가 할 수 있습니다. 사용자 지정에 Brightcove 기본 플레이어 만 사용하도록 선택하거나 웹 사이트의 다른 위치에 대해 다른 모양과 설정을 캡처하기 위해 다른 플레이어를 만들도록 선택할 수 있습니다.

    게시 개요

    플레이어 관리 시스템의 기능 중 하나는 공개적으로 게시 된 플레이어 버전에서 테스트하려는 변경 사항을 분리하는 기능입니다. UI와 API 모두에서 플레이어의 구성을 변경하면 플레이어의 미리보기 버전을 통해 변경 사항을 즉시 사용할 수 있습니다. 이러한 미리보기 버전은 완전히 사용 가능하고 테스트 할 수 있습니다. 승인을 위해 미리보기 URL을 공유하거나 변경 사항에 만족할 때까지 플레이어 미리보기에서 작업 할 수 있습니다.이 모든 작업은 플레이어를 공개하기 위해 게시하기 전에 가능합니다.

    폭포 업데이트

    플레이어를 게시하면 어린이 플레이어에게 영향을 미칠 수있는 결과가 있습니다. 게시에 대한 세부 정보는 다음과 같습니다.

    • 플레이어 게시는 해당 플레이어에서 생성 된 모든 하위 플레이어 인스턴스의 다시 게시를 트리거합니다.
    • 하위 플레이어 게시는 해당 하위 플레이어에만 영향을줍니다.
    • Brightcove 기본 템플릿 업데이트 (Brightcove 제어)는 모든 플레이어의 재 게시를 트리거하고 플레이어 재 게시는 차례로 각 플레이어에서 생성 된 모든 하위 플레이어의 재 게시를 트리거합니다.

    설정은 자녀의 승리 방식으로 적용됩니다. 즉, 하위 수준의 설정이 상위 수준의 변경 사항보다 우선합니다. 다음을 고려하세요:

    • 기본 템플릿은 CSS 값을 빨간색으로 정의합니다.
    • 플레이어는 동일한 CSS 값을 흰색으로 정의합니다.
    • 어린이 플레이어는 동일한 CSS 값을 파란색으로 정의합니다.

    아이가 이기면 결과는 다음과 같습니다.

    • 플레이어의 CSS 값은 흰색입니다.
    • 어린이 플레이어의 CSS 값은 파란색입니다.

    속성의 데이터 유형이 배열 인 경우이 상속 동작을 변경할 수 있습니다. 그만큼배열 필드 Embed API 가이드 섹션에서 자세한 내용을 설명합니다.

    구성 옵션

    기본 플레이어보다 더 발전된 플레이어를 만들려면플레이어 구성 . 구성은 JSON을 사용하여 정의됩니다.

    속도 제한

    플레이어 관리 API에는 활성화 된 각 고유 IP 당 속도 제한이 있습니다. 다음은 속도 제한입니다.

    요청 유형 제한
    게시 및 만들기 (플레이어 및 삽입) 요청 60 개 / 분
    읽기 (GET) 요청 600 개 / 분
    쓰기 (POST, PUT, PATCH 및 DELETE) 분당 요청 300 개
    플레이어 미리보기 분당 요청 100 개

    응답 상태 코드

    응답 및 오류 코드 / 메시지는 W3에서 정의 . 가장 흔히 볼 수있는 코드는 다음과 같습니다.

    • 200성공 요청
    • 201생성됨 (플레이어, 구성)
    • 400잘못된 요청-API 호출 구문이 올바르지 않을 수 있습니다.
    • 401유효하지 않은 인증-암호가 올바르게 입력되었는지 또는 OAuth 안내바르게
    • 404찾을 수 없음-리소스가 있고 API 호출에 사용 된 URL이 올바른지 확인합니다.
    • 429비율 한도 초과
    • 500내부 서버 오류-요청을 이행하는 중에 오류가 발생했습니다.