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

    CMS와 Video Cloud

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

    사용자 기능

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

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

    이 기능을 모두 최종 사용자에게 공개하고 싶지는 않을 것입니다. 예를 들어 비디오를 삭제할 수는 없습니다. 통합의 장점 중 하나 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 GET 요청은 비디오 객체를 반환합니다. 업데이트하려면 JSON 그것을 사용하여 PATCH 동일한 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
        
        

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

    만들기 Players

    Brightcove player를 통해 만들 수 있습니다 Player Management API . API를 사용하면 만들 수 있습니다 player, 속성을 업데이트하고 URL 형식의 소스 코드를 가져옵니다. iframe 태그 또는 HTML 블록을 페이지에 삽입 할 수 있습니다.

    최대 200 개 player계정 당이지만 일반적으로 사용자가 거의 player당신이 절대적으로 필요합니다. 당신은 분리해야합니다 player단일 동영상 또는 재생 목록을 재생하는 데 사용되지만 그렇지 않으면 player스타일이 다르거 나 플러그인을 통해 다른 기능이 추가 될 때

    를 만들려면 player, 당신은 단순히 POST 요청 Player Management API:

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

    요청 본문에 player 구성 - 필요한 유일한 것은 name:

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

    응답은 당신에게 player 여러 형식의 소스 코드뿐만 아니라 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"
        }
        
        

    전체를 얻으려면 player 구성을 요청하면 /players 엔드 포인트이지만 player 위의 응답으로 반환되는 ID :

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

    당신은 PATCH 동일한 엔드 포인트에 업데이트 요청 player 구성.

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

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

    커스터마이징 Players

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

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

    비디오 게시

    에서 만들기 Player의 섹션 위의 우리는 당신이 얻을 때 player 를 사용하여 구성 개체 Player Management API반환 된 데이터에는 iframe 태그를 포함하기위한 iframe 태그가 포함됩니다. player HTML 페이지에 삽입하고 전체 HTML의 URL을 player 페이지에서 직접.

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

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

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

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

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

    그렇지 않으면 player 치수는 player 구성의 크기를 조정해야합니다. player 에 너비와 높이를 추가하여 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, csvxlxs 체재

    지난 한 달 동안 기간에 대한 세부 정보를 생성 할 수도 있습니다. Engage보고서 동영상의 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 포함하는 JavaScript 상호 작용하는 API player 런타임에
    Player Management API
    작성 및 구성하는 데 사용 player그리고 얻을 player 소스 코드
    Analytics API
    비디오 성능에 대한 분석 보고서를 얻는 데 사용됩니다.

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