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

    CMS와 Video Cloud

    이 주제에서는 Brightcove 통합과 관련된 기본 조작을 학습합니다. Video Cloud CMS로. CMS 내에서 사용자가 수행하는 일반적인 기능과 해당 기능을 제공하는 데 사용할 수있는 Brightcove API 작업이 나열됩니다.

    사용자 기능

    아래의 기능은 다음과 같습니다. Video Cloud CMS 사용자에게 다음을 제공 할 수 있습니다.

    • 에 새 동영상을 추가하십시오. Video Cloud
    • 대체 Video Cloud 새 버전의 비디오
    • 제목, 설명 및 태그와 같은 동영상 메타 데이터 업데이트
    • 동영상 삭제
    • 재생 목록 만들기
    • 재생 목록의 동영상 변경
    • 재생 목록 삭제
    • 비디오 플레이어 만들기
    • 크기 또는 스타일과 같은 비디오 플레이어 속성 수정
    • 플러그인을 통해 비디오 플레이어에 특별한 기능을 추가하십시오.
    • 단일 비디오 또는 재생 목록 게시
    • 동영상로드, 조회수, 재생 요금, 참여 등에 대한 분석 데이터를 제공합니다.

    이 기능을 모두 최종 사용자에게 공개하고 싶지는 않을 것입니다. 예를 들어 비디오를 삭제할 수는 없습니다. 통합의 장점 중 하나 Video Cloud 사용자가 직접 이동하지 않고 CMS로 Video Cloud Studio는 Brightcove API를 통해 사용자에게 노출 할 기능을 정확하게 선택할 수 있다는 것입니다.

    인증

    모든 Brightcove API 요청의 경우 인증은 OAuth2 액세스 토큰을 기반으로합니다. 액세스 토큰을 얻는 두 단계 프로세스가 있습니다.

    1. 필요한 API 작업에 대한 권한으로 클라이언트 자격 증명을 만듭니다.
    2. 클라이언트 자격 증명을 사용하여 API 요청을 인증하는 임시 액세스 토큰 생성

    클라이언트 신임 작성

    클라이언트 자격 증명을 생성하는 것은 일회성 작업으로 Video Cloud 스튜디오 렌탈 또는 OAuth API . 그러나 당신은 그것을한다. client_idclient_secret 액세스 토큰을 요청하려면 저장해야합니다.

    액세스 토큰 만들기

    임시 액세스 토큰은 OAuth API . 그만큼 client_idclient_secret BASE64로 인코딩되어 있어야하며 Basic 권한 부여 문자열.

    그리고, access_token API 호출이있는 Authorization 헤더에서 반환 된 반환 됨 :

        >Authorization: Bearer your_access_token
        
        

    액세스 토큰은 5 분 동안 유효합니다. 수백 가지 연속 API 호출을 수행하는 일종의 일괄 처리를 수행하지 않는 한, 시간 초과를 추적하기보다는 각 API 호출에 대해 새로운 API 호출을 요청하는 것이 좋습니다.

    비디오 추가하기

    사용자가 동영상을 Video Cloud 귀하의 CMS에서, 당신은 그것을 사용하여 할 수있는 Dynamic Ingest API . 사용자가 리포지토리에 비디오를 업로드하도록 권장합니다.이 비디오는 S3 버킷이거나 공용 서버 일 수 있습니다. Dynamic Ingest 시스템은 동영상을 가져 와서 Video Cloud 시스템에서 아래에 설명 된 두 단계 프로세스를 거쳐야합니다.

    비디오 객체를에 추가 Video Cloud

    첫 번째 단계는 동영상 개체를 Video Cloud 시스템을 만들어 POST 요청 CMS API:

        https://cms.api.brightcove.com/v1/accounts/:account_id/videos
        
        

    요청 본문에는 기본 동영상 속성이 포함됩니다. JSON 객체 - 최소한으로, 비디오 name하지만 메타 데이터와 같은 추가 메타 데이터를 포함 할 수도 있습니다. descriptiontags:

        {
        "name": "Woodpecker",
        "description": "A bird that hunts insects inside wood",
        "reference_id": "Bird_Woodpecker.mp4",
        "tags": ["bird", "air", "nature"]
        }
        
        

    동영상 가져 오기

    비디오 객체를 만들 때 CMS API ~을 돌려 준다. JSON 비디오 속성을 포함하는 객체. 비디오를 추출합니다. id 인사말 JSON, 전화를 걸어서 Dynamic Ingest API 동영상의 수집 및 코드 변환을 요청하는 방법은 다음과 같습니다.

        https://ingest.api.brightcove.com/v1/accounts/ACCOUNT_ID/videos/VIDEO_ID/ingest-requests
        
        

    다시 보내드립니다. JSON 비디오 파일의 위치를 ​​지정하는 요청 본문에서 :

        {
          "master":{
            "url":"http://learning-services-media.brightcove.com/videos/mp4/Bird_Woodpecker.mp4"
          },
          "profile":"multi-platform-extended-static",
          "capture-images": true
        }
        
        

    그리고, profile 트랜스 코딩 프로세스에서 어떤 변환을 만들어야하는지 지정하는 Ingest Profile이 있습니다. 대부분의 경우 다음 표준 프로필 중 하나가 적합해야합니다.

    동적 게재 프로필

    • multi-platform-extended-static
    • multi-platform-standard-static

    기존 수집 프로필

    • videocloud-default-v1 (the default)
    • screencast-1280
    • smart-player-transition
    • single-bitrate-high
    • audio-only
    • single-bitrate-standard
    • high-resolution

    그러나 필요한 경우 추가 맞춤 유입 프로필을 만들 수 있습니다. Ingest Profiles API 또는 Video Cloud 스튜디오 렌탈.

    포스터 및 축소판 이미지 추가

    그리고, capture-images 옵션은 위 코드에서 지시합니다. Video Cloud 트랜스 코딩 프로세스 중 중간 지점에서 비디오의 포스터 및 축소판 이미지를 캡처합니다. 또는, capture-imagesfalse 대신 이미지를 섭취하는 것과 동시에 이미지를 섭취하십시오.

        {
        "master":{
        "url":"http://learning-services-media.brightcove.com/videos/mp4/Bird_Woodpecker.mp4"
        },
        "profile":"multi-platform-extended-static",
        "capture-images": false,
        "poster": {
        "url": "http://learning-services-media.brightcove.com/images/for_video/titmouse-poster.png",
        "width": 640,
        "height": 360
        },
        "thumbnail": {
        "url": "http://learning-services-media.brightcove.com/images/for_video/titmouse-thumbnail.png",
        "width": 160,
        "height": 90
        }
        }
        
        

    만나다 이미지와 Dynamic Ingest API 자세한 내용은.

    캡션 또는 챕터의 텍스트 트랙 추가

    당신은 또한 사용할 수 있습니다 Dynamic Ingest API 텍스트 트랙을 추가하려면 WebVTT 파일을 섭취하거나 나중에 볼 때 동영상에 저장하십시오. 텍스트 트랙은 자막 or 동영상.

        {
        "master":{
        "url":"http://learning-services-media.brightcove.com/videos/mp4/Bird_Woodpecker.mp4"
        },
        "profile":"multi-platform-extended-static",
        "capture-images": false,
        "poster": {
        "url": "http://learning-services-media.brightcove.com/images/for_video/titmouse-poster.png",
        "width": 640,
        "height": 360
        },
        "thumbnail": {
        "url": "http://learning-services-media.brightcove.com/images/for_video/titmouse-thumbnail.png",
        "width": 160,
        "height": 90
        },
        "text_tracks": [
        {
        "url": "http://learning-services-media.brightcove.com/captions/for_video/Water-in-Motion.vtt",
        "srclang": "en",
        "kind": "captions",
        "label": "English",
        "default": true
        }
        ]
        }
        
        

    만나다 WebVTT 파일 가져 오기 자세한 내용은.

    비디오 관리

    그리고, CMS API 계정의 비디오 데이터를 가져올 수 있습니다. (위 그림과 같이 비디오 처리 프로세스의 일부로 비디오 객체를 만드는데도 사용됩니다.) 가장 기본적인 요청은 다음과 같습니다.

        https://cms.api.brightcove.com/v1/accounts/account_id/videos
        
        

    기본적으로이 요청은 JSON 설명, 태그, 사용자 정의 필드, 제작 날짜 및 마지막 수정 날짜, 포스터 및 미리보기 이미지의 URL 등을 포함하여 풍부한 메타 데이터가 포함 된 20 비디오 객체 배열입니다.

    다음 매개 변수 중 하나 이상을 요청에 추가하여 요청 결과를 구체화 할 수 있습니다.

    limit
    반환 할 비디오 객체의 수를 결정하며 임의의 수만큼 설정할 수 있습니다. 100 - 기본값은 20입니다.
    offset
    이것은 건너 뛸 항목의 수를 결정하므로 함께 사용됩니다. limit 동영상 카탈로그를 통해 페이지 이동 - 기본값은 0입니다.
    sort
    이 옵션은 비디오 메타 데이터 필드를 결정하여 결과를 정렬합니다. 기본적으로 결과는 updated_at (내림차순, 가장 최근에 업데이트 된 비디오를 먼저 표시)

    만나다 CMS API 개요 - 매개 변수 이러한 매개 변수에 대한 자세한 내용은

    동영상 검색하기

    또한 다음을 사용하여 광범위한 기준으로 동영상을 검색 할 수 있습니다. q 매개 변수. 이름, 설명 및 태그, 날짜 및 동영상 상태와 같은 특정 필드로 검색 할 수 있습니다.

        https://cms.api.brightcove.com/v1/accounts/account_id/videos?q=tags:sea,mammal
        
        

    검색에 대한 자세한 내용과 옵션은 동영상을 검색.

    특정 비디오 가져 오기 및 업데이트

    ID 또는 참조 ID로 특정 동영상을 검색하려면 다음 단계를 따르세요.

        https://cms.api.brightcove.com/v1/accounts/account_id/videos/id
        or
        https://cms.api.brightcove.com/v1/accounts/account_id/videos/ref:reference_id
        
        

    A 바로 요청은 비디오 객체를 반환합니다. 업데이트하려면 JSON 그것을 사용하여 반점 동일한 URL에 요청하십시오.

    재생 목록

    재생 목록 정보는 또한 CMS API 비디오 정보와 거의 같은 방식으로 유의 사항 Video Cloud 두 가지 카테고리의 8 가지 재생 목록 유형을 지원합니다.

    수동 (또는 EXPLICIT) 재생 목록
    지정된 동영상 세트 포함 - 최대 100 개의 동영상이 포함될 수 있음
    스마트 재생 목록
    검색 기준에 따라 런타임에 동적으로 빌드됩니다. 목록 내에 비디오가 정렬되는 방식에 따라 7 가지 종류의 스마트 재생 목록이 있습니다.
    • ACTIVATEDOLDESTTONEWEST
    • ACTIVATEDNEWESTTOOLDEST
    • ALPHABETICAL
    • PLAYSTOTAL
    • PLAYSTRAILINGWEEK
    • STARTDATEOLDESTTONEWEST
    • STARTDATENEWESTTO_OLDEST

    동영상 수에 대한 제한은 최대 100까지 설정할 수 있습니다.

    동영상과 마찬가지로 모든 재생 목록을 검색 할 수 있습니다. limitoffset 계정에 많은 재생 목록이있는 경우 검색 결과를 페이징하는 방법 :

        https://cms.api.brightcove.com/v1/accounts/account_id/playlists
        
        

    반환되는 재생 목록 개체 배열에는 재생 목록에 대한 메타 데이터가 포함됩니다. type 위에 설명한 유형 중 하나에 해당합니다. 유형이 EXPLICIT, 또한 video_ids 포함 된 동영상의 ID가 포함 된 배열입니다. 유형이 스마트 재생 목록 유형 중 하나 인 경우 search 동영상을 검색하는 검색 문자열이 포함 된 속성 (예 :

        q=tags:fish,birds
        
        

    또한 하나의 재생 목록을 id:

        https://cms.api.brightcove.com/v1/accounts/account_id/playlists/playlist_id
        
        

    재생 목록에 대한 전체 비디오 객체를 가져와야하는 경우 (페이지의 비디오에 대한 정보를 표시하기 위해) /videos 해당 URL :

        https://cms.api.brightcove.com/v1/accounts/account_id/playlists/playlist_id/videos
        
        

    스마트 재생 목록의 경우 요청은 현재 검색 기준과 일치하지만 변경 될 수있는 동영상을 반환합니다.

    플레이어 생성

    Brightcove player를 통해 만들 수 있습니다 Player Management API . 이 API를 사용하면 플레이어를 만들고, 속성을 업데이트하고, 포함 된 코드를 URL, iframe 태그 또는 HTML 블록을 페이지에 삽입 할 수 있습니다.

    계정 당 200 플레이어까지 할 수 있지만, 사용자가 절대적으로 필요로하는 선수를 거의 갖지 않는 것이 일반적으로 덜 혼란 스럽습니다. 단일 비디오 또는 재생 목록을 재생하기 위해 별도의 플레이어가 있어야하지만 그렇지 않으면 스타일이 달라 지거나 플러그인을 통해 다른 기능이 추가 될 때 다른 플레이어 만 필요합니다.

    플레이어를 만들려면 POST 요청 Player Management API:

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

    요청 본문에 플레이어 구성 - 필요한 유일한 것은 name:

        {
        "name": "Single video player for blog posts"
        }
        
        

    이 응답은 플레이어 ID와 다양한 형식의 소스 코드를 제공합니다.

        {
        "embed_code": "<iframe src='//players.brightcove.net/57838016001/de055fa4-4f09-45af-8531-419c6794ad04_default/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>",
        "embed_in_page": "http://players.brightcove.net/57838016001/de055fa4-4f09-45af-8531-419c6794ad04_default/in_page.embed",
        "id": "de055fa4-4f09-45af-8531-419c6794ad04",
        "preview_embed_code": "<iframe src='//preview-players.brightcove.net/v1/accounts/57838016001/players/de055fa4-4f09-45af-8531-419c6794ad04/preview/embeds/default/master/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>",
        "preview_url": "http://preview-players.brightcove.net/v1/accounts/57838016001/players/de055fa4-4f09-45af-8531-419c6794ad04/preview/embeds/default/master/index.html",
        "url": "http://players.brightcove.net/57838016001/de055fa4-4f09-45af-8531-419c6794ad04_default/index.html"
        }
        
        

    전체 플레이어 구성을 얻으려면 /players 끝점에 위의 응답에서 반환 된 플레이어 ID를 추가합니다.

        https://players.api.brightcove.com/v2/accounts/account_id/players/de055fa4-4f09-45af-8531-419c6794ad04
        
        

    당신은 반점 플레이어 구성을 업데이트하기 위해 동일한 끝점에 요청하십시오.

    위의 응답에서 알 수 있듯이 preview_embed_codepreview_url. 새로운 플레이어 또는 플레이어 업데이트를 테스트 할 수 있도록 새로 생성되거나 업데이트 된 플레이어는 미리보기 모드로 설정되어 변경 사항을 기존 플레이어로 푸시하기 전에 볼 수 있습니다. 변경 사항을 프로덕션 환경에 적용하려면 게시 이 요청을 한 플레이어 :

        https://players.api.brightcove.com/v2/accounts/account_id/players/de055fa4-4f09-45af-8531-419c6794ad04/publish
        
        

    플레이어 맞춤 설정

    그리고, Brightcove player HTML, CSS, 그리고 표준 웹 기술로 제작되었습니다. 자바 스크립트. 당신은 사용자 정의 할 수 있습니다 player 같은 기술을 사용합니다. 이것은 페이지에서 할 수 있습니다 player 게시되지만 가장 좋은 방법은 맞춤 설정을 player 자체를 통해 player 구성, 플레이어를 통해 업데이트 반점 요청 Player Management API 이전 섹션에서 설명한대로

    추가 기능을 추가 할 수도 있습니다. player ...을 통하여 자바 스크립트 플러그인, 그리고 광범위한 Player API 코드를 통합 할 수 있도록 player. Brightcove는 광고 활성화, 최종 화면 사용자 정의 및 오버레이 추가와 같은 여러 가지 기성품 플러그인을 제공합니다.

    비디오 게시

    에서 플레이어 생성 섹션 위에서 우리는 플레이어 구성 객체를 얻을 때 Player Management API반환 된 데이터에는 HTML 페이지에 플레이어를 포함하기위한 iframe 태그와 플레이어에 페이지를 직접 포함하려는 경우 전체 HTML에 대한 URL이 포함됩니다.

    어떤 임베드를 선택하든, 원하는 것을 추가해야합니다. Video Cloud 동영상 ID 또는 재생 목록 ID를 소스 코드에 추가하여 콘텐츠를 플레이어에 추가 할 수 있습니다. iframe 소스 코드는 다음과 같습니다.

        <iframe
        src='//players.brightcove.net/57838016001/de055fa4-4f09-45af-8531-419c6794ad04_default/index.html'
        allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>
        
        

    플레이어의 URL에 매개 변수를 추가해야합니다. videoId={}video_id따라서 전체 소스 코드는 다음과 같이 보입니다.

        <iframe
        src='//players.brightcove.net/57838016001/de055fa4-4f09-45af-8531-419c6794ad04_default/index.html?videoId=4483119716001'
        allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>
        
        

    재생 목록 플레이어 인 경우 매개 변수를 사용합니다. playlistId={playlist_id} 대신. 인 페이지 삽입 코드의 수정 사항은 유사합니다.

    플레이어 구성이 플레이어 구성에서 고정되어 있지 않으면, 너비와 높이를 추가하여 플레이어의 크기를 조정해야합니다. style 속성:

        <iframe
        src='//players.brightcove.net/57838016001/de055fa4-4f09-45af-8531-419c6794ad04_default/index.html?videoId=4483119716001'
        allowfullscreen webkitallowfullscreen mozallowfullscreen
        style=width:640px;height:360px;></iframe>
        
        

    웹 로그 분석 보고서 가져 오기

    그리고, Analytics API 여러 다른 분석 보고서를 생성 할 수 있습니다 dimensions. 를 참조하십시오 차원 가이드 문의주시기 바랍니다.

    보고서의 날짜 범위와 반환 할 측정 항목을 지정할 수 있으며, 데이터를 가져올 수 있습니다. JSON, csv 파일xlxs 체재

    지난 한 달 동안 기간에 대한 세부 정보를 생성 할 수도 있습니다. 참여도 보고서 동영상의 100 분의 1 부분에 대한 조회수를 표시합니다.

    API 요약

    다음은 다음과 통합하는 데 유용한 API에 대한 요약입니다. Video Cloud.

    OAuth API
    클라이언트 자격 증명을 작성하고 토큰에 액세스하여 다른 API에 액세스하는 데 사용됩니다.
    미디어 관리
    Ingest Profiles API
    추가 된 비디오에 대해 만들 렌더링을 지정하는 사용자 정의 수집 프로파일을 만드는 데 사용됩니다. Video Cloud
    Dynamic Ingest API
    비디오 및 관련 미디어 자산을 추가하는 데 사용됩니다. Video Cloud
    CMS API
    처리를위한 비디오 개체를 만들고 비디오 및 재생 목록을 관리하는 데 사용됩니다.
    Brightcove Players
    그리고, Brightcove Player
    그리고, player 포함하는 자바 스크립트 상호 작용하는 API player 런타임에
    Player Management API
    플레이어를 만들고 구성하고 플레이어에 코드를 포함시키는 데 사용됩니다.
    Analytics API
    비디오 성능에 대한 분석 보고서를 얻는 데 사용됩니다.

    페이지 최종 업데이트 28 Sep 2020