고객 지원 문의
시스템 상태
이 항목에서는Backlot API을 사용하여 Video Cloud에 콘텐츠를 인제스트하는 방법을 다룹니다.
서문
Backlot API를 사용하여 프로그래밍 방식으로 콘텐츠를 Video Cloud에 업로드합니다. 이러한 접근 방식을 통해 콘텐츠 관리 시스템 (CMS) 또는 워크플로우를 Video Cloud 플랫폼과 직접 통합할 수 있습니다.
를 사용하여 비디오, 축소판 및 폐쇄 자막 파일을 프로그래밍 방식으로 업로드하고 관리할 수 있습니다. Backlot API
백로트 API를 사용하여 콘텐츠를 인제스트하려면 다음을 참조하십시오.
- 비디오 및 오디오 에셋 (비디오 및 미리보기 이미지용)
- 폐쇄 캡션 작업
파일 (“자산”이라고 함) 을 업로드하는 데 사용되는 기본 호출은/v2/assets경로입니다.
참고: null이있는 동영상을 추가하지 마세요. external_id , 즉external_id값 없음 ( "" ) 또는 값"null" . 이러한 null 외부 ID는 나중에 검색 할 수 없습니다.
비디오 및 오디오 에셋
Ooyala에비디오를 업로드하면Ooyala는계정에 지정된 설정을 사용하여 자동으로 코드 변환하고 플레이어를 통해 비디오를 재생할 수 있습니다.
H.264에서Ooyala에비디오를 업로드하는 것이 좋지만 일반적으로 사용되는 코덱도 많이 지원합니다.
- 기본 속성을 사용하여 자산 만들기
- 시스템에서 “업로드 URL” 검색
- 각 “업로드 URL”에 대해 적절한 파일 청크를 시스템에 넣으십시오.
참고: 각 청크를 업로드할 때는 다른 요청과 마찬가지로 요청에 서명하지 마십시오 . 청크 내용을 정확한 URL에 넣기 만하면됩니다. 이러한 URL은 이미 서명되어 있습니다.
새로 생성 된 자산에 대한 업로드 URL 가져 오기
[GET] /v2/자산/ {자산 ID} /업로드_URL
업로드 상태 설정
[PUT] /v2/자산/ {자산 ID} /업로드 상태
{
“상태”: “업로드됨”
}
비디오의 스트림 보기
이 컨텍스트에서스트림이라는용어는 비디오를 트랜스코딩하기 위해 시스템에서 시작하는 Internal-to-OoyAla 프로세스를 의미합니다.
[GET] /v2/자산/ {자산_id} /스트림
비디오의 소스 파일 보기
[GET] /v2/자산/ {자산 ID} /소스 파일 정보
자동 생성된 미리 보기 이미지의 URL 가져오기
[GET] /v2/자산/ {자산 ID} /생성된미리 보기_이미지
사용자 정의 미리 보기 이미지 업로드
[POST] /v2/자산/ {자산 ID} /미리보기_이미지 파일
<파일 컨텐츠 >
1차 미리 보기 이미지 구성 설정
- generated : 자동 생성된 미리 보기 이미지 사용
- uploaded_file : 업로드된 사용자 정의 미리 보기 이미지 사용
- remote_url : 미리 보기 이미지의 URL
[PUT] /v2/자산/ {자산 ID} /기본 미리 보기 이미지
{
“유형”: “생성됨” | “파일 업로드” | “원격 URL”
}
메타데이터 정보
에셋은 사용자 정의 메타데이터의 이름/값 쌍을 최대 100개까지 포함할 수 있습니다. 이름은 128자로 제한되며 값은 2,048자로 제한됩니다.
예
이 예제에서는 비디오를 만듭니다.
[POST] /v2/자산 {
“이름”: “꿀 오소리”,
“파일 이름”: “허니배저.avi”,
“자산 유형”: “비디오”,
“파일 크기”: 398422,
“청크 사이즈”: 100000
}
Video Cloud는다음과 유사한 응답을 반환합니다.
{
“이름”: “꿀 오소리”,
“미리보기 이미지 URL”: 널,
“자산 유형”: “비디오”,
“지속 시간”:0,
“임베디드 코드”: {임베디드 코드},
“생성:”2011-10-26T 19:40:32 + 00:00 “,
“시간 제한”:null,
“업데이트 됨”: “2011-10-26T 19:40:32 + 00:00”,
“외부 ID”: 널,
“호스트”: 널,
“원래_파일 이름”: “허니배저.avi”,
“설명”:널,
“상태”: “업로드”
}
이 예에서는 업로드 URL을 반환합니다.
[GET] /v2/자산/ {자산 ID} /업로드_URL
Video Cloud는다음과 유사한 응답을 반환합니다.
[” https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000000000-0000000099999&filesize=100000&expires=1314391791&signature=Jliypj/Q0c5dVu4tDFUDIjIngyDu/LGng+rCG3KNSF4 “,
“https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000100000-0000000199999&filesize=100000&expires=1314391791&signature=qOjdkomEUO7mgWDjqu9z01QrI39sxa9W0zzRXDhOR9Y “,
“https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000200000-0000000299999&filesize=100000&expires=1314391791&signature=+bT8Jft9kvVdkYMND87BSs/VWu1r2imCNkl9v2++eTU “,
“https://uploader-v2.ooyala.com/send?filename=EwZ2RyMjrulwSBrJMpFd7xQ6FoftMnaA/0000000300000-0000000398421&filesize=98422&expires=1314391791&signature=cObAITdnMHeT6/wuNCAjYABgxqdlfPaLeATOmsKxmdg”]
다음 예에서는 비디오를 업로드된 것으로 표시하여Video Cloud에파일 처리를 시작하도록 지시합니다.
[PUT] /v2/자산/ {자산 ID} /업로드 상태
{
“상태”: “업로드됨”
}
Video Cloud는다음과 유사한 응답을 반환합니다.
{
“상태”: “업로드됨”
}
[GET] /v2/자산/ {자산 ID} /소스 파일 정보
Video Cloud는다음과 유사한 응답을 반환합니다.
{
“원래 파일 이름”: lakeside.wmv,
“소스 파일 URL”: {소스 URL}”
“파일 크기”: 25227886
}
폐쇄 캡션 작업
Backlot API를 통해 동영상이나 원격 저작물 동영상에 자막을 추가할 수 있습니다.
지원되는 캡션 형식
| 파일 확장자 | 설명 |
|---|---|
| .vtt ( WebVTT/) - this is the format required for HTML5 video players | WebVTT는 HLS 및 DASH와 같은 HTTP 스트리밍 형식의 임베디드 및 사이드카 캡션에 모두 사용할 수 있습니다. |
| .TTML ( 이전DXFP ) - WebVTT로 변환됩니다. | TTML (시간 제한 텍스트 마크업 언어 파일. 일반적으로 이 유형의 폐쇄 캡션 파일의 확장자는.dfxp (배포 형식 교환 프로필) 입니다. |
청각 장애인용 자막 업로드
[PUT] /v2/자산/ {자산 ID} /닫힘 캡션/ {dfxp_파일_컨텐트}
청각 장애인용 자막 가져오기
[GET] /v2/자산/ {자산 ID} /폐쇄 캡션
청각 장애인용 자막 업데이트
[PUT] /v2/자산/ {자산 ID} /폐쇄 캡션
폐쇄 캡션 삭제
[삭제] /v2/자산/ {자산 ID} /닫힌 캡션