지원 고객 지원 문의 | 시스템 상태 시스템 상태
페이지 내용

    Ooyala-비디오 클라우드 수집 어댑터: XML 매니페스트 파일

    XML 매니페스트와 함께 FTP, Aspera 또는 MRSS를 계속 사용하여 비디오를 Video Cloud에 인제스트할 수 있습니다. 이 항목에서는 XML의 구조에 대해 설명합니다.

    서문

    비디오를 인제스트할 때 XML 매니페스트 파일을 사용하여 추가 메타데이터 (비디오 제목, 설명, 비행 시간, 레이블 및 사용자 정의 메타데이터 포함) 뿐만 아니라 축소판 및 폐쇄 자막 파일을 지정할 수 있습니다. FTP, Aspera 또는 MRSS로 콘텐츠를 인제스트할 때 XML 매니페스트 파일을 사용할 수 있습니다.

    참고: 이 항목은 Ois v2.5에 적용됩니다.

    메타데이터 처리

    비디오를 인제스트할 때metadata비디오에 포함시키면 다음 두 가지 방법 중 하나로 Video Cloud 비디오 필드에 매핑됩니다.

    1. 기본적으로metadata키/값 쌍은 형식의태그로추가됩니다meta::key::value . 예를<ooyala:metadata name="category">cooking</ooyala:metadata>들어 는 태그를 생성합니다. meta::category::cooking
    2. 메타 데이터를 저장하는custom_fields데 를 사용하려는 경우 브라이트코브 지원 부서에서 계정 설정을 변경할 수 있습니다. 다음 사항에 유의하십시오.
      • 메타데이터 키에 해당하는 이름으로 사용자 정의 필드를 만들어야 합니다.
      • 사용자 지정 필드의 수는 기본적으로 10개로 제한되므로 메타데이터를 수용하기 위해 이 필드 수가 더 많은 경우 지원 부서에 추가 사용자 지정 필드를 요청해야 합니다.
      • 각 메타데이터 항목에 해당하는 사용자 지정 필드가 계정에 없으면 전체 메타데이터 작업이 실패합니다.

    XML 매니페스트 요소

    XML 매니페스트 파일에서 다음 요소를 사용할 수 있습니다.

    XML 매니페스트 요소
    XML 태그 설명 필수/선택 사항
    <channel> 하나 이상의<item>요소를 포함합니다. 필수
    <item> 인제스트할 단일 비디오를 나타냅니다. XML 매니페스트 파일에서 여러 비디오 ( <item>태그) 를 지정할 수 있습니다. 이 테이블의 나머지 태그를 포함합니다. 필수
    <media:content> 인제스트할 비디오를 지정합니다. 다음 중 하나:
    • 업로드한 동영상의 파일 이름입니다.
    • MRSS를 통한 수집 ( 원격으로 호스팅된 MRSS 피드에서수집 참조), 비디오가 있는 URL입니다. URL에는http://또는 이 포함될 수https://있습니다.
    원격 에셋의 경우<ooyala:remoteasset>대신 를 사용합니다.
    필수 (원격 자산 제외)
    <media:title> 비디오의 이름 또는 제목입니다. 선택 과목
    <media:thumbnail> 썸네일 (미리보기 이미지) 을 지정합니다. 다음 중 하나:
    • 업로드한 썸네일의 파일 이름입니다.
    • 썸네일이 있는 URL입니다. URL에는http://또는 이 포함될 수https://있습니다.
    선택 과목
    <media:subTitle> 폐쇄 캡션 파일 (DFXP, WebVTT 및 SRT 파일에 대해 지원됨) 을 지정합니다. 닫힌 캡션 파일 수집을 참조하십시오. 속성:
    • href ( 필수) - 다음 중 하나:
      • 업로드한 폐쇄 캡션 파일의 파일 이름입니다. 예: caption-1.dfxp
      • 폐쇄 캡션 파일이 있는 URL입니다. URL에는http://또는 이 포함될 수https://있습니다.
      lang ( 선택 사항) - 폐쇄 캡션 파일의 언어입니다. 두 글자 코드입니다. 지원되는 폐쇄 캡션을참조하십시오.
    • frameRate ( 선택 사항) - 폐쇄 캡션 파일의 프레임 속도. 단위는 FPS (초당 프레임 수) 단위로 표시됩니다. 기본값은 30입니다. 이전 선택 캡션 파일은 24개일 수 있습니다.
    참고: 지정된 경우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>태그의 경우 레이블label1label2가 생성되어 비디오에 태그로 추가됩니다. 이름이 지정된 레이블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> 인제스트할 원격 자산을 지정합니다. 원격 자산은 백롯이 아닌 다른 곳에서 호스팅되는 비디오입니다. 다음 속성을 지정합니다.
    • durationInMs : 미디어 지속 시간 (밀리초)
    • url : 원격 자산의 URL입니다. URL에는http://또는 이 포함될 수https://있습니다.
    이 설정은 원격 자산에 대한hosted_at속성 값에 매핑됩니다. 예: <ooyala:remoteasset durationInMs='5000' url="http://your_website/your_remote_assets.mp4" />
    참고: 원격 자산이 생성된 후 다양한 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 메타데이터 파일을 생성하려면 다음과 같이 하십시오.

    1. 동영상 및 기타 콘텐츠 (미리보기 이미지, 청각 장애인용 자막 파일 등) 를 업로드합니다.
    2. XML 유효성을 검사하는 텍스트 편집기를 엽니 다.
    3. 필요한 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/ “>
    4. channel컨테이너를 만듭니다.
    5. 위의 표에서 원하는 요소를 포함하는 각 비디오에 대한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>    
    6. 파일을 XML로 저장합니다. 고유한 이름을 지정해야 합니다. 동일한 이름을 가진 두 파일을 지정하고 다른 파일을 처리하는 동안 하나를 업로드하면 두 번째 파일은 무시될 수 있습니다.
    7. 선택한 업로드 방법을 사용하여 비디오를 업로드할 때 XML 매니페스트 파일을 업로드합니다. 둘 중 하나를 참조하십시오 FTP또는 Aspera .