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

    개요 : Dynamic Ingest API

    이 항목에서는이 항목을 사용하는 방법을 Dynamic Ingest API 동영상 콘텐츠를 업로드하고 관리 할 수 ​​있습니다.

    API 기능

    Brightcove의 DI (Dynamic Ingest) API는 고객의 저장 위치에서 비디오 소스 파일을 다운로드하고 소스 파일의 지정된 변환을 만드는 기능을 기반으로합니다. (옵션도 있습니다 소스 파일 업로드 Dynamic Ingest가 액세스 할 수있는 임시 위치로 옮깁니다.) 플랫폼은 클라우드 중심적이며 전 세계적으로 분산되어 있으며 최신 동등 사례를 기반으로 동급 최고의 일관성과 속도를 제공합니다.

    워크 플로우 개요

    여러 시스템 / 기술이 미디어의 전체 트랜스 코딩 및 저장에 사용됩니다. 그들은:

    • CMS (Content Management System) API: DI API에서 사용할 비디오 객체를 만듭니다.
    • Zencoder: 여러 개의 렌 디션을 만드는 비디오를 트랜스 코딩합니다.
    • 아마존 S3: 프로필 설정을 기반으로 마스터 및 변환을 저장소로 이동합니다.
    • 목록: 비디오와 관련된 필수 정보를 저장합니다.

    초기 트랜스 코딩 후 미디어에서 수행 할 수있는 작업은 다음과 같습니다.

    • 재 트랜스 코드: 마스터가 존재할 때 새로운 렌 디션 생성 (마스터가 존재하지 않으면 에러)
    • 교체: 새 마스터를 가리 키거나 기존 마스터를 바꿉니다.

    운영

    DI API를 사용할 때 인제 스트 프로파일 읽기 및 계정에 인제 스트 정보 작성과 같은 다른 조작을 수행합니다. 다음은 DI 작업에 필요한 작업의 전체 목록입니다.

    • video-cloud / video / create
    • 비디오 클라우드 / 비디오 / 읽기
    • 비디오 클라우드 / 비디오 / 업데이트
    • video-cloud / ingest-profiles / 프로필 / 읽기
    • video-cloud / ingest-profiles / account / read
    • video-cloud / ingest-profiles / account / write
    • video-cloud / ingest-profiles / profile / write
    • video-cloud / upload-urls / read

    클라이언트 자격 증명을 얻으려면 Studio를 사용하십시오. 관리 도구 또는 다음 문서 중 하나를 참조하십시오.

    모범 사례

    유효한 출처

    Dynamic Ingest는 HTTP / HTTPS 또는 S3에서 소스 비디오 파일을 가져올 수 있습니다 - 인증 여부

    예 :

    • http://example.com/path/to/input.avi
    • https://dl.dropboxusercontent.com/u/3641457/Bird_Titmouse.mp4
    • s3 : //my-bucket/video.mp4

    S3에 대한 메모

    동영상이 보호 된 S3 버켓에있는 경우 S3에서 다이나믹 인제 스트 사용하기 Dynamic Ingest가 파일에 액세스 할 수있는 권한을 설정하는 방법에 대한 자세한 내용을 참조하십시오.

    끌어 오기 기반 가져 오기를 사용하면 손쉬운 워크 플로와 고유 한 디지털 마스터의 리포지토리를 포함하는 장점이 있습니다. 그러나 이것이 당신을위한 옵션이 아니라면, 소스 파일 업로드 Dynamic Ingest가 액세스 할 수있는 임시 위치에 비디오 및 기타 자산을 업로드 할 수 있습니다.

    소스 파일 이름

    모든 입력 URL은에 따라 올바르게 인코딩되어야합니다. RFC 3986 Brightcove로 전송 될 때 이것은 예약 된 문자 url의 경로에서 발견 된 백분율은 인코딩됩니다 (공백으로 인코딩 됨). %20), url의 쿼리에서 발견 된 예약 문자는 백분율 인코딩됩니다 ( + or %20+ ~로 인코딩 됨 %2B).

    A 사전 서명 된 S3 (v2 이 포함되어 있습니다 서명, 만료AWSAccessKeyIdv4 이 포함되어 있습니다 엑스 - 암즈 - 알고리즘, X-Amz-Credential, X-Amz-Date, X-Amz- 만료, X-Amz-SignedHeadersX-Amz 서명) 또는 GCS (포함 서명, 만료GoogleAccessId) url은 이미 적절하게 인코딩되어야하며 있는 그대로 사용할 수 있습니다..

    동영상 가져 오기

    동영상을 가져 오는 데 필요한 두 가지 API 호출이 있습니다.

    1. 전화 CMS API 동영상 개체를 만들려면 Video Cloud 시스템과 그 id를 얻는다.
    2. DI API를 호출하여 비디오 소스 파일의 URL을 제공하고 섭취 프로필 사용될

    기본 요청 샘플 세트는 다음과 같습니다.

    CMS API 의뢰

    HTTP 메소드
    POST
    요청 URL
    https://cms.api.brightcove.com/v1/accounts/{account_id}/videos
    본문 요청
        {
        "name": "My new video"
        }
        
        

    응답 데이터에는 동영상이 포함됩니다. id , 다음 요청에서 사용됩니다.

    인게 스트 API 요청

    HTTP 메소드
    POST
    요청 URL
    https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests
    본문 요청
        {
        "master": {
        "url": "http://host/master.mp4"
        },
        "profile": "high-resolution"
        }
        
        

    을 참조 퀵 스타트 API 호출에 대한 자세한 내용은 작업 샘플.

    CMS API 동영상을 만들려면 전화하세요. Video Cloud 시스템 CMS API 개요. 비디오 name 이 필요하며 동영상 메타 데이터에 포함 된 이름 및 기타 문자열 (예 : description ) URI로 인코딩되어야 함.

    샘플 애셋

    Brightcove Learning Services는 Dynamic Ingest 시작시 실험에 사용할 수있는 몇 가지 샘플 자산을 제공합니다. 이러한 저작물에는 여러 언어로 된 짧은 비디오, 이미지 및 WebVTT 캡션이 포함됩니다.

    동영상 바꾸기

    비디오를 새 버전이나 새로운 변환 세트로 바꾸려면 Dynamic Ingest API 전화는 그것이 한 것과 똑같습니다. 새 동영상 가져 오기 - 유일한 차이점은 당신이 전화를 걸 필요가 없다는 것입니다. CMS API 동영상 개체를 만들려면 Video Cloud 시스템에 대한 ID를 얻으십시오. 지정된 URL의 소스 비디오 파일이 처음에 섭취 된 원본 비디오 파일과 동일한 경우, 새 렌 디션 집합 만 가져옵니다. 원본 파일이 새 파일이면 기존 비디오를 바꿉니다. 재전송이 완료 될 때까지 모든 비디오는 기존 렌 디션으로 재생 가능 상태를 유지합니다.

    을 참조 샘플 작업.

    비디오 재전송

    당신이 선택한 경우 마스터 보관 동영상을 통해 Dynamic Ingest API 또는 Studio 업로드 모듈을 사용하면 마스터의 비디오를 다시 인코딩 할 수 있습니다. 다시 한 번 인제 스트 요청의 URL은 같지만 요청 본문에는 다음 항목이 있습니다.

        // request
        POST /v1/accounts/{account_id}/videos/{video_id}/ingest-requests
        // request body
        {
        "master": { "use_archived_master": true },
        "profile": "videocloud-default-v1"
        }
        
        

    이미지

    당신은을 사용할 수 있습니다 Dynamic Ingest API 비디오에서 포스터 및 썸네일 이미지를 캡처하거나 자신의 이미지를 추가 할 수 있습니다. 자세한 내용은 이미지와 Dynamic Ingest API.

    자막 캡션

    또한 Dynamic Ingest를 사용하여 WebVTT 캡션을 비디오에 추가하거나 기존 비디오 용으로 업로드 할 수 있습니다. 자세한 내용은 다음을 참조하십시오. WebVTT 파일 가져 오기.

    DRM 및 HLSe

    Dynamic Ingest는 Brightcove에서 지원하는 DRM 유형을 사용하는 비디오를 처리합니다. HLSe도 지원됩니다.

    렌 디션 보관

    기본적으로 모든 비디오 및 이미지 변환은 자동으로 보관됩니다. 렌 디션의 아카이브를 해제하려면, Brightcove 지원 센터에 문의하십시오. 그 주 디지털 마스터 인제 스트 프로파일에 지정된 경우 아카이브됩니다.

    알림

    하나 이상의 콜백 URL을 지정하여 수집 프로세스의 결과에 대한 알림을 수신 할 수 있습니다. 지정한 URL은 POST 요청을 허용 할 수있는 것보다 앱용이어야합니다. 알림은 JSON 형식으로 전송됩니다.

    알림 수신 및 통역에 대한 자세한 내용은에서 확인할 수 있습니다. 알림 : 동적 인게이지먼트 및 CMS APIs


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