清單/元數據參考

本主題提供元數據清單的詳細信息,可以選擇將其包含在通過 Aspera 提取到視頻雲的視頻和資產中。請注意,每個清單文件最多只能包含 100 個視頻。

清單標籤

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

注意事項:

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

您可以在 CMS API 視訊欄位參考資料中找到中繼資料欄位的其他詳細資訊請注意,整體資訊清單應建構為 RSS 摘要,Video Cloud 中繼資料包含為channelitem s。換句話說,整體清單的結構應如下所示:

<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。如果同時包含urluseMaster,請求將失敗。

注意:

  • 若要透過 MRSS 擷取url必須可公開存取。
  • 若要透過 Aspera 擷取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是來自語言子標籤登錄的兩個字母的語言代碼
  • variantposter | thumbnail | portrait | square | wide | ultra-wide
  • heightwidth像素值。
<texttracks> array of <texttrack>
包含與視頻關聯的文本軌道集合 - 請參閱以下標籤。
<texttrack 
  url="string/required" 
  srclang="string/required" 
  kind="string" 
  label="string" 
  default="boolean"/>
有關詳細信息,請參閱 動態攝取字段參考 。簡要地:
  • srclang -用於文本軌道的 ISO 639 2 個字母(字母 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"/>
          <輪廓>多平台標準動態與 mp4< /輪廓>
          <姓名>倒計時10< /姓名>
          <地位>積極的</地位>
          <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>