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

    소스 API

    이 주제는 Embed API 사용시기 및 방법을 결정하는 데 도움이됩니다. 사용 중 선택 결정 Player 구성 API와 Embed API는 중요하며이 문서의 내용이 이러한 결정을 안내합니다.

    Embed API를 사용하는 이유는 무엇입니까?

    내장 API를 사용하면 특정 인스턴스를 여러 개 만들 수 있습니다 player. 이것을 생각하는 좋은 방법 player/ 인스턴스 관계는 부모 / 자식 관계입니다. 싱글 player 부모이고 player임베드 API로 작성된 s는 상위의 하위입니다. player. 부모 player 당신이 원하는 속성의 대부분을 가지고 player 포함 API를 사용하여 다른 하위의 속성 하위 집합을 사용자 정의 할 수 있습니다. player에스. 예를 들어 다른 미디어를로드하거나 다른 자식과 다른 플러그인 및 스타일링을 사용할 수 있습니다. players.

    다음 다이어그램은 기능을 명확히하는 데 도움이됩니다. 왼쪽 아래에 부모가 있고 두 명의 자식이 있습니다. player오른쪽에 있습니다. 다음을 확인하십시오.

    • 포스터는 두 어린이 모두에게 상속됩니다.
    • 재생 버튼의 모양은 맨 위에있는 자식에 상속되며 맨 아래의 자식에는 오버라이드됩니다.
    • 상위 자식은 속성을 추가합니다 (이 경우에는 부모가 가지고 있지 않은 오버레이).
    하위 속성 추가
    하위 속성 추가

    이 상위 / 하위 관계의 또 다른 강력한 기능은 상속이 진행 중임을 나타냅니다. 다음 다이어그램은 부모에게 할당 된 새 포스터를 보여 주며 두 자식 모두 해당 구성 변경을 상속합니다.

    아이들은 변화를 물려받습니다.
    아이들은 변화를 물려받습니다.

    삽입 API를 사용하지 않을 때

    유스 케이스에 필요한 경우 임베드 API를 사용해야하는 몇 가지 이유가 있지만 규칙을 고수해야하는 몇 가지 이유도 있습니다. player에스. 몇 가지가 있습니다 :

    • 아동 player를 사용하여 편집 할 수 없습니다 Video Cloud 사진관. 자녀 만 편집 할 수 있습니다 player를 통해 Player Management API. 부모를 편집 할 수 있습니다 player 아이의 player in Video Cloud 그러나 Studio는 부모를 변경했습니다. player 모든 어린이에게 영향을 미칩니다 players.
    • 부모 게시 player 아이가 많으면 시간이 오래 걸릴 수 있습니다 player그 부모와 관련된 player. 각 어린이 player 자녀가 30 명 이상인 경우 별도로 발행 players, 자녀가 약간 지연 될 수 있습니다 player 출판. 이것은 정기적으로 30을 게시하는 것과 동일합니다. player동시에.

    위의 이유를 감안할 때 정기적으로 사용하는 것이 좋습니다. player자녀가 필요하다는 것을 알게되면 임베드를 시도하십시오. players.

    동영상 태그 data-embed

    부모와 자식의 표기법 차이가 있습니다 player에스. 표준 인 페이지 삽입 player 코드는 다음 형식으로 나타납니다.

        <video-js
          data-account="1507807800001"
          data-player="HiAdwRZ7kK"
          data-embed="default"
          controls=""
          data-application-id=""
          class="vjs-fluid"></video-js>

    그리고, data-embed 속성은 player 부모 또는 자녀입니다. 값이 default은 player 부모입니다. 만약 player 아이입니다 data-embed 속성은 부모의 ID를 포함합니다 player. 그 예는 다음과 같습니다.

    그리고, data-embed 속성은 player 부모 또는 자녀입니다. 값이 default은 player 부모입니다. 만약 player 아이입니다 data-embed 속성은 부모의 ID를 포함합니다 player. 그 예는 다음과 같습니다.

        <video-js
          data-account="1507807800001"
          data-player="HiAdwRZ7kK"
          data-embed="NURK56ZSV"
          data-application-id=""
          class="video-js" controls></video-js>

    참고로 data-player즉, player ID는 동일하지만 data-embed 에서 변경되었습니다 default 아이에게 player의 ID입니다.

    아동 player URL이

    부모를 어떻게 구별합니까 player 아이 player에스? URL이 다릅니다. 예를 들어, 부모 player의 URL은 다음과 같습니다.

        //players.brightcove.net/1507807800001/HiAdwRZ7kK_default/index.min.js

    포함 API를 사용하여 하위를 작성한 후 player, 아이 player다음에 표시된 것처럼 님의 ID가 부모의 URL에 추가되었습니다.

        //players.brightcove.net/1507807800001/HiAdwRZ7kK_NURK56ZSV/index.min.js

    부모 / 자식 유스 케이스

    여러 비디오를 사용한다고 가정 player에스. 종종의 공통된 특징 players는 거의 동일하지만 몇 가지 경우에 player 특별한 경우. 여러 개를 만들 수 있습니다 player사용하여 Player 구성 API POSTPATCH 그러나 유지 보수 문제가 발생할 수 있습니다. 예를 들어, player에스. 이것은 사용하는 것을 의미합니다 PATCH 다른 모든 player에스. 아이를 만든 경우 players, 당신은 오직 PATCH 부모 player, 그리고 모든 아이 player새 포스터가 자동으로 표시됩니다.

    창조 과정

    완료 한 경우 단계별 : Player 관리 curl 문을 사용하여 HTTP 메소드를 Player Management API. 동일한 접근법이 여기에 사용됩니다.

    를 만들려면 player 아마도 몇 가지 HTTP 메소드를 사용했을 것입니다. Player 다음과 같은 구성 API

    • 만들기 player 를 사용하여 POSThttps://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players
    • 업데이트 player 를 사용하여 PATCHhttps://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/configuration
    • 업데이트 된 게시 player 를 사용하여 POSThttps://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/publish

    어린이에게도 비슷한 접근법이 사용됩니다 player내장 API를 사용합니다. 매우 높은 수준에서 :

    • 아이 만들기 player 를 사용하여 POSThttps://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/퍼가기. 참고 : 어린이 playerembed API를 사용하여 생성하면 생성시 자체 게시되므로 하위에 게시 할 필요가 없습니다. player 아이에게만 창조 player 업데이트합니다.
    • 아이를 업데이트 player 를 사용하여 PATCHhttps://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/embeds / $ EMBED_ID / 구성
    • 아이를 게시 player 를 사용하여 POSThttps://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/퍼가기 / $ EMBED_ID / 퍼블리싱

    다음 내용은 프로세스에 대해 자세히 설명합니다.

    아이 만들기 player

    아이를 만들려면 player 당신은 HTTP를 사용 POST 메서드를 호출합니다.

        curl /
        --header "Content-Type: application/json" /
        --user $EMAIL /
        --request POST /
        --data '{
        "media": {
        "sources": [
          {
            "src":"http://solutions.brightcove.com/bcls/assets/videos/BirdsOfAFeather.mp4",
            "type":"video/mp4"
          }
        ],
        "poster": {
          "highres":"http://solutions.brightcove.com/bcls/assets/images/BirdsOfAFeather.jpg"
        }
        }
          }' /
        https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/embeds

    아이에 대한 응답 예 player 생성은 다음과 같습니다.

        {
            "id": "be864624-8d85-4dfc-8fe6-4e9dd4c70417",
            "url": "http://players.brightcove.net/1507807800001/668c5107-a80c-4940-8c17-279c01ce101c_be864624-8d85-4dfc-8fe6-4e9dd4c70417/index.html",
            "embed_code": "<iframe src='//players.brightcove.net/1507807800001/668c5107-a80c-4940-8c17-279c01ce101c_be864624-8d85-4dfc-8fe6-4e9dd4c70417/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>",
            "embed_in_page": "http://players.brightcove.net/1507807800001/668c5107-a80c-4940-8c17-279c01ce101c_be864624-8d85-4dfc-8fe6-4e9dd4c70417/in_page.embed",
            "preview_url": "http://preview-players.brightcove.net/1507807800001/668c5107-a80c-4940-8c17-279c01ce101c/be864624-8d85-4dfc-8fe6-4e9dd4c70417/index.html",
            "preview_embed_code": "<iframe src='//preview-players.brightcove.net/1507807800001/668c5107-a80c-4940-8c17-279c01ce101c/be864624-8d85-4dfc-8fe6-4e9dd4c70417/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>"
        }

    참고 : 아이 player 자체 제작에 대한 게시, 그래서 아이를 게시 할 필요가 없습니다 player 창조 후. 여전히 아이를 게시해야합니다 player 그것이 변경되면 PATCH 방법. 이 시점에서 미리보기 정보는 게시 된 자식을 사용할 수 있으므로 도움이되지 않습니다. player 창조 즉시.

    이제 url 아이의 재산 player 결과를 볼 수 있습니다. 아래 예에서 자녀 player 부모에게 추가되었습니다 player 단계별로 생성 : Player 조치. 새 포스터와 비디오를 볼 수 있지만 부모의 오버레이 플러그인 player 여전히 존재합니다.

    아동 Player 부모의 오버레이
    아동 Player 부모의 오버레이

    자녀 업데이트 player

    자식을 업데이트하려면 player 당신은 HTTP를 사용 PATCH 방법. 다음 curl 문은 poster 재산. 설정 한 것으로 가정합니다. $EMBED_ID 환경 변수 적절하게 :

        curl
        --header "Content-Type: application/json"
        --user $EMAIL
        --request PATCH
        --data '{
        "media": {
        "poster": {
          "highres":"http://solutions.brightcove.com/bcls/assets/images/Water-Splashing.jpg"
        }
        }
          }'
        https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/embeds/$EMBED_ID/configuration
        

    응답은 두 가지 모두에 대한 미리보기 정보를 제공합니다. preview_urlpreview_embed_code 암호:

        {
            "preview_url": "http://preview-players.brightcove.net/1507807800001/668c5107-a80c-4940-8c17-279c01ce101c/be864624-8d85-4dfc-8fe6-4e9dd4c70417/index.html",
            "preview_embed_code": "<iframe src='//preview-players.brightcove.net/1507807800001/668c5107-a80c-4940-8c17-279c01ce101c/be864624-8d85-4dfc-8fe6-4e9dd4c70417/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>"
        }

    자녀 게시 player

    아이가 player 변경하면 게시해야합니다. 반드시 $EMBED_ID 환경 변수가 설정되고 새로 변경된 자식을 게시 할 수 있습니다 player:

        curl
        --header "Content-Type: application/json"
        --user $EMAIL
        --request POST
        https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/embeds/$EMBED_ID/publish

    응답은 자녀를 사용하는 데 필요한 필수 정보를 제공합니다 player, 출판과 매우 흡사 player 않습니다 :

        {
            "id": "be864624-8d85-4dfc-8fe6-4e9dd4c70417",
            "url": "http://players.brightcove.net/1507807800001/668c5107-a80c-4940-8c17-279c01ce101c_be864624-8d85-4dfc-8fe6-4e9dd4c70417/index.html",
            "embed_code": "<iframe src='//players.brightcove.net/1507807800001/668c5107-a80c-4940-8c17-279c01ce101c_be864624-8d85-4dfc-8fe6-4e9dd4c70417/index.html' allowfullscreen webkitallowfullscreen mozallowfullscreen></iframe>",
            "embed_in_page": "http://players.brightcove.net/1507807800001/668c5107-a80c-4940-8c17-279c01ce101c_be864624-8d85-4dfc-8fe6-4e9dd4c70417/in_page.embed"
        }

    하위 정보 표시

    HTTP를 사용할 수 있습니다. GET 자녀에 관한 정보를 검색하는 방법 player. curl 문의 예는 다음과 같습니다.

        curl
          --header "Content-Type: application/json"
          --user $EMAIL
          --request GET
          https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/embeds

    꽤 많은 양의 JSON 데이터가 반환됩니다.

    자녀 삭제 players

    자녀를 삭제할 수도 있습니다 player ~을 사용하여 DELETE 방법. 다음은 자식을 삭제하는 curl 문 예입니다. player:

        curl
        --header "Content-Type: application/json"
        --user $EMAIL
        --request DELETE
        https://players.api.brightcove.com/v2/accounts/$ACCOUNT_ID/players/$PLAYER_ID/embeds/$EMBED_ID

    물론 이것은 어린이에게만 영향을 미칩니다. player 부모가 아닌 player.


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