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

    큐 포인트 추가

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

    서문

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

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

    • 광고 큐 포인트 : 광고를 요청해야하는 위치를 표시하는 데 사용됩니다 (동영상 및 플레이어가 광고를 위해 활성화 된 경우).
    • 코드 큐 포인트 : 플레이어 API를 사용하여 작업을 수행하는 데 사용됩니다. 일반적인 용도로는 일종의 클릭 유도 문안 (CTA)을 표시하거나 동영상 콘텐츠와 관련된 이미지 또는 텍스트를 표시하는 것입니다. 플레이어 주변의 페이지.

    구축 개요

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

    HTTP 메소드

    큐 포인트는 다음 중 하나를 추가 할 수 있습니다. 비디오 만들기또는 나중에업데이트 요청 . 이 샘플에서는 기존 비디오에비디오 업데이트즉, PATCH방법.

    끝점

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

              https://cms.api.brightcove.com/v1/accounts/account_id / videos /  video_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뿐만 아니라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"
              ]

    샘플 앱

    GitHub 저장소에서이샘플과 관련된 모든 코드를 찾으십시오.

    펜보기 CMS API 샘플 : 큐 포인트 추가게시자 : Brightcove Learning Services ( 뿡 빵뀨 ) 의 위에 CodePen .

    코드펜 사용

    • 결과버튼을 클릭하여 앱의 실제 표시를 토글합니다.
    • HTML/CSS/JS버튼을 클릭하여 코드 유형 중 하나를 표시합니다.
    • 오른쪽 상단모서리에있는 CodePen에서 편집을클릭하여이 CodePen을 자신의 계정으로 포크하십시오.
    • GitHub 저장소에서이샘플과 관련된 모든 코드를 찾으십시오.

    프록시 코드

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