개요: 플레이어 관리 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 값은 파란색입니다.

속성의 데이터 유형이 배열 인 경우이 상속 동작을 변경할 수 있습니다. 자세한 내용은 임베드 API 가이드의배열 필드섹션에 설명되어 있습니다.

구성 옵션

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

속도 제한

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

응답 상태 코드

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

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