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

    단계별 : Player 관리

    이 문서는이 문서의 기본 작업에 대한 실제적인 소개를 제공합니다. Player Management API.

    소개

    이 단계별 문서에서는 다음 작업을 수행합니다.

    • 만들기 player
    • 업데이트 player 비디오 자동 재생
    • 사용자 정의 player 플러그인을 추가하여
    • 에 대한 구성 표시 player

    시작하기

    이 단계별 문서로 접근하는 방법은 curl 문을 사용하여 Player 서비스 API. curl 도구는 명령 줄에서 URL 구문으로 데이터를 전송하는 데 사용됩니다. curl에 대한 자세한 내용은 http://curl.haxx.se.

    단순함을 위해이 단계별 문서 에서처럼 말풍선을 사용하지 않아도됩니다. 물론 원하는 언어를 사용하여 API와 통신 할 수 있습니다. 체크 아웃 설정 Player 관리 샘플 기본 인증, AJAX 및 JavaScript를 사용하여 기본 작업에 대한 일부 미니 응용 프로그램을 작성하는 방법을 보여줍니다. player, 모든 것을 표시 players 삭제 players 등

    API 사용을 시작하기 전에 몇 가지 예비 단계를 수행해야합니다. 이것들은:

    • Studio에 로그인하십시오. 계정이 여러 개인 경우 드롭 다운을 사용하여 새 계정을 만들 계정을 선택하십시오. player에스. 자격 증명 시스템이 제대로 작동하려면이 계정에 대한 관리자 권한이 있어야합니다. 사용자에게 관리자 권한이 있는지 확실하지 않은 경우 사용자 설정 페이지로 이동하여 역할과 함께 사용자가 나열됩니다.
    • Studio에서 선택했는지 확인하십시오. HOME 모듈 목록에서. 페이지 왼쪽 상단의 계정 이름 바로 아래에서 귀하의 계정을 복사 할 수 있습니다. 계정 ID.
      복사 할 계정 ID
    • 명령 줄에서 계정 ID 값을 환경 변수에 할당하려면 다음을 입력하십시오.
              export ACCOUNT_ID=YourAccountID
              
              
    • curl 명령문의 일부로 계정 전자 메일 주소를 제공하여 인증을 처리하면 API가 암호를 묻는 메시지를 표시합니다. 전자 메일 주소가 자주 사용되므로이 값을 환경 변수에 할당하십시오.
              export EMAIL=YourEmailAddress
              
              

    이제 API 사용을 시작할 준비가되었습니다.

    만들기 player

    이제 player 에 전화 Player Management API. 이 API 호출에 대한 자세한 내용은 Player Management API 개요 문서. 다음 curl 문을 복사하여 명령 줄에 붙여 넣는 것이 좋습니다.

    다음 단계는 player.

    1. 첫 번째 curl 문은 player 이름과 설명을 할당합니다. 이 문장을 명령 행에 붙여 넣고 엔터 버튼암호를 묻는 메시지가 나타납니다.
              curl \
                --header "Content-Type: application/json" \
                --user $EMAIL \
                --request POST \
                --data '{
                  "name": "My New Player Name v2",
                  "description": "My new player description"
                  }' \
                https://players.api.brightcove.com/v1/accounts/$ACCOUNT_ID/players
              

      서버가 응답 데이터를 JSON 형식으로 반환하는 것을 볼 수 있습니다.

              {
                "id": "S1qN4xeG7",
                "url": "http://players.brightcove.net/1507807800001/S1qN4xeG7_default/index.html",
                "embed_code": "<iframe src='//players.brightcove.net/1507807800001/S1qN4xeG7_default/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>",
                "embed_in_page": "http://players.brightcove.net/1507807800001/S1qN4xeG7_default/in_page.embed",
                "preview_url": "http://preview-players.brightcove.net/v2/accounts/1507807800001/players/S1qN4xeG7/preview/embeds/default/master/index.html",
                "preview_embed_in_page": "http://preview-players.brightcove.net/v2/accounts/1507807800001/players/S1qN4xeG7/preview/embeds/default/master/in_page.embed",
                "preview_embed_code": "<iframe src='//preview-players.brightcove.net/v2/accounts/1507807800001/players/S1qN4xeG7/preview/embeds/default/master/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>"
              }
              
    2. 당신의 player 다음 값 중 하나 (또는 ​​모두)를 사용하여 (이 시점에서 player새로 만든 동영상을 사용하여 동영상을 게시 할 수 있습니다. player Studio 사용) :
      • 복사 url 브라우저에 당신의 player.
      • 복사 embed_code HTML 페이지로 player iframe에서. 이 기능이 제대로 작동하려면 iframe이 포함 된 페이지가 실제 HTTP 서버에서 제공되어야합니다.
      • 그리고, embed_in_page 기능의 사용은 고급 (인 페이지) 소스 코드에 사용할 수있는 옵션 문서를 참조하시기 바랍니다.

    Video Cloud 동영상

    물론 당신은 만들 수 있습니다 player 당신의 비디오를 사용하여 Video Cloud 도서관. 대신에 media JSON 데이터의 섹션에서 video_cloud 부분. 아래 curl 문은 player 를 사용하여 생성 Video Cloud 동영상 ID.

            curl \
              --header "Content-Type: application/json" \
              --user $EMAIL \
              --request POST \
              --data '{
                "name": "Video Cloud CURL 10 March",
                "configuration": {
                  "video_cloud": {
                    "video": "4093372393001"
                  }
                }
              }' \
            https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players
            

    응답은 논리적으로 player 사용 media / sources / src 위에 표시된대로.

            {
            "id": "HJyMlHiuZ",
            "url": "http://players.brightcove.net/1507807800001/HJyMlHiuZ_default/index.html",
            "embed_code": "<iframe src="//players.brightcove.net/1507807800001/HJyMlHiuZ_default/index.html" allowfullscreen="" webkitallowfullscreen="" mozallowfullscreen=""></iframe>",
            "embed_in_page": "http://players.brightcove.net/1507807800001/HJyMlHiuZ_default/in_page.embed",
            "preview_url": "http://preview-players.brightcove.net/v1/accounts/1507807800001/players/HJyMlHiuZ/preview/embeds/default/master/index.html",
            "preview_embed_code": "<iframe src="//preview-players.brightcove.net/v1/accounts/1507807800001/players/HJyMlHiuZ/preview/embeds/default/master/index.html" allowfullscreen="" webkitallowfullscreen="" mozallowfullscreen=""></iframe>"
            }
            
            

    당신은 볼 수 있습니다 player반환 된 URL 값을 찾아서 index.html 페이지config.json. 에 대한 player 위의 curl 문으로 작성하면 다음을 볼 수 있습니다.

            {
              "account_id": "1507807800001",
              "compatibility": true,
              "embed_id": "default",
              "player": {
                "template": {
                  "name": "single-video-template",
                  "version": "6.5.0"
                }
              },
              "player_id": "HJyMlHiuZ",
              "player_name": "Video Cloud CURL 10 March",
              "updated_at": "2017-08-23T17:48:55.622Z",
              "video_cloud": {
                "policy_key": "BCpkADawqM2FnBS3InxzDxU4bd4otJdHKvexlXfhs_XgSj3jmBHAsV2xANIvSPd4KiakMbiQM5oYJPopOcJD7vNnPWGPGsnXCO3_ZGdjPmur53WV_a4JUPWHCLt5oiyekN44i24jZzHMB6hT",
                "video": "4093372393001"
              }
            }
            

    그리고, policy_key 에 자동으로 추가됩니다 player의 구성. 이것은 Policy API, 그리고 귀하의 특별한 제한을 허용 할 것입니다 player 다른 동영상에 액세스 할 수 있습니다. 즉, 정책 키는 언제 볼 수있는 비디오를 제어합니다.

    업데이트 player

    이제는 player. 다음으로 간단한 업데이트를 수행하는 방법을 배우게됩니다. player. 이 경우에는 player 비디오를 자동 재생 player브라우저에서 허용하는 경우

    1. 에서 반환 된 JSON에서 player 창조 id 값이 표시되었습니다. 이것을 (으)로 복사하십시오. PLAYER_ID 환경 변수.
              export PLAYER_ID=YourPlayerID
              
              
    2. 업데이트하려면 player 당신은 HTTP를 사용합니다 PATCH 방법. 당신은 업데이트 데이터를 보내드립니다 player. 당신은 설정합니다 autoplay ~에 대한 옵션 true. 다음 curl 문을 복사하여 붙여넣고 실행하십시오.
              curl \
                --header "Content-Type: application/json" \
                --user $EMAIL \
                --request PATCH \
                --data '{
                  "autoplay": true
                }' \
              https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration
              
    3. 서버가 서버를 포함하는 데이터를 반환하는지 확인하십시오. id , preview_url preview_embed_code 다음 JSON 형식의 값 :
              {
                "id": "S1qN4xeG7",
                "preview_url": "http://preview-players.brightcove.net/v2/accounts/1507807800001/players/S1qN4xeG7/preview/embeds/default/master/index.html",
                "preview_embed_in_page": "http://preview-players.brightcove.net/v2/accounts/1507807800001/players/S1qN4xeG7/preview/embeds/default/master/in_page.embed",
                "preview_embed_code": "<iframe src='//preview-players.brightcove.net/v2/accounts/1507807800001/players/S1qN4xeG7/preview/embeds/default/master/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>"
              }
              
    4. 다음 중 하나를 사용하십시오. preview_url or preview_embed_code 변경 사항을 확인할 수있는 값 player의 구성. 자동 재생이 이제 참임을 알 수 있습니다.
    5. 이제는 player 사용자가 볼 수있는 올바른 위치로 푸시합니다. 다음 명령을 입력하십시오 :
              curl \
              --header "Content-Type: application/json" \
              --user $EMAIL \
              --request POST \
              https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/publish
              
              

      한 번 player 당신은 가지고있을 출판 player미리보기 버전과 다릅니다. 게시 된 버전은 다음과 같은 방식으로 미리보기 버전과 다릅니다.

      • JavaScript와 CSS는 축소되고 연결되어 인라인됩니다. player 직접.
      • 포스터 이미지의 저해상도 버전이 생성되어 페이지에 인라인되어 높은 요청 설정 시간 (예 : 셀룰러 데이터 네트워크)이있는 네트워크의인지 된로드 시간을 향상시킵니다.
      • 의 이전 버전 player 업데이트가 게시 된 후 문제가 발견되면 복구 할 수 있도록 저장됩니다.
    6. 게시 할 때 JSON 응답이 있는지 확인하십시오. player 다음과 같이 나타납니다.
              {
              "id": "S1qN4xeG7",
              "url": "http://players.brightcove.net/1507807800001/S1qN4xeG7_default/index.html",
              "embed_code": "<iframe src='//players.brightcove.net/1507807800001/S1qN4xeG7_default/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>",
              "embed_in_page": "http://players.brightcove.net/1507807800001/S1qN4xeG7_default/in_page.embed"
              }
              
              
    7. 중 하나를 사용하십시오 player 당신의 출판을 확실히 구현 player 제대로 작동하고 있습니다.

    사용자 정의 player

    당신은 사용자 정의 할 수 있습니다 player 플러그인 사용. 기존 플러그인을 포함시키는 방법을 배울 수 있습니다 player 또는에 자신을 구축 단계별 : 플러그인 개발.

    이 경우 매우 간단한 기존 플러그인을 사용하여 비디오에 문자 메시지를 오버레이합니다. 다음은 HTML 단락 태그를 만드는 플러그인 코드입니다. 참고 : 클래스 이름과 텍스트는 단락에 할당 된 다음 기존에 추가됩니다 player. 이 플러그인은 이미 귀하의 편의를 위해 존재하며 //solutions.brightcove.com/bcls/video-js/new-player/first-plugin.js.

            videojs.registerPlugin('firstPlugin', function() {
              var player = this,
              overlay = document.createElement('p');
              overlay.className = 'vjs-overlay';
              overlay.innerHTML = "First Plugin Working!";
              player.el().appendChild(overlay);
            });
            
            

    단락은이 특별한 경우 검정색 배경의 검은 색 텍스트를 방지하기 위해 스타일을 지정해야합니다. 다음은 단락의 클래스 이름에 적용되는 스타일입니다. 이 스타일 시트는 이미 사용자 편의를 위해 존재하며 //solutions.brightcove.com/bcls/video-js/new-player/first-plugin.css.

            .vjs-overlay {
              background-color: #333333;
              color: white;
              font-size: 2em;
              padding: 5px;
              position: absolute;
              top: 100px;
              left: 20px;
              width: 150px;
            }
            
            

    curl 문을 사용하여 비디오 소스 및 포스터 이미지를 할당 한 것처럼 curl 문을 사용하여 player 다음 :

    • 플러그인 코드가 포함 된 JavaScript 파일의 위치
    • 스타일 시트의 위치
    • 함께 사용되는 플러그인 이름 player
    1. 다음 curl 문을 사용하여 플러그인을 기능적으로 만드십시오.
              curl\
              --header "Content-Type: application/json"\
              --user $EMAIL\
              --request PATCH\
              --data '{
                "scripts": [
                  "//solutions.brightcove.com/bcls/video-js/new-player/first-plugin.js"
                 ],
                 "stylesheets": [
                  "//solutions.brightcove.com/bcls/video-js/new-player/first-plugin.css"
                 ],
                 "plugins": [{
                   "name": "firstPlugin"
                 }]
                }'\
              https: //players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration
              
    2. 다음 curl 문을 사용하여 업데이트 된 내용을 게시하십시오. player. 이것은 이전 섹션에서 게시하기 위해 사용한 것과 동일한 게시 코드입니다. player.
              curl \
                --header "Content-Type: application/json" \
                --user $EMAIL \
                --request POST \
                https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/publish
              
    3. 반환 된 URL을 복사하고 찾아 봅니다. 플러그인이 작동하고 플러그인 텍스트가 표시됩니다.
      플러그인 텍스트
      플러그인 텍스트

    플러그인이 player 를 사용하여 Player Management APIBrightcove 제공 플러그인 또는 사용자 정의 플러그인 인 경우 플러그인이 player 코드 자체.

    디스플레이 구성

    수행 한 작업을 디버그하고 확인하려면 종종 player의 구성.

    1. 이렇게하려면 GET 방법 configuration URL.
              curl \
                --header "Content-Type: application/json" \
                --user $EMAIL \
                --request GET \
                https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration
              
              
    2. JSON 구성 응답이 다음과 유사한 지 확인하십시오.
              {
                "media": {
                  "poster": {
                    "highres": "//solutions.brightcove.com/bcls/assets/images/Tiger.jpg"
                  },
                  "sources": [{
                    "type": "application/x-mpegURL",
                    "src": "//solutions.brightcove.com/bcls/assets/videos/Tiger.m3u8"
                  }, {
                    "type": "video/mp4",
                    "src": "//solutions.brightcove.com/bcls/assets/videos/Tiger.mp4"
                  }]
                },
                "compatibility": true,
                "video_cloud": {
                  "video": "4093372393001",
                  "policy_key": "BCpkADawqM3ugPRAtcx48_C4FjXiEiJORcRFnXkeL9siQUpauO_o7SaIhSnYvM24nUCeD74UFG1LMW8vtmaftsO1vYeeOn2iglfvEbG-c0PYwJ_zQCQGsvkrbgrNyEDvbEKjyrsQVXj0DOco"
                },
                "player": {
                  "template": {
                    "name": "single-video-template",
                    "version": "6.7.0"
                  }
                },
                "scripts": ["//solutions.brightcove.com/bcls/video-js/new-player/first-plugin.js"],
                "stylesheets": ["//solutions.brightcove.com/bcls/video-js/new-player/first-plugin.css"],
                "plugins": [{
                  "name": "firstPlugin"
                }]
              }
              

    살펴볼 수있는 또 다른 방법은 player의 구성은 반환 된 URL 값을 찾아보고 index.html 페이지config.json.

    전달 시스템 API

    그리고, Delivery System API저장소라는 파일 그룹의 관리 및 배치를 허용합니다. 이 파일은 REST API 및 git을 통해 관리됩니다. 이 API는 대부분의 사람들이 만들거나 편집 할 때 필요하지 않습니다 player그러나 다른 목적으로 사용할 수있는 매우 흥미로운 API 세트 일 수 있습니다. 당신이 그들을 시도하고 싶다면, 당신은 할 수 있습니다 여기 그렇게해라.. 실습을 시작하려면 Ste-by-Step : 배달 시스템 문서를 참조하시기 바랍니다.


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