マニフェスト タグ
取り込みマニフェストは、動画に動画メタデータを追加するために使用されます。
注:
- すべての特殊文字はエスケープする必要があります。
- ラベルとタグはコンマで区切る必要があります。
メタデータ フィールドの詳細については、CMS API 動画フィールド リファレンス を参照してください。マニフェスト全体は RSS フィードとして構築する必要があり、Video Cloud メタデータは チャンネル
として含まれることに注意してください。 item
です。つまり、マニフェスト全体は次のように構成する必要があります:
<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>
<brightcove>
<!-- ここに含まれる項目は、以下に詳述するタグを使用して構築されます -->
<brightcove>
</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
は公開されている必要があります。 - Aspera 経由で取り込む場合、
url
は、アップロードした Aspera サーバー上のファイルへのパスである必要があります。
- MRSS 経由で取り込む場合、
-
<description long="string" short="string"/>
- 動画の短い説明。
-
<images> <image> の配列
- ビデオに関連付けられた画像のコレクションが含まれます。次のタグを参照してください。
-
<image url="string/required" language="string" variant="string/required" label="string" height="number" width="number"/>
-
画像の詳細 (詳細については、Dynamic Ingest Fields Reference を参照してください)。簡単に説明すると、
language
は、Language Subtag Registry の 2 文字の言語コードです。variant
は、poster | thumbnail | Portrait | square | wide | ultra-wide
です。height
とwidth
はピクセル値です。
<texttracks> <texttrack> の配列
- ビデオに関連付けられたテキスト トラックのコレクションが含まれます。次のタグを参照してください。
-
<texttrack url="string/required" srclang="string/required" kind="string" label="string" default="boolean"/>
-
詳細については、Dynamic Ingest Fields Reference を参照してください。簡単に言うと:
srclang
- テキスト トラックの ISO 639 2 文字 (アルファ 2) 言語コードkind
-キャプション | 字幕 | チャプター | メタデータ
label
- ユーザーが判読できるラベルdefault
- これらのテキスト トラックがビデオのデフォルトかどうか
<audiotracks> <audiotrack> の配列
- ビデオに関連付けられたオーディオ トラックのコレクションが含まれます - 次のタグを参照してください。
-
<audiotrack url="string" language="string" variant="string"/>
-
詳細については、Dynamic Ingest Fields Reference を参照してください。簡単に説明すると、
language
- ISO 639-2 3 文字言語コードvariant
-main | alternate | commentary | dub |説明的
-
<customField name="string/required">value</customField>
-
value
は、このビデオの指定された名前のカスタム フィールドに割り当てられます。 -
<labels>カンマで区切られた </labels>
- ラベルの操作を参照してください。
-
<tags> カンマで区切られた </tags>
- タグのリスト。タグは、スマート プレイリストなどの動画を選択するために使用できます。
-
<referenceId></referenceId>
- 動画の一意の参照 ID。参照 ID は、動画をシステム内のエンティティに関連付けるために使用できます。また、動画 ID ではなく参照 ID を使用して動画を公開することもできます。
-
<videoId></videoId>
- 動画 ID。新しい動画を取り込む場合は、これを含めないでください。既存のビデオのメディア アセットを置き換えたり、再トランスコードしたり、追加したりする場合にのみ使用します。
-
<schedule endsAt="" startsAt=""/>
- ビデオが再生可能になるタイミング、および (オプションで) 再び再生不可になるタイミングをスケジュールします。
2022-09-20T20:41:07.689Z
または2022-09-20
などの ISO-8601 日付形式の時刻。 -
<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/"
version="2.0">
<channel>
<item>
<brightcove>
<master url="countdown_10.mp4"/>
<profile>multi-platform-standard-dynamic-with-mp4</profile>
<name>カウントダウン 10</name>
<status>アクティブ</status>
<description short="countdown" long="カウントダウン ビデオ #10" />
<labels></labels>
<tags>サンプル、カウントダウン</tags>
<referenceId>count_1</referenceId>
<images>
<image url="Countdown10.png" バリアント="thumbnail" language="es" label="thumbnail" height="480" width="640"/>
</images>
<texttracks>
<texttrack url="WEBVTT-10.vtt" srclang="en-US" kind="captions" label="English"/>
</texttracks>
</brightcove>
</item>
</channel>
</rss>