개요 : 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를 사용하십시오. 관리 도구 또는 다음 문서 중 하나를 참조하십시오.

모범 사례

DI 및 전체에 걸친 총 요청에 대한 각 계정의 초당 20 요청 CMS API (CMS API 또는 인제 스트 API 요청)
계정 당 100 동시 DI 작업 제한 (변환 된 계정에 대한 큰 일괄 요청에 대한 추가 옵션이 있습니다. 동적 전달)
파일 당 100GB보다 작은 콘텐츠를 수집합니다 (큰 파일을 필요로하는 경우 계정 관리자에게 문의하십시오)
일괄 적으로 파일을 처리하는 경우 동시 일반 우선 순위 작업을 100로 제한하고 한 작업이 다른 작업을 추가하기 전에 처리를 완료 할 때까지 기다립니다
전체 배치를 처리하기 전에 인제 스트 프로파일 변경 사항의 유효성 검사
다음 링크를 통해 지원 동일한 자산에 대해 중복 작업 처리를해야합니다. 이 인스턴스의 에셋은 비디오 객체, 특정 언어의 오디오 트랙, 특정 언어의 텍스트 트랙 또는 특정 이미지 유형으로 정의됩니다. 다음은 그 요점을 설명하기위한 몇 가지 예입니다.
- UNACCEPTABLE : 동영상 파일에 대한 수신 요청을 제출 한 다음 첫 번째 취입 작업이 완료되기 전에 동일한 동영상 ID로 다른 동영상 수신 요청을 제출합니다.
- ACCEPTABLE : 동영상 파일에 대한 인제 스트 요청을 제출 한 다음 동일한 Video ID와 연결된 영어 텍스트 트랙에 대한 인제 스트 요청을 제출 한 다음 동일한 Video ID를 사용하는 미리보기 이미지에 대한 인제 스트 요청을 제출합니다.
- ACCEPTABLE : 영어로 된 텍스트 트랙의 인제 스트 작업을 제출 한 다음 스페인어로 텍스트 트랙에 대한 인제 스트 요청을 병렬로 제출하십시오
- UNACCEPTABLE : 스페인 오디오 트랙을 섭취하라는 요청을 제출 한 다음 즉시 같은 비디오 ID로 다른 스페인 오디오 트랙을 섭취하라는 요청을 제출하십시오.
그리고, profile 인제 스트 요청 필드 선택. 하드 코딩을 피하십시오. profile 앱 및 통합에서 - 가장 일반적으로 사용되는 프로필을 디폴트 값 계정에 대해 입력란을 생략하고 필드를 생략하십시오. 계정에 사용할 수있는 프로파일 가져 오기 사용자가 강제로 하나를 선택하도록합니다.

유효한 출처

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

배송 시 요청 사항:

비디오 파일 이름 (확장자 포함)은 120 1 바이트 (60 2 바이트) 문자를 초과해서는 안됩니다. 이 경우 동영상이 성공적으로 섭취되지만 나중에 다시 코드를 재 코딩 할 수 없습니다.
호스트 이름 (파일 위치 또는 콜백 URL)에는 IETF 사양에 따라 밑줄 문자 또는 기타 구두점 또는 특수 문자가 포함되어서는 안됩니다. 만나다 이 위키 백과 문서 자세한 내용은. 호스트 이름이 IETF 표준을 준수하지 않으면 오류가 리턴됩니다.
다이나믹 한 인게 이스트 지원 Google 드라이브는 동영상 파일에 대한 직접 링크를 생성하지 않으므로 Google 드라이브에 호스팅 된 파일을 가져올 수 있습니다.

S3에 대한 메모

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

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

소스 파일 이름

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

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

동영상 가져 오기

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

전화 CMS API 동영상 개체를 만들려면 Video Cloud 시스템과 그 id를 얻는다.
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 또는 업로드 모듈을 선택하면 오류가 발생합니다
권장 표준 수집 프로파일 (videocloud-default-v1, screencast-1280, 고해상도, 스마트-player-전환, 단일 비트 전송률 표준 및 단일 비트 전송률 최고)는 모두 마스터를 보관합니다. 사용자 지정 수집 프로필을 사용하는 경우 다음을 수행해야합니다. 마스터로 지정하십시오. 나중에 마스터에서 재전송 할 수있게하려면 아카이브해야합니다.
주인은이다 못 재 트랜스 코딩 중에 수정 됨
마스터 보관 및 배포 설정은 다음과 같습니다. 못 재 트랜스 코딩 중에 수정 됨
알려진 문제 : 동적 인 섭취를 사용하여 동영상을 다시 코딩하면 동영상의 활성화 날짜가 현재 날짜로 업데이트됩니다. 활성화 날짜순으로 주문한 스마트 재생 목록을 사용하면 재생 목록에있는 동영상의 순서가 영향을받습니다.

이미지

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

자막 캡션

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

DRM 및 HLSe

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

렌 디션 보관

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

알림

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

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