はじめに
ビデオを取り込むときは、XML マニフェストファイルを使用して、追加のメタデータ（動画のタイトル、説明、フライト時間、ラベル、カスタムメタデータを含む）、およびサムネイルファイルとクローズドキャプションファイルを指定できます。FTP、Aspera、または MRSS を使用してコンテンツを取り込む場合は、XML マニフェストファイルを使用できます。
注:このトピックは OIS v2.5 に適用されます。
メタデータの処理
metadata取り込み時にビデオに含めると、次の 2 つの方法のいずれかで Video Cloud ビデオフィールドにマッピングされます。
- デフォルトでは、
metadata各キー/値のペアは tag の形で:meta::key::value。たとえば、<ooyala:metadata name="category">cooking</ooyala:metadata>タグが生成されます。meta::category::cooking custom_fieldsメタデータの保存に使う場合は、ブライトコーブサポートがアカウントの設定を変更してそのようにすることができます。次の点に注意してください。- メタデータキーに対応する名前を持つカスタムフィールドを作成する必要があります。
- カスタムフィールドの数は既定で 10 に制限されています。そのため、メタデータを格納するためにそれ以上のカスタムフィールドが必要な場合は、サポートから追加のカスタムフィールドを要求する必要があります。
- 各メタデータ項目に対応するカスタム項目がアカウントに存在しない場合、メタデータ操作全体が失敗します。
XML マニフェスト要素
XML マニフェストファイルでは、次の要素を使用できます。
| XML タグ | 説明 | 必須/オプション |
|---|---|---|
| <チャンネル > | 1 つ以上を含む <アイテム > 要素。 | 必須 |
| <アイテム > | 取り込む単一のビデオを表します。複数の動画を指定できます（<アイテム > タグ）XMLマニフェストファイル内。このテーブルの残りのタグが含まれます。 | 必須 |
| <メディア：コンテンツ> | 取り込むビデオを指定します。次のいずれかの操作を行います。
|
必須（リモートアセットを除く） |
| <メディア：タイトル> | ビデオの名前またはタイトル。 | オプショナル |
| <メディア：サムネイル> | サムネイル (プレビューイメージ) を指定します。次のいずれかの操作を行います。
|
オプショナル |
| <メディア：subTitle> | クローズドキャプションファイルを指定します（DFXP、WebVTT、および SRT ファイルでサポートされます）。クローズドキャプションファイルの取り込みを参照してください。属性:
注:指定されている場合、有効な値を提供するのはあなたの責任です lang かつ フレームレート。有効な値は DFXP ファイルに追加されます。非準拠の値は無視されます。どちらの方法でも、クローズドキャプションファイルが Backlot に追加され、アセットにリンクされます。 |
オプショナル |
| <メディア：説明> | ビデオの説明。 | オプショナル |
| <リンク> | ビデオを埋め込む永続的な URL。作成されたアセットにマップします hosted_at 財産。 | オプショナル |
| <dcterms: 有効 > | アセットを再生できる開始時間と終了時間を表すフライト時間。例：
< dcterms: valid>start=2011-06-28T 15:15:00-07:00; end=2022-12-01T 16:00:00-07:00; scheme=w3c-dtf < /dcterms: valid > |
オプショナル |
| <ooyala：labels> | カンマで区切られた 1 つ以上のラベル。例： / sports、/ sports / jogging。背景については、「ラベル」を参照してください。 | オプショナル |
| <メディア：キーワード> | ラベルを定義する別の方法（スラッシュなし）。コンマで区切られたコンテンツは、動画にタグとして追加されます。新しいタグは、同じ名前のタグがまだ存在しない場合にのみ作成されます。
たとえば、次の場合 <メディア：キーワード> タグ、ラベル label1 かつ label2 作成され、タグとしてビデオに追加されます。名前の付いたラベル 親ラベル ラベル付きで作成されます チャイルドラベル その中にネストされています。 < メディア:キーワード > ラベル 1、ラベル 2、親ラベル/子ラベル < /メディア：キーワード > 注:の内容 <メディア：キーワード> が無視される場合 <ooyala：labels> タグは、XMLマニフェストファイルまたはMRSSに含まれています。 |
オプショナル |
| <ooyala：embedcode> | Video Cloud動画 ID。 | オプション（新しい動画を追加するのではなく、動画を更新する場合は必須） |
| <ooyala：profileguid> | 処理プロファイルの ID。トランスコーディング中にマスタービデオを変換する必要がある形式を定義するエンコードのグループです。詳細については、Ooyala サポート担当者にお問い合わせください。 | オプショナル |
| <ooyala：メタデータ> | ビデオのカスタムメタデータ。メタデータのタイプごとに 1 つの要素を持つことができます。を参照してくださいメタデータの処理方法の詳細についてはセクションmetadata特別なタグとして動画に追加されます。例: <ooyala:metadata name="category">cooking</ooyala:metadata> |
オプショナル |
| <ooyala：remoteasset> | 取り込むリモートアセットを指定します。リモートアセットとは、Backlot 以外の場所でホストされている動画です。次の属性を指定します。
注:リモートアセットが作成された後、さまざまな 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" エンコーディング=" utf-8"？> < rss version= "2.0" xmlns: media=」http://search.yahoo.com/mrss/ "xmlns: dcterms=」http://purl.org/dc/terms/ "xmlns: fh=」"xmlns: ooyala=」vech「> http://purl.org/syndication/history/1.0 http://www.ooyala.com/mrss/ < channel < > アイテム > < メディア:コンテンツ url=」test.mp4 "> < /メディア:コンテンツ > < メディア:subtitle href= "my_caption.dfxp" > < /media: subtitle > < media: サムネイル url=」my_thumbnail.jpg "filesize=" 35712"> < /media: サムネイル > < media: title >テスト XML < /メディア:タイトル > < メディア:説明>これは例である < /media: 説明 > < ooyala: labels >/test, /example, < /xml /ooyala: labels > < dcterms: valid>start=2016-01T 15:15:00-07:00; end=202-01-01T 16:00:00-07:00 < /dcterms: 有効 > < ooyala: profileguid >57d5a5a10f654fe79ef954ef954dc8d29a108 < /ooyala: profileguid > < /item > < /channel > < /rss >
ステップバイステップ
XML マニフェストファイルの作成
XMLメタデータ・ファイルを作成するには、次の手順に従います。
- 動画やその他のコンテンツ（サムネイル、クローズドキャプションファイルなど）をアップロードします。
- XML を検証するテキストエディタ (できれば) を開きます。
- 必要な XML ヘッダーを追加します。例は次のとおりです。
< ？xml version= "1.0" エンコーディング=" utf-8"？> < rss version= "2.0" xmlns: media=」http://search.yahoo.com/mrss/ "xmlns: dcterms=」http://purl.org/dc/terms/ "xmlns: fh=」"xmlns: ooyala=」vech「> http://purl.org/syndication/history/1.0 http://www.ooyala.com/mrss/
- を作成します チャネル 容器。
- を作成します アイテム 上記の表の必要な要素を含む、各ビデオのエントリ。
次の例では、XML は 2 つのビデオのメタデータを指定します。最初の動画では、ファイルとサムネイルはアップロードサーバー上に配置され、そのサーバーから取り出されます。2 番目のビデオでは、ファイルとサムネイルがすでに Ooyala サーバーにアップロードされています。2番目のビデオには飛行時間もあります。
< ？xml version= "1.0" エンコーディング=" utf-8"？> < rss version= "2.0" xmlns: media=」http://search.yahoo.com/mrss/ "xmlns: dcterms=」http://purl.org/dc/terms/ "xmlns: fh=」"xmlns: ooyala=」vech「> 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: サムネール url=」http://mysite.com/upload/lacrosse_70_previewimage.jpg "/> < メディア:title>本当に存在するスポーツ:ラクロス < /メディア:タイトル > < メディア:説明 >私のビデオの私の説明 < /メディア:説明 > < ooyala: ラベル >/スポーツ/ラクロス,/趣味/ラクロス < /ooyala: ラベル > < リンク > http://mysite.com/videos/sports/real_sports.html < /リンク > < ooyala: メタデータ名=」Video_ID ">70 < /ooyala: メタデータ > < ooyala: メタデータ名=" season_number" >1 < /ooyala: メタデータ > < /アイテム > < item> < media: content url=」curling_71.mov "/> < メディア:サムネイル url=」curling_71_previewimage.jpg "/> < メディア：タイトル>本当に存在するスポーツ： < カーリング/メディア:タイトル > < メディア:説明 >私のビデオの私の説明 < /メディア:説明 > < ooyala: ラベル >/スポーツ/カーリング,/趣味/カーリング < /ooyala: ラベル > < リンク> http://mysite.com/videos/sports/real_sports.html < /リンク > < ooyala: メタデータ名=」Video_id ">71 < /ooyala: メタデータ > < ooyala: メタデータ名=" season_number" >1 < /ooyala: メタデータ > < !— 飛行時間を設定する —> < dcterms: valid>start=2011-06-28T 15:15:00-07:00; end=2022-12-01T 16:00:00-07:00; scheme=w3c-dtf < /dcterms: valid > < /item > < /channel > < /rss >
- ファイルを XML として保存します。必ず一意の名前を指定してください。同じ名前のファイルを 2 つ指定し、もう一方のファイルを処理中にアップロードすると、2 番目のファイルは無視されることがあります。
- 選択したアップロード方法を使用して、ビデオのアップロード時にXMLマニフェストファイルをアップロードします。FTPまたは Aspera を参照してください。