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

    원격 자산

    이 항목에서는 비디오, 변환, 매니페스트, 이미지 및 WebVTT 텍스트 트랙을 포함하여 원격 에셋을 추가하는 방법을 Video Cloud 를 사용하여 CMS API. 이 항목에서는 비디오를 설정 한 다음 원격 자산을 추가, 업데이트 및 제거하는 방법에 대해 설명합니다.

    개요

    원격 자산은 주로 자산 운영아래에 몇 가지 예외가 있습니다. 자산에 대한 GET 작업은 가져온 자산과 원격 자산 모두에 사용할 수 있습니다.

    권한 부여

    워크 플로우

    다음은 원격 자산을 설정하는 단계입니다.

    원격 자산 워크 플로
    원격 자산 워크 플로

    다음 섹션에서는 각 단계를 살펴 보겠습니다.

    비디오 만들기

    원격 저작물을 추가하려면 먼저 저작물에 동영상 개체를 만들어야합니다. Video Cloud 미디어 라이브러리, POST 요청을 사용하여 :

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

    요청 본문에는 최소한 비디오 이름이 들어 있지만 추가 메타 데이터가 포함될 수있는 JSON 객체가 포함됩니다.

          {
            "name": "My Remote Video",
            "description": "A short description of the video",
            "tags": ["remote", "fall_campaign"],
            "reference_id": "myUniqueReferenceID"
          }
          
          

    비디오 만들기 작업에 대한 자세한 내용은 API 참조.

    렌 디션 추가

    다음으로 POST 요청을 작성하여 하나 이상의 전체 길이 원격 비디오 표현을 추가하십시오.

          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/renditions
          
          

    요청 본문의 JSON에는 원격 URL이 최소한 포함되어야하지만 rendition에 대한 다른 메타 데이터가 포함될 수 있습니다.

          {
            "video_duration": 31487,
            "name": "RA - Great Blue Heron",
            "remote_url": "//learning-services-media.brightcove.com/videos/mp4/greatblueheron.mp4",
            "encoding_rate": 983000,
            "frame_height": 360,
            "size": 3887659,
            "frame_width": 640,
            "video_codec": "h264",
            "video_container": "MP4",
            "progressive_download": true
          }
          
          

    노트

    1. 전체 길이의 비디오 변환 (일반적으로 .mp4 또는 .mov 파일)을 추가하는 경우에만이 엔드 포인트를 사용하십시오. HLS 또는 DASH와 같은 분할 된 스트림을 추가하려면 다음 절에서 설명하는 매니페스트 엔드 포인트를 사용하십시오.
    2. Video Cloud 원격 비디오 파일을 검사하지 않으므로 추가 메타 데이터를 제공하면 Video Cloud 이 정보를 Studio (또는 Brightcove player을 구성하면 player 메타 데이터를 표시하려면).

      추가 렌 디션 작업에 대한 자세한 내용은 API 참조.

    3. 원격 자산의 렌더링에는 video_codec video_container 필드가 제대로 작동합니다.
    4. MP4 변환 절대로 필요한 것"progressive_download": true 필드에서 제대로 작동하도록 설정 Brightcove player
    5. 혼합 저작물은 허용되지 않습니다. 가져온 동영상에 원격 재생을 추가 할 수 없습니다.
    6. CDN 또는 기타 원격 저장소가 HTTP 및 HTTPS 전달을 모두 지원하는 경우 원격 자산의 URL을 프로토콜에 중립적 인 URL (예 : "http : //my.domain/path/ ..."대신 "//my.domain/path/ ..."을 사용하십시오)

    매니페스트 추가

    DASH 및 HLS 변환과 같은 원격 세그먼트 형식을 추가하려면 비디오를 만든 다음 매니페스트를 추가하기 만하면됩니다. 지원 이전 섹션에서 설명한 것처럼 "렌 디션 추가"가 필요합니다.

    전체 길이 변환을 추가하는 것 외에도 매니페스트 유형에 대한 엔드 포인트에 대한 POST 요청을 작성하여 HLS, HDS 및 ISM과 같은 세그먼트 화 된 변환에 대한 매니페스트를 추가 할 수 있습니다.

          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hls_manifest
          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/hds_manifest
          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ism_manifest
          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/ismc_manifest
          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/dash_manifests
          
          

    요청 본문 JSON에서 원격 URL과 이름을 제공하십시오 (선택 사항).

          {
            "remote_url": "http://learning-services-media.brightcove.com/avideo/hls/chickadee/chickadee.m3u8",
            "name": "chickadee_hls"
          }
          
          

    추가 매니페스트 작업 사용에 대한 자세한 내용은 API 참조 문서의 관련 섹션을 참조하십시오.

    포스터 / 미리보기 이미지 추가

    다음 엔드 포인트에 POST 요청을 작성하여 비디오에 원격 포스터 및 축소판을 추가 할 수 있습니다.

          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/poster
          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/thumbnail
          
          

    요청 본문 JSON에서 이미지의 원격 URL을 포함해야하며 원하는 경우 이름을 추가 할 수 있습니다.

          {
            "remote_url": "http://learning-services-media.brightcove.com/images/great-blue-heron-poster.png"
          }
          
          

    작업에 대한 자세한 내용은 API 참조 :

    텍스트 트랙 추가

    텍스트 트랙을 사용하여 캡션, 챕터 및 기타 시간 기반 메타 데이터를 비디오에 추가 할 수 있습니다.

    렌 디션 및 이미지와 달리 텍스트 트랙은 원격 자산 비디오에서 처리 된 비디오와 동일하게 취급됩니다. Video Cloud 시스템. 텍스트 트랙을 비디오에 실제로 추가하려면 Studio에서 Media 모듈을 사용하거나 CMS API 비디오 업데이트 작업.

    리모콘을 섭취 한 것으로 교체하십시오.

    원격 애셋 동영상을 섭취 한 동영상으로 대체하려면 Dynamic Ingest API:

          https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
          
          

    가장 간단한 요청 본문은 다음과 같습니다.

          {
            "master": {
              "url": "http://host/master.mp4"
            }
          }
          
          

    을 참조 Dynamic Ingest API 참고 추가 옵션 및 정보는

    원격 자산 비디오의 일반적인 용도 중 하나는 다음에서 사용할 자리 표시 자 비디오를 만드는 것입니다. live 스트리밍 이벤트. 이벤트가 완료되면 "live"같은 이벤트에 대한 주문형 비디오 녹화가 포함 된 비디오 player 당신은 live 흐름. 위에서 설명한 방법을 사용하여이를 수행 할 수 있지만 원격 자산 비디오를 수집 된 비디오로 전환하는 데 사용할 수도 있습니다. Video Cloud.

    저작물 수정

    비디오의 원격 자산을 추가하는 것 외에도 자산 정보를 검색, 업데이트 및 삭제하는 작업도 있습니다. 이러한 조작은 위에서 설명한 엔드 포인트를 사용하지만 GET, PATCH 또는 DELETE 요청을 사용합니다. 업데이트 및 삭제 요청의 경우 URL을 요청하려면 애셋 ID (POST 및 GET 요청에 대한 응답에 포함됨)를 추가해야합니다.

          https://cms.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/assets/{asset_type}/{asset_id}
          
          

    을 참조 API 참조 get, update 및 delete 작업에 대한 자세한 내용은


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