API 기능
Brightcove의 DI(Dynamic Ingest) API는 비디오 소스 파일이 고객의 저장 위치에서 다운로드되고 소스 파일의 지정된 변환이 생성되는 기능을 기반으로 합니다. (옵션도 있습니다. 소스 파일 업로드 Dynamic Ingest가 액세스할 수 있는 임시 위치로 이동합니다.) 이 플랫폼은 클라우드 중심이고 전 세계에 분산되어 있으며 동급 최고의 일관성과 속도를 제공하기 위해 최신 방식을 기반으로 합니다.
워크플로 개요
미디어의 전체 트랜스코딩 및 저장에 여러 시스템/기술이 사용됩니다. 그들은:
- 콘텐츠 관리 시스템(CMS) API : DI API에서 사용할 비디오 개체를 만듭니다.
- 젠코더 : 비디오를 트랜스코딩하여 여러 버전을 생성합니다.
- 아마존 S3 : 프로필 설정에 따라 마스터 및 변환을 저장소로 이동합니다.
- 목록 : 비디오와 관련된 필수 정보를 저장합니다.
초기 트랜스코딩 후 미디어에서 수행할 수 있는 작업은 다음과 같습니다.
- 다시 코드 변환 : 마스터가 있을 때 새 변환 만들기(마스터가 없으면 오류)
- 바꾸다 : 새 마스터를 가리키거나 기존 마스터를 교체합니다.
운영
DI API를 사용하면 수집 프로필 읽기 및 계정에 수집 정보 쓰기와 같은 다양한 작업을 수행하게 됩니다. 다음은 DI 작업에 필요한 작업의 전체 목록입니다.
- 비디오 클라우드/비디오/만들기
- 비디오 클라우드/비디오/읽기
- 비디오 클라우드/비디오/업데이트
- video-cloud/ingest-profiles/profile/읽기
- video-cloud/ingest-profiles/account/read
- video-cloud/ingest-profiles/account/write
- video-cloud/ingest-profiles/profile/write
- 비디오 클라우드/업로드 URL/읽기
클라이언트 자격 증명을 얻으려면 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 쿼리에서 발견된 모든 예약 문자는 백분율로 인코딩됩니다(공백은+또는%20 , 그리고+인코딩 중%2B ).
NS 사전 서명 S3( v2포함 서명, 만료 그리고 AWSAccessKeyId, 그리고 v4포함 X-Amz-알고리즘, X-Amz-자격 증명, X-Amz-Date, X-Amz-만료, X-Amz-SignedHeaders, 그리고 X-Amz-시그니처) 또는 GCS (포함 서명, 만료, 그리고 Google 액세스 ID) URL은 이미 올바르게 인코딩되어 있어야 하며그대로 사용할 수 있습니다 .
비디오 수집
동영상 수집에는 두 가지 API 호출이 필요합니다.
- 를 불러 CMS API Video Cloud 시스템에서 비디오 개체를 만들고 ID를 얻으려면
- DI API를 호출하여 비디오 소스 파일의 URL을 제공하고인제스트 프로필사용될
기본 요청의 샘플 세트는 다음과 같습니다.
CMS API 요청
- HTTP 메소드
- 우편
- 요청 URL
- https://cms.api.brightcove.com/v1/accounts/ {account_id} /동영상
- 요청 본문
-
{ "name": "My new video" }
응답 데이터에는 비디오가 포함됩니다. id , 다음 요청에서 사용됩니다.
API 요청 수집
- HTTP 메소드
- 우편
- 요청 URL
- https://ingest.api.brightcove.com/v1/accounts/ {account_id} /동영상/ {video_id} /ingest-요청
- 요청 본문
-
{ "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 .
캡션 수집
또한 WebVTT 캡션을 비디오에 추가하거나 Dynamic Ingest를 사용하여 기존 비디오용으로 업로드할 수 있습니다. 자세한 내용은 WebVTT 파일 수집 .
DRM 및 HLSe
Dynamic Ingest는 Brightcove에서 지원하는 DRM 유형을 사용하는 비디오를 처리합니다. HLSe도 지원됩니다.
변환 보관
기본적으로 모든 비디오 및 이미지 변환은 자동으로 보관됩니다. 변환 보관을 끄려면 Brightcove 지원에 문의 . 참고디지털 마스터수집 프로필에 지정된 경우 보관됩니다.
알림
수집 프로세스 결과 알림을 수신하기 위해 하나 이상의 콜백 URL을 지정할 수 있습니다. 지정하는 URL은 POST 요청을 수락할 수 있는 앱용이어야 합니다. 알림은 JSON 형식으로 전송됩니다.
알림 수신 및 해석에 대한 자세한 내용은 다음에서 확인할 수 있습니다. 알림: 동적 수집 및 CMS API