서문
비디오를 인제스트할 때 XML 매니페스트 파일을 사용하여 추가 메타데이터 (비디오 제목, 설명, 비행 시간, 레이블 및 사용자 정의 메타데이터 포함) 뿐만 아니라 축소판 및 폐쇄 자막 파일을 지정할 수 있습니다. FTP, Aspera 또는 MRSS로 콘텐츠를 인제스트할 때 XML 매니페스트 파일을 사용할 수 있습니다.
참고: 이 항목은 Ois v2.5에 적용됩니다.
메타데이터 처리
비디오를 인제스트할 때metadata
비디오에 포함시키면 다음 두 가지 방법 중 하나로 Video Cloud 비디오 필드에 매핑됩니다.
- 기본적으로각
metadata
키/값 쌍은 형식의태그로추가됩니다meta::key::value
. 예를<ooyala:metadata name="category">cooking</ooyala:metadata>
들어 는 태그를 생성합니다.meta::category::cooking
- 메타 데이터를 저장하는
custom_fields
데 를 사용하려는 경우 브라이트코브 지원 부서에서 계정 설정을 변경할 수 있습니다. 다음 사항에 유의하십시오.- 메타데이터 키에 해당하는 이름으로 사용자 정의 필드를 만들어야 합니다.
- 사용자 지정 필드의 수는 기본적으로 10개로 제한되므로 메타데이터를 수용하기 위해 이 필드 수가 더 많은 경우 지원 부서에 추가 사용자 지정 필드를 요청해야 합니다.
- 각 메타데이터 항목에 해당하는 사용자 지정 필드가 계정에 없으면 전체 메타데이터 작업이 실패합니다.
XML 매니페스트 요소
XML 매니페스트 파일에서 다음 요소를 사용할 수 있습니다.
XML 태그 | 설명 | 필수/선택 사항 |
---|---|---|
<channel> | 하나 이상의<item>요소를 포함합니다. | 필수 |
<item> | 인제스트할 단일 비디오를 나타냅니다. XML 매니페스트 파일에서 여러 비디오 ( <item>태그) 를 지정할 수 있습니다. 이 테이블의 나머지 태그를 포함합니다. | 필수 |
<media:content> | 인제스트할 비디오를 지정합니다. 다음 중 하나:
|
필수 (원격 자산 제외) |
<media:title> | 비디오의 이름 또는 제목입니다. | 선택 과목 |
<media:thumbnail> | 썸네일 (미리보기 이미지) 을 지정합니다. 다음 중 하나:
|
선택 과목 |
<media:subTitle> | 폐쇄 캡션 파일 (DFXP, WebVTT 및 SRT 파일에 대해 지원됨) 을 지정합니다. 닫힌 캡션 파일 수집을 참조하십시오. 속성:
참고: 지정된 경우lang및 에 유효한 값을 제공하는 것은 사용자의frameRate책임입니다. 유효한 값이 DFXP 파일에 추가됩니다. 비준수 값은 무시됩니다. 어느 쪽이든 닫힌 캡션 파일이 백로트에 추가되고 자산에 연결됩니다. |
선택 과목 |
<media:description> | 비디오에 대한 설명입니다. | 선택 과목 |
<link> | 비디오를 삽입하는 영구 URL입니다. 생성된 에셋의hosted_at속성에 매핑합니다. | 선택 과목 |
<dcterms:valid> | 애셋이 재생될 수 있는 시작 시간과 종료 시간을 나타내는 비행 시간입니다. 예:
<작업장:유효한 > 시작=2011-06-28일 15:15:00 - 07:00; 종료=2022-12시간: 오전 8시 - 오후 7시, 구성표 = </dcterms:유효 > |
선택 과목 |
<ooyala:labels> | 쉼표로 구분된 하나 이상의 레이블. 예: /sports,/sports/jogging 배경은레이블을 참고하십시오. | 선택 과목 |
<media:keywords> | 레이블을 정의하는 또 다른 방법 (슬래시 제외). 쉼표로 구분된 내용이 비디오에 태그로 추가됩니다. 동일한 이름의 태그가 존재하지 않는 경우에만 새 태그가 생성됩니다.
예를 들어, 다음<media:keywords>태그의 경우 레이블label1및label2가 생성되어 비디오에 태그로 추가됩니다. 이름이 지정된 레이블parentlabel또한 레이블과 함께 생성됩니다. childlabel그 안에 중첩됩니다. <미디어:키워드 > 레이블 1, 레이블 2, 상위 레이블/하위 < 레이블/미디어:키워드 > 참고: 내용<media:keywords>때 무시됩니다<ooyala:labels>태그는 XML 매니페스트 파일 또는 MRSS에 포함됩니다. |
선택 과목 |
<ooyala:embedcode> | 비디오 클라우드 비디오 ID입니다. | 선택 사항 (새 비디오를 추가하는 대신 비디오를 업데이트하는 경우 필수) |
<ooyala:profileguid> | 트랜스코딩 중에 마스터 비디오가 변환되어야 하는 형식을 정의하는 인코딩 그룹인 처리 프로필의 ID입니다. 자세한 내용은 Ooyala 지원 담당자에게 문의하십시오. | 선택 과목 |
<ooyala:metadata> | 비디오에 대한 사용자 정의 메타데이터입니다. 각 메타데이터 유형에 대해 요소를 가질 수 있습니다. 참조메타 데이터 처리방법에 대한 자세한 내용은 섹션metadata 비디오에 특수 태그로 추가됩니다. 예: <ooyala:metadata name="category">cooking</ooyala:metadata> |
선택 과목 |
<ooyala:remoteasset> | 인제스트할 원격 자산을 지정합니다. 원격 자산은 백롯이 아닌 다른 곳에서 호스팅되는 비디오입니다. 다음 속성을 지정합니다.
참고: 원격 자산이 생성된 후 다양한 CDN으로의 전파가 60초 이상 지연될 수 있습니다. 생성 후 너무 빨리 원격 자산을 요청하면 CDN에 의해 결과가 캐시되므로 지우는 데 몇 분 정도 걸릴 수 있습니다. 모범 사례: 생성 후 30초 또는 60초 동안 기다렸다가Backlot API [GET] /v2/assets/asset_id경로로 쿼리하고 원격 자산의 임베드 코드 (콘텐츠 ID 또는 자산 ID) 를 검색한 후 에셋 임베드로 진행합니다. |
필수 (원격 자산만 해당) |
<ooyala:profileguid> | 비디오 처리에 사용할 Video Cloud 인제스트 프로파일을 지정합니다. 계정 기본 프로필을 사용하지 않으려면 대신 사용할 프로필을 지정해야 합니다. 인제스트 프로파일 관리를참조하십시오. | 선택 과목 |
예
XML 매니페스트 파일 예제 (Ois v2.5)
<?xml version="1.0" encoding="utf-8"?> <RSS 버전="2.0"xmlns:미디어=” http://search.yahoo.com/mrss/” xmlns:dcterms=” http://purl.org/dc/terms/” xmlns:fh =” http://purl.org/syndication/history/1.0” xmlns:누야라 =” http://www.ooyala.com/mrss/ “> <채널 > <아이템 > <미디어:콘텐츠 > < URL="테스트.mp4"/미디어:콘텐츠 > <미디어:자막 href="내 캡션.dfxp > <”/미디어:자막 > <미디어:축소판 URL="마이_썸네일.jpg” 파일 > < 크기="35712"/미디어:축소판 > <미디어:제목 > 테스트 < XML/미디어:제목 > <미디어: 설명 > < 예/media:설명 > <ooyala: > 레이블/테스트, /예, /XML < /ooyala:레이블 > <작업장:유효한 > 시작=2016-01-1일 15:15:00 - 07:00; 끝=2022-01-0:00 - 07:00 < /시간: 유효합니다. > < >오얄라 <: 프로파일기드 > </항목 > </채널 > </rss>
단계별
XML 매니페스트 파일 만들기
XML 메타데이터 파일을 생성하려면 다음과 같이 하십시오.
- 동영상 및 기타 콘텐츠 (미리보기 이미지, 청각 장애인용 자막 파일 등) 를 업로드합니다.
- XML 유효성을 검사하는 텍스트 편집기를 엽니 다.
- 필요한 XML 헤더를 추가합니다. 예:
<?xml version="1.0" encoding="utf-8"?> <RSS 버전="2.0"xmlns:미디어=” http://search.yahoo.com/mrss/” xmlns:dcterms=” http://purl.org/dc/terms/” xmlns:fh =” http://purl.org/syndication/history/1.0” xmlns:누야라 =” http://www.ooyala.com/mrss/ “>
- channel컨테이너를 만듭니다.
- 위의 표에서 원하는 요소를 포함하는 각 비디오에 대한item항목을 만듭니다.
다음 예에서 XML은 두 비디오에 대한 메타데이터를 지정합니다. 첫 번째 비디오의 경우 파일과 미리보기 이미지가 업로드 서버에 있으며 해당 서버에서 가져옵니다. 두 번째 비디오의 경우 파일과 미리보기 이미지가 이미 Ooyala 서버에 업로드되었습니다. 두 번째 비디오에는 비행 시간도 있습니다.
<?xml version="1.0" encoding="utf-8"?> <RSS 버전="2.0"xmlns:미디어=” http://search.yahoo.com/mrss/” xmlns:dcterms=” http://purl.org/dc/terms/” xmlns:fh =” http://purl.org/syndication/history/1.0” xmlns:누야라 =” http://www.ooyala.com/mrss/ “> <채널 > <아이템 > <media:content url="http://mysite.com/upload/lacrosse_70.mov" /> <미디어:축소판 URL=” http://mysite.com/upload/lacrosse_70_previewimage.jpg “/> <미디어: 제목 정말 존재하는 > 스포츠: <라크로스/미디어:제목 > <미디어:설명 > 내 비디오에 대한 < 설명/미디어:설명 > < >ooyala:레이블/스포츠/라크로스, /취미/라크로스 < /ooyala:레이블 > <링크 > http://mysite.com/videos/sports/real_sports.html < /링크 > <오야라:메타데이터 이름="비디오_ID” > < 70/오야라:메타데이터 > <오야라:메타 데이터 이름="시즌_번호 > <”1/오야라:메타 데이터 > </항목 > <아이템 > <미디어:콘텐츠 URL = “컬링_71.mov”/ > <미디어:축소판 URL="컬링_71_미리보기.jpg”/ > <미디어: 제목 정말 존재하는 > 스포츠: <컬링/미디어:제목 > <미디어:설명 > 내 비디오에 대한 < 설명/미디어:설명 > < >ooyala:레이블/스포츠/컬링, < /취미/컬링/ooyala:레이블 > <링크 > http://mysite.com/videos/sports/real_sports.html < /링크 > <오야라:메타데이터 이름="비디오_ID” > < 71/오야라:메타데이터 > <오야라:메타 데이터 이름="시즌_번호 > <”1/오야라:메타 데이터 > <!— 비행 시간 설정 — > <작업장:유효한 > 시작=2011-06-28일 15:15:00 - 07:00; 종료=2022-12시간: 오전 8시 - 오후 7시, 구성표 = </dcterms:유효 > </항목 > </채널 > </rss>
- 파일을 XML로 저장합니다. 고유한 이름을 지정해야 합니다. 동일한 이름을 가진 두 파일을 지정하고 다른 파일을 처리하는 동안 하나를 업로드하면 두 번째 파일은 무시될 수 있습니다.
- 선택한 업로드 방법을 사용하여 비디오를 업로드할 때 XML 매니페스트 파일을 업로드합니다. 둘 중 하나를 참조하십시오 FTP또는 Aspera .