Oooyal-視頻雲端攝取適配器:XML 資訊清單檔案

簡介

擷取影片時，您可以使用 XML 資訊清單檔案來指定額外的中繼資料 (包括影片標題、說明、飛行時間、標籤和自訂中繼資料)，以及縮圖和隱藏式字幕檔案。通過FTP，Aspera或MRSS提取內容時，可以使用XML清單文件。

注意：本主題適用於 OIS v2.5。

中繼資料的處理

如果您在內嵌視訊時加入影片，則會以下列兩種方式之一對應至 Video Cloud 視訊欄位：metadata

默認情況下，每個metadata鍵/值對被添加為標籤的形式：meta::key::value。例如，<ooyala:metadata name="category">cooking</ooyala:metadata>會產生標籤meta::category::cooking
如果您寧願使用custom_fields儲存中繼資料，Brightcove 支援可以變更您帳戶上的設定來執行此動作。請注意下列事項：
- 您將需要建立自訂欄位，其名稱對應於您的中繼資料金鑰。
- 根據預設，自訂欄位的數量限制為 10 個，因此如果您需要更多的時間來容納您的中繼資料，您將需要向支援請求額外的自訂欄位。
- 如果您的帳戶中不存在與每個中繼資料項目對應的自訂欄位，則整個中繼資料作業將會失敗。

XML 資訊清單元素

您可以在 XML 資訊清單檔案中使用下列元素。

XML 資訊清單元素
XML 標籤	描述	必要/選擇性
`<channel>`	包含一個或多個`<item>`元素。	必需的
`<item>`	代表要內嵌的單一視訊。您可以指定多個視頻（`<item>`標籤）。包含此表格中的剩餘標籤。	必需的
`<media:content>`	指定要提取的視頻。下列其中一項：您上傳的視頻的文件名。通過MRSS進行攝取（請參見從遠程託管的MRSS Feed提取），即視頻所在的網址。URL 可以包含`http://`或`https://`。對於遠程資產，請使用`<ooyala:remoteasset>`代替。	必要 (遠端資產除外)
`<media:title>`	影片的名稱或標題。	可選的
`<media:thumbnail>`	指定縮圖 (預覽影像)。下列其中一項：您上傳的縮略圖的文件名。縮圖所在的網址。URL 可以包含`http://`或`https://`。	可選的
`<media:subTitle>`	指定隱藏式字幕檔案 (DFXP、WebVTT 和 SRT 檔案支援)。看到攝取隱藏式字幕文件。屬性： `href`（必需）-以下之一：您上傳的隱藏式字幕檔案的檔案名稱。範例：`caption-1.dfxp` 隱藏式字幕檔案所在的網址。URL 可以包含`http://`或`https://`。 `lang`（可選）-隱藏字幕文件的語言。兩個字母的代碼。看到支持的隱藏式字幕。 `frameRate`（可選）-隱藏字幕文件的幀頻。單位是以每秒影格數 (FPS) 為單位。預設值為 30。較舊的隱藏式字幕檔案可能是 24 個。注意：如果指定，則有責任為您提供有效的值`lang`和`frameRate`。有效值將添加到DFXP文件中。不符合的值將被忽略。無論哪種方式，隱藏式字幕文件都被添加到Backlot中並鏈接到資產。	可選的
`<media:description>`	影片說明。	可選的
`<link>`	嵌入視訊的永久 URL。映射到創建的資產的`hosted_at`屬性。	可選的
`<dcterms:valid>`	飛行時間代表可以播放資產的開始和結束時間。範例： <dcterms:valid>start=2011-06-28T15:15:00-07:00; 結束時間:下午 6 時 </dcterms:valid>	可選的
`<ooyala:labels>`	一個或多個標籤，用逗號分隔。例：`/sports,/sports/jogging`。有關背景，請參見標籤。	可選的
`<media:keywords>`	定義標籤的另一種方式（不帶正斜杠）。以逗號分隔的內容將作為標籤添加到視頻中。僅當不存在具有相同名稱的標籤時，才會創建新標籤。例如，對於以下`<media:keywords>`標籤，標籤`label1`和`label2`將被創建並作為標籤添加到視頻中。標籤名為`parentlabel`也將創建帶有標籤的`childlabel`嵌套在裡面。 <media：keywords> label1，label2， parentlabel / childlabel </ media：keywords> 注意：內容`<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>`	指定要內嵌的遠端資產。遠程資產是託管在Backlot之外的其他地方的視頻。指定下列屬性： `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>`	指定要用於處理視訊的視訊雲端內嵌描述檔。如果您不想使用帳戶預設設定檔，則必須指定您想要使用的設定檔。請參閱管理嵌入設定檔。	可選的

範例

示例XML清單文件（OIS v2.5）

  <?xml version="1.0" encoding="utf-8"?>
  <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/"
    簡介:數位字元 =」http://purl.org/dc/terms/」
    安裝:fh =」http://purl.org/syndication/history/1.0」
    密碼:烏亞拉 =」http://www.ooyala.com/mrss/ ">
    <channel>
      <item>
        <media:content url="test.mp4" ></media:content>
        <media:subTitle href="my_caption.dfxp"></media:subTitle>
        <media:thumbnail url="my_thumbnail.jpg" filesize="35712"></media:thumbnail>
        <媒體:標題 > 測試 XML </媒體:標題 >
        <媒體：描述 > 這是一個示例 </媒體：描述 >
        <ooyala:labels>/test,/example,/xml</ooyala:labels>
        <dcterms:valid>start=2016-01-01T15:15:00-07:00;
          end=2022-01-01T16:00:00-07:00</dcterms:valid>
        <ooyala:profileguid>57d5a5a10f654fe79ef954dc8d29a108</ooyala:profileguid>
      </item>
    </channel>
  </rss>

逐步

創建一個XML清單文件

要創建XML元數據文件：

上載您的視頻和其他內容（縮略圖，隱藏式字幕文件等）。
開啟文字編輯器，最好是驗證 XML 的編輯器。

新增必要的 XML 標頭。例如：

  <?xml version="1.0" encoding="utf-8"?>
  <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/"
       簡介:數位字元 =」http://purl.org/dc/terms/」
       安裝:fh =」http://purl.org/syndication/history/1.0」
       密碼:烏亞拉 =」http://www.ooyala.com/mrss/ ">

創建一個channel容器。

創建一個item每個視頻的條目，其中包含上表中的所需元素。

在下列範例中，XML 會指定兩個視訊的中繼資料。對於第一個視訊，檔案和縮圖位於上傳伺服器上，並從該伺服器提取。對於第二個視頻，文件和縮略圖已經上傳到 Oooyala 服務器。第二個視頻也有飛行時間。

  <?xml version="1.0" encoding="utf-8"?>
  <rss version="2.0" xmlns:media="http://search.yahoo.com/mrss/"
       簡介:數位字元 =」http://purl.org/dc/terms/」
       安裝:fh =」http://purl.org/syndication/history/1.0」
       密碼:烏亞拉 =」http://www.ooyala.com/mrss/ ">
  
       <channel>
             <item>
              <media:content url="http://mysite.com/upload/lacrosse_70.mov" />
              <media:thumbnail url="http://mysite.com/upload/lacrosse_70_previewimage.jpg" />
              <媒體：標題 > 運動，真正存在：長曲棍球 </媒體:標題 >
              <media:description>My description of my video</media:description>
              <ooyala:labels>/sports/lacrosse,/hobbies/lacrosse</ooyala:labels>
              <link>http://mysite.com/videos/sports/real_sports.html</link>
              <ooyala:metadata name="video_ID">70</ooyala:metadata>
              <ooyala:metadata name="season_number">1</ooyala:metadata>
             </item>
  
             <item>
              <media:content url="curling_71.mov" />
              <media:thumbnail url="curling_71_previewimage.jpg" />
              <媒體：標題 > 運動，真正存在：捲曲 </媒體:標題 >
              <media:description>My description of my video</media:description>
              <ooyala:labels>/sports/curling,/hobbies/curling</ooyala:labels>
              <link>http://mysite.com/videos/sports/real_sports.html</link>
              <ooyala:metadata name="video_ID">71</ooyala:metadata>
              <ooyala:metadata name="season_number">1</ooyala:metadata>
              <!-- set flight times -->
              <dcterms:valid>start=2011-06-28T15:15:00-07:00;
                  結束時間:下午 6 時
                  </dcterms:valid>
  
             </item>
       </channel>
  </rss>

將文件另存為XML。請務必指定唯一的名稱。如果您指定兩個具有相同名稱的文件並在另一個文件正在處理時上傳一個，則第二個文件可能會被忽略。
使用您選擇的上載方法，在上載視頻時上載XML清單文件。見的FTP要么阿斯佩拉。

頁面內容

Oooyal-視頻雲端攝取適配器:XML 資訊清單檔案

簡介

中繼資料的處理

XML 資訊清單元素

範例

逐步