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

    큐 포인트 추가

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

    소개

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

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

    • 광고 큐 포인트 : 광고 요청을해야하는 장소를 표시하는 데 사용됩니다 (동영상 및 player 광고 가능).
    • 코드 큐 포인트 : 다음을 사용하여 조치를 취하는 데 사용됩니다. Player API -일부 일반적인 용도는 일종의 클릭 유도 문안 (CTA)을 표시하거나 비디오 콘텐츠와 관련된 이미지 또는 텍스트를 표시하는 것입니다. player.

    구현 개요

    에서 큐 포인트를 추가 할 수 있습니다. 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 아니 임의의 이름-사용자의 특정 큐 포인트를 식별하는 데 유용 할 수 있습니다 Player API 암호
    type 반드시 있어야합니다. AD or CODE
    time 번호 비디오 처음부터의 큐 포인트 시간 (초) [1]
    metadata 아니 최대 128 싱글 바이트 문자까지의 모든 문자열 - 오버레이 텍스트 또는 표시 할 이미지의 위치와 같은 큐 포인트 이벤트 핸들러에 유용한 정보 일 수 있습니다
    force_stop 부울 아니 큐 포인트에 도달했을 때 비디오를 일시 정지할지 여부 ( force_stop 에 의해 무시됩니다. Brightcove Player 현재이를 지원할 계획은 없지만 큐 포인트 이벤트 핸들러에서 수동으로 비디오를 일시 중지 할 수 있습니다.

    노트

    • [1] 기술적으로 큐 포인트는 다음 큐 포인트에 도달 할 때까지 활성화됩니다. 따라서 큐 포인트 배열에서 Brightcove Player, 당신은 startTimeendTime 뿐만 아니라 time 큐 포인트 용.

    인증 자격 증명 얻기

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

    대부분의 경우 자격증 명을 얻는 가장 쉬운 방법은 Studio Admin API 인증 섹션을 이용하는 것입니다 (계정에 대한 관리자 권한이 필요함). 만나다 API 인증 자격 증명 관리 자세한 내용은 대부분의 경우, 모든 사용자에게 권한을 부여하기를 원할 것입니다. CMS API 작업 :

    CMS API 권한
    CMS API 권한

    필요한 사용 권한을 Studio에서 사용할 수 없거나 사용자가 직접 사용하도록 설정하려는 경우 OAuth API, 당신이 선택한 것을 사용하십시오. 클라이언트 자격증 명 얻기 아래에 나열된 문서. 어느 옵션을 선택하든 올바른 작업 권한을 요청해야합니다. cURL 또는 Postman과 함께 다음을 사용할 수 있습니다. CMS API:

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

    샘플 앱

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

    펜보기 CMS API 샘플 : 큐 포인트 추가 Brightcove 학습 서비스 제공 ( @rcrooks1969)에 코드 펜.

    CodePen 사용

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

    프록시 코드

    이 페이지에서 샘플 앱을 직접 빌드하려면 자신의 프록시를 생성하고 호스팅해야합니다. (Brightcove Learning Services에서 사용하는 프록시는 Brightcove 도메인의 요청 만 수락합니다.) 샘플 프록시는 우리가 사용하는 프록시와 매우 유사하지만 Brightcove가 아닌 도메인의 요청을 차단하는 검사가없는 곳에서 찾을 수 있습니다. 이 GitHub 저장소. 당신은 또한 거기에 그것을 사용하기위한 기본 지침과 프록시 주위에 애플 리케이션을 구축하기위한보다 정교한 안내서를 찾을 것입니다. REST API 사용.


    24 년 2020 월 XNUMX 일에 마지막으로 업데이트 된 페이지