큐 포인트 추가

이 샘플에서는 CMS API를 사용하여 프로그래밍 방식으로 비디오에 큐 포인트를 추가하는 방법을 알아 봅니다.

서문

큐 포인트는 비디오 타임 라인의 지정된 위치입니다. 비디오가 재생되면 큐 포인트에 도달 할 때마다 이벤트가 자동으로 브로드 캐스트됩니다. Player API를 사용하면 이러한 이벤트를 수신하고 원하는 작업을 수행 할 수 있습니다. 또한 플레이어에 저장된 비디오 메타데이터에서 모든 큐 포인트 정보를 읽을 수 있습니다. mediainfo할 수 있는 객체비디오 타임라인에 큐 포인트 표시당신이 원한다면 어떤 식으로든.

큐 포인트에는 두 가지 종류가 있습니다.

  • 광고 큐 포인트: 광고 요청을 해야 하는 위치를 표시하는 데 사용됩니다 (동영상 및 플레이어가 광고가 활성화된 경우).
  • 코드 큐 포인트: 코드 큐 포인트는 플레이어 API를 사용하여 일부 작업을 수행하는 데 사용됩니다. 일반적인 용도로는 일종의 CTA (Call-to-Action) 를 표시하거나 비디오 콘텐츠와 관련된 이미지나 텍스트를 비디오 오버레이로 표시하거나 플레이어 주변 페이지에 표시하는 경우가 있습니다.

샘플 앱

GitHub 리포지토리에서 이 샘플과 관련된 모든 코드를 찾아보세요 .

CMS API 샘플을 참조하십시오. 큐 포인트 추가 Brightcove 학습 서비스( @rcrooks1969 ) 에코드펜 .

구축 개요

Studio Media 모듈에서 큐 포인트를 추가할 수있습니다. 이 샘플에서 사용할 방법 인 CMS API를 사용하여 추가 할 수도 있습니다.

HTTP 메소드

큐 포인트는 비디오를만들 때추가하거나 나중에업데이트 요청을 통해 추가할 수있습니다. 이 샘플에서는 동영상을 만들어 기존 동영상에 추가합니다. 비디오 업데이트요청하면 다음을 사용하게 됩니다. PATCH방법.

끝점

비디오 업데이트 요청의 끝점은 다음과 같습니다.

          https://cms.api.brightcove.com/v1/accounts/account_id /동영상/ 동영상_ID

요청 본문

요청 본문은 비디오 메타 데이터의 많은 항목을 포함 할 수있는 JSON 개체입니다. 여기서는 다음 샘플과 같이 큐 포인트 객체 배열로 설정된cue_points필드를 살펴보겠습니다.

          {
          "cue_points": [
              {
                "name": "Ad Cue Point",
                "type": "AD",
                "time": 2.0,
                "metadata": null,
                "force_stop": false
              },
              {
                "name": "Code Cue Point",
                "type": "CODE",
                "time": 4.0,
                "metadata": "The metadata might be text or the url for an image to display",
                "force_stop": true
              }
            ]
          }

큐 포인트 개체 필드

다음은 큐 포인트 개체의 필드에 대한 설명입니다.

큐 포인트 개체 필드
필드 유형 필수 설명
name 아니요 임의의 이름-플레이어 API 코드에서 특정 큐 포인트를 식별하는 데 유용 할 수 있습니다.
type 반드시AD또는CODE
time 번호 비디오 시작 시점부터 큐 포인트까지 걸리는 시간 (초) [1]
metadata 아니요 최대 128 개의 싱글 바이트 문자-오버레이의 텍스트 또는 표시 할 이미지의 위치와 같은 큐 포인트 이벤트 핸들러에 유용한 정보 일 수 있습니다.
force_stop 부울 아니요 큐 포인트에 도달했을 때 비디오를 일시 중지해야 하는지 여부 ( force_stop Brightcove Player에서는 무시되며 현재 지원할 계획이 없지만 큐 포인트 이벤트 핸들러에서 비디오를 수동으로 일시 중지할 수 있음)

참고

  • [1] 엄밀히 따지자면 큐 포인트는 다음 큐 포인트에 도달할 때까지 활성화됩니다. 따라서 Brightcove Player에서 검색할 수 있는 큐 포인트 배열에는startTimeendTime a와 a도 표시됩니다. time큐 포인트를 위해서요.

인증 자격 증명 얻기

CMS API사용하려면 적절한 자격 증명이 필요합니다.

대부분의 경우 자격 증명을 얻는 가장 쉬운 방법은 Studio 관리 API 인증 섹션 (계정에 대한 관리자 권한 필요) 을 사용하는 것입니다. 보다 API 인증 자격 증명 관리자세한 내용은 대부분의 경우 모든CMS API작업에 대한 권한만 얻고 싶을 것입니다.

CMS API 사용 권한
CMS API 사용 권한

Studio에서 필요한 권한을 사용할 수 없거나 OAuth API에서 직접 권한을 가져오려면 아래 나열된 클라이언트 자격 증명가져오기문서 중 원하는 것을 선택하십시오. 어떤 옵션을 선택하든 올바른 작업 권한을 요청해야합니다. 다음은 cURL 또는 우편 배달부와 함께 CMS API에 대한 모든 권한을 얻는 데 사용할 수 있습니다.

          "operations": [
            "video-cloud/video/all",
            "video-cloud/playlist/all",
            "video-cloud/sharing-relationships/all",
            "video-cloud/notifications/all"
          ]

코드펜 사용

프록시 코드

이 페이지에서 자신의 버전을 샘플 응용 프로그램을 빌드하려면 자신의 프록시를 만들고 호스팅해야합니다. (브라이트코브 학습 서비스에서 사용하는 프록시는 브라이트코브 도메인의 요청만 허용합니다.) 우리가 사용하는 것과 매우 유사하지만 BrightCove가 아닌 도메인의 요청을 차단하는 검사가 없는 샘플 프록시는이 GitHub 리포지토리에서 찾을 수있습니다. 또한 REST API 사용에서프록시를 사용하기 위한 기본 지침과 프록시를 중심으로 앱을 빌드하기 위한 보다 자세한 안내서를 찾을 수있습니다.