고객 지원 문의
시스템 상태
서문
동영상 수집 시 CSV 매니페스트 파일을 사용하여 추가 메타데이터 (동영상 제목, 설명, 비행 시간, 레이블 및 사용자 지정 메타데이터 포함) 와 미리보기 이미지 및 폐쇄 자막 파일을 지정할 수 있습니다. FTP 또는 Aspera 콘텐츠를 인제스트할 때 CSV 매니페스트 파일을 사용할 수 있습니다.
제한 사항
참고: 이 항목은 Ois v2.5에 적용됩니다.
메타데이터 파일의 CSV 형식은 XML 형식보다 적은 기능을 지원합니다. CSV 형식을 사용하면 비디오와 연결할 썸네일 (미리 보기 이미지) 및 사용자 정의 메타데이터를 지정할 수 있습니다. XML 형식은 이러한 기능뿐만 아니라 기존의 광고 세트 정의 이름의 연결을 지원합니다.
메타데이터 처리
비디오를 인제스트할 때metadata비디오에 포함시키면 다음 두 가지 방법 중 하나로 Video Cloud 비디오 필드에 매핑됩니다.
- 기본적으로각
metadata키/값 쌍은 형식의태그로추가됩니다meta::key::value. 예를<ooyala:metadata name="category">cooking</ooyala:metadata>들어 는 태그를 생성합니다.meta::category::cooking - 메타 데이터를 저장하는
custom_fields데 를 사용하려는 경우 브라이트코브 지원 부서에서 계정 설정을 변경할 수 있습니다. 다음 사항에 유의하십시오.- 메타데이터 키에 해당하는 이름으로 사용자 정의 필드를 만들어야 합니다.
- 사용자 지정 필드의 수는 기본적으로 10개로 제한되므로 메타데이터를 수용하기 위해 이 필드 수가 더 많은 경우 지원 부서에 추가 사용자 지정 필드를 요청해야 합니다.
- 각 메타데이터 항목에 해당하는 사용자 지정 필드가 계정에 없으면 전체 메타데이터 작업이 실패합니다.
CSV 매니페스트 열 머리글
다음 필드는 CSV 파일의 첫 번째 줄 (열 머리글) 이며 실제 데이터 필드는 후속 행 (동영상당 한 행) 에 따라 옵니다.
참고: 이러한 열은 순서에 관계없이 지정할 수 있으며 데이터 행의 데이터가 머리글과 정확히 일치하는 경우 필요하지 않은 열을 생략할 수 있습니다.
| 열 머리글 | 설명 | 필수/선택 사항 |
|---|---|---|
| video | 비디오의 파일 이름 또는 비디오가 위치한 URL입니다. URL에는http://또는 이 포함될 수https://있습니다. | 필수 |
| title | 비디오의 이름 또는 제목입니다. | 선택 과목 |
| thumbnail | 썸네일의 파일 이름 또는 썸네일이 있는 URL입니다. | 선택 과목 |
| content_type | 콘텐츠 유형 (비디오 또는 원격 자산) video 열에 지정된 파일 이름이 비디오가있는 URL이고 원격 자산을 정의하려는 경우 content_type 열의 값을video , 기본값) content_type=remoteasset . | 필수 (원격 자산만 해당) |
| description | 비디오에 대한 설명입니다. | 선택 과목 |
| hosted_at | 비디오를 삽입하는 영구 URL입니다. 원격 자산에 대한hosted_at속성 값에 매핑됩니다.
참고: 원격 자산이 생성된 후 다양한 CDN으로의 전파가 60초 이상 지연될 수 있습니다. 생성 후 너무 빨리 원격 자산을 요청하면 CDN에 의해 결과가 캐시되므로 지우는 데 몇 분 정도 걸릴 수 있습니다. 모범 사례: 생성 후 30초 또는 60초 동안 기다렸다가Backlot API [GET] /v2/assets/asset_id경로로 쿼리하고 원격 자산의 임베드 코드 (콘텐츠 ID 또는 자산 ID) 를 검색한 후 에셋 임베드로 진행합니다. |
선택 과목 |
| flight_start_time | 에셋을 재생할 수 있는 시작 시간 (UTC) 입니다. 예: 2011-06-01T00:00:00Z | 필수 ( flight_end_time가 지정된 경우에만) |
| flight_end_time | 에셋을 재생할 수 있는 종료 시간 (UTC) 입니다. 예: 2011-07-01T00:00:00Z | 선택 과목 |
| durationInMs | (OS v2.5만 해당) 비디오의 길이를 나타내는 지속 시간 (밀리초 단위) 입니다. 필요한 경우content_type=remoteasset | 필수 (원격 자산에만 해당) |
| labels | 쉼표로 구분된 하나 이상의 레이블. 예를 들면 다음과 같습니다/sports,/sports/jogging . | 선택 과목 |
| metadata | 비디오에 대한 사용자 정의 메타데이터입니다. 각 메타데이터 유형에 대해 열을 가질 수 있습니다. 메타데이터가 Video Cloud 비디오 필드에 매핑되는 방식을 보려면 위의 메타데이터 처리섹션을 참조하십시오. | 선택 과목 |
| embed_code | (예약됨). 비디오 저작물의 백로트에 있는 콘텐츠 ID입니다. | 예약석 |
| id | 생성된 에셋의 외부 ID 속성, 즉 콘텐츠 ID 대신 사용할 수 있는 사용자 정의 식별자로 매핑됩니다. | 선택 과목 |
| subTitle | 닫힌 캡션 파일을 지정합니다 (DFXP 파일에만 지원됨). 다음 중 하나:
닫힌 캡션 파일 수집을 참조하십시오. |
선택 과목 |
| subTitle:lang | (선택 사항) - 폐쇄 캡션 파일의 언어입니다. 두 글자 언어 코드입니다./td > | 선택 과목 |
| subTitle:frameRate | (선택 사항) - 폐쇄 캡션 파일의 프레임 속도. 단위는 FPS (초당 프레임 수) 단위로 표시됩니다. 기본값은 30입니다. 이전 선택 캡션 파일은 24개일 수 있습니다. | 선택 과목 |
| profileguid | 트랜스코딩 중에 마스터 비디오가 변환되어야 하는 형식을 정의하는 인코딩 그룹인 처리 프로필의 ID입니다. 기본 Video Cloud 인제스트 프로파일을 사용하지 않으려면 사용하려는 프로파일의 ID를 포함해야 합니다. 인제스트 프로파일 관리를참조하십시오. | 선택 과목 |
CSV 매니페스트 파일의 예 (Ois v2.5)
video,title,description,labels,hosted_at,id,thumbnail,subTitle,flight_start_time,flight_end_time,profileguid
test.mp4,Test CSV,This is an example,"test,example,csv",http://www.ooyala.com,my_test_guid_csv,my_thumbnail.jpg,my_caption.dfxp,2016-01-01T15:15:00-07:00,2022-01-01T16:00:00-07:00,57d5a5a10f654fe79ef954dc8d29a108
CSV 매니페스트 파일 만들기
CSV 메타데이터 파일을 생성할 때는 다음 사항에 유의하십시오.
- 데이터 필드의 텍스트 값에 쉼표 (,) 가 있으면 필드를 큰따옴표 (“) 로 묶어야 합니다.
- 데이터 필드의 텍스트 값에 큰 따옴표 (“) 가있는 경우 필드를 큰 따옴표로 묶고 텍스트 필드의 큰 따옴표 문자를 두 번째 따옴표로 이스케이프해야합니다 (예: “그녀는 말했다 “" 좋은 하루 보내십시오.””””)
Excel에서 CSV 메타데이터 파일을 만드는 경우 자동으로 이스케이프를 처리합니다.
CSV 메타데이터 파일을 생성하려면 다음과 같이 하십시오.