透過 MRSS 擷取的 XML 資訊清單

本主題說明 MRSS 擷取用來將視訊上傳至視訊雲端時所使用的 XML 結構。

清單標籤

攝取清單用於將視頻元數據添加到視頻。

注意事項：

  • 必須轉義所有特殊字符。
  • 標籤和標記必須用逗號分隔。

您可以在以下位置找到有關元數據字段的更多詳細信息CMS API 視頻字段參考請注意，整體清單應構建為 RSS 提要，視頻雲元數據包括為channelitem秒。換句話說，整體清單的結構應如下所示：

<rss xmlns:media="https://search.yahoo.com/mrss/" 
  xmlns:dcterms="https://purl.org/dc/terms/" 
  xmlns:fh="https://purl.org/syndication/history/1.0" 
  xmlns:brightcove="https://www.brightcove.com/mrss/" version="2.0">
  <channel>
    <item>
      <光明灣>

        <!-- 此處包含的項目是使用下面詳述的標籤構建的 -->

      <光明灣>
    </item>
  </channel>
</rss>

標籤參考

<item>
這item標籤是每個媒體項的包裝器，並包含brightcove標籤，它又包含所有 Brightcove 元數據標籤。
<brightcove>
這brightcove標籤是下面所有 Brightcove 元數據標籤的包裝器。
<profile> id/name </profile>
要使用的攝取配置文件的名稱或 ID。僅適用於視頻。如果省略，將使用該帳戶的默認配置文件。
<name></name>
視頻的標題。
<master url="string" useMaster="boolean"/>
對於重新轉碼請求。您可以指示應使用存儲的母版（useMaster="true" ), 或者為未存儲的母版提供 URL。如果您同時包括兩者url和useMaster，請求將失敗。

注意：

  • 通過攝取MRSS， 這url必須可公開訪問。
  • 通過攝取阿斯佩拉， 這url必須是文件在您上傳文件的 Aspera 服務器上的路徑。
<description long="string" short="string"/>
視頻的簡短描述。
<images> array of <image>
包含與視頻關聯的圖像集合 - 請參閱以下標籤。
<image url="string/required"
  language="string"
  variant="string/required"
  label="string"
  height="number"
  width="number"/>
圖像的詳細信息（有關更多詳細信息，請參閱 動態攝取字段參考 ）。簡要地：
  • language是來自的兩個字母的語言代碼語言子標籤註冊表 .
  • variant是poster | thumbnail | portrait | square | wide | ultra-wide .
  • height和width是像素值。
<texttracks> array of <texttrack>
包含與視頻關聯的文本軌道集合 - 請參閱以下標籤。
<texttrack 
  url="string/required" 
  srclang="string/required" 
  kind="string" 
  label="string" 
  default="boolean"/>
有關詳細信息，請參閱 動態攝取字段參考 。簡要地：
  • srclang - 文本軌道的 ISO 639 2 字母 (alpha-2) 語言代碼
  • kind - captions | subtitles | chapters | metadata
  • label - 用戶可讀標籤
  • default - 這些文本軌道是否是視頻的默認軌道
<audiotracks> array of <audiotrack>
包含與視頻關聯的音軌集合 - 請參閱以下標籤。
<audiotrack 
  url="string" 
  language="string" 
  variant="string"/>
有關詳細信息，請參閱 動態攝取字段參考 。簡要地： 
<customField name="string/required">value</customField>
這value將分配給具有此視頻給定名稱的自定義字段。 
<labels> separated by comma </labels>
請參閱 使用標籤。
<tags> separated by comma </tags>
標籤列表。標籤可用於選擇視頻智能播放列表， 除其他事項外。
<referenceId></referenceId>
視頻的唯一參考 ID。參考 ID 可用於將視頻與系統中的實體相關聯，您還可以使用參考 ID 而不是視頻 ID 發布視頻。
<videoId></videoId>
視頻編號。如果您攝取新視頻，請 不要 包含此內容。僅用於替換或重新轉碼或將媒體資產添加到現有視頻。
<schedule endsAt="" startsAt=""/>
用於安排視頻何時可以播放，以及（可選）何時再次變得不可用。ISO-8601 日期格式的時間，例如2022-09-20T20:41:07.689Z要不就2022-09-20 .
<link> value </link>
相關鏈接的 URL。

範例資訊清單

<rss xmlns:media="https://search.yahoo.com/mrss/" 
    xmlns:dcterms="https://purl.org/dc/terms/" 
    xmlns:fh="https://purl.org/syndication/history/1.0" 
    xmlns:brightcove="https://www.brightcove.com/mrss/" 
    版本=“2.0”>
    <channel>
      <item>
        <光明灣>
          <主 url="countdown_10.mp4"/>
          <profile>multi-platform-standard-dynamic-with-mp4</profile>
          <name>倒計時 10</name>
          <地位>積極的</地位>
          <description short="倒計時" long="倒計時視頻 #10" />
          <標籤></標籤>
          <標籤>樣品，倒計時</標籤>
          <參考編號>count_1 個</參考編號>
          <圖片>
            <圖片 url="Countdown10.png" variant="thumbnail" language="es" label="thumbnail" height="480" width="640"/>
          </圖片>
          <文本軌道>
            <texttrack url="WEBVTT-10.vtt" srclang="en-US" kind="captions" label="English"/>
          </文本軌道>
      </光明灣>
    </item>
  </channel>
</rss>