MMC アセットマニフェスト
重要:一括ファイル配信を使用してPrime Videoにコンポーネントソースパッケージを配信するパートナーは、アセットマニフェストを添付する必要があります。
プライム・ビデオはメディア・マニフェスト・コア (MMC) 仕様をサポートしています。 MMC は MovieLabs によって設計された業界標準の XML スキーマです。 ユーザーに質の高いコンテンツを提供し、配送プロセスを制限せず、エラーを防ぐには、XML ファイルを自動的に生成する必要があります。 この仕様のドキュメントとサンプルファイルは、MovieLabs の Web サイトにあります。 このリンクからサンプルファイルをダウンロードすることもできます。
プライム・ビデオは MMC 仕様の一部をサポートしています。 使用可能な MMC フィールドの全セットと、プライム・ビデオの使用に関する注意事項は、このページの「MMC フィールドリスト」セクションに記載されています。 配信する MMC アセットマニフェストファイルには、これらのファイル命名規則が適用されます。
MMC の識別子
MMC は、マニフェスト全体でさまざまな ID を参照します。 識別子がグローバルに一意であることを確認し、手動による例外処理を可能にするために、MMC 提出物では以下の統一資源識別子 (URI) 構造を使用してください。その他の情報は、MovieLabs のウェブサイトでご覧いただけます。
識別子は次の URI 構造を使用します。 次のセクションでは、完全な例を紹介します。
<namespace>: <type><scheme>:<SSID>: <Additional Information>
- <namespace> 識別子の範囲を定義します。MMC 全体で、namespace は常に md です。
- <type> 識別子のタイプ、つまり識別される内容です。 例としては、AudTrackID、VidTrackID、PresentationID などがあります。
- <scheme> SSID で指定された ID のスキームを識別します。 Amazon では 2 つのスキームを受け付けています。 使用されるスキームは、コンテンツを識別するためにAmazonに提供されるIDの種類によって決まります。
- eider-x は、提供された ID がエンターテイメント識別子レジストリ (EIDR) からのもので、EIDR の後に追加情報があることを示します。
- org は、提供された ID がパートナーが決定した一意の識別子 (EIDR ではない) であることを示します。
- <SSID> はコンテンツ識別子です。 EIDR またはパートナーが送信した固有の ID のいずれかです。 組織スキームを使用する場合、MMC 仕様で義務付けられているように、パートナーの BusinessAlias が提供された ID の前に付ける必要があります。
- <Additional Information> ここで詳細情報を送信できます。 eidr-x スキームを使用する場合、パートナーの BusinessAlias は直ちに EIDR に従う必要があります。 それに続いて追加の情報が得られるかもしれません。 識別子を一意にするために追加情報が必要な場合があります。 たとえば、「追加情報」セクション (次の URI では下線が引かれています) に含まれる情報によって、2 つの ID が互いに区別されます。
- md: audtrackID: EIDR-X: 8011-8DCB-38E0-BF71-83D2-U: amazon_Studios: feature.audio.en
- md: audtrackID: EIDR-X: 8011-8DCB-38E0-BF71-83D2-U: amazon_Studios: feature.audio.fr
識別子の例 EIDR-X 識別子の例コンテンツを識別するために EIDR 番号を配信する場合は、eidr-x スキームを使用する必要があります。
プライム・ビデオでは、タイトルを識別するために EIDR 番号が優先されます。 プライム・ビデオに EIDR を提供する場合、EIDR プレフィックスは省略する必要があります。EIDR プレフィックスはスラッシュ文字より前にあるものをすべて省略する必要があります(「10.5240/」など)。 固有のサフィックスとチェックディジット (XXXX-XXXXXX-XXXX-XXXX-C など) のみ送信してください。 プライム・ビデオが提供するパートナーエイリアスは、EIDR の後にコロンで区切られて追加されます。
組織識別子の例 EIDR ではない固有 ID を配信する場合は、コンテンツを識別するための組織スキームを使用してください。 次の例では、プライム・ビデオが提供するパートナーエイリアスがタイトル ID の直前に指定されていることに注意してください。
マニフェストのセクション
- インベントリ:MMC のインベントリセクションには、コンポーネントソースパッケージの一部として配信されるすべてのアセット (ビデオ、オーディオ、タイムテキスト) に関する詳細が含まれます。
- プレゼンテーション:MMC のプレゼンテーションセクションには、パッケージの一部として提供されるどのアセットを一緒に再生すべきかが示されます。 例えば、パッケージに 2 つのビデオアセット(1 つは特集用、もう 1 つは予告編)、5 つのオーディオトラック(特集用 4 つ、予告編用)、8 つの時間指定テキストアセット(すべて特集に関連する)が含まれている場合、そのインベントリには 2 つのプレゼンテーションが関連付けられます。 1 つ目はフィーチャー用で、1 つのビデオアセット、4 つのオーディオトラック、8 つの時限テキストアセットが含まれます。 2 つ目のプレゼンテーションは予告編用で、1 つのビデオトラックと 1 つのオーディオトラックが含まれます。
- 再生可能なシーケンス:MMC の「再生可能なシーケンス」セクションには、一緒に再生される予定のプレゼンテーションとそのシーケンスの順序に関する詳細が表示されます。 これらのエントリは必須ではありません。
- エクスペリエンス:MMC の「エクスペリエンス」セクションでは、「プレゼンテーション」や「プレイアブルシーケンス」と「ピクチャグループ」がグループ化され、カスタマーエクスペリエンスが定義されます。 例えば、レーティングカード、フィーチャープレゼンテーション、吹き替えカードを含むプレイアブルシーケンスを 1 つのエクスペリエンスで構成できます。
- ALID-エクスペリエンスマッピング:ロジカルアセット ID (ALID) を使用して、利用可能回数をコンテンツと照合します。 MMC の ALID エクスペリエンスマッピングセクションでは、使用可能な EMA の ALID をそのコンテンツに関連するエクスペリエンスに関連付けます。
Partial MMC
Partial MMC では、以前に配信されたアセットをすべて申告しなくても、更新されたパッケージのアセットを配信できます。 サンプルファイルはダウンロードできます。
部分的な MMC には、更新したパッケージに含まれるアセットのインベントリオブジェクトのみを含める必要があります。 以前にプライム・ビデオに配信されたアセットのインベントリを申告する必要はありません。 プレゼンテーションは、MMC インベントリとパッケージに存在するアセットが含まれている場合にのみ申告してください。 たとえば、長編映画の吹き替えカードのみを含むアップデートパッケージを配信する場合、空のフィーチャープレゼンテーションを宣言する必要はありません。フィーチャーアセットは以前に配信されたもので、MMC やアップデートパッケージには含まれていないからです。
配信すべてアセットは、受領時に MMC メタデータに基づいて分類されます。 たとえば、ダブカードは、インベントリオブジェクトに CardSetList.CardSet.Type “DubbingCredit” が含まれ、メインタイプとサブタイプのフィーチャーを含むエクスペリエンスとして宣言されると(プレゼンテーション > PlayableSequence > エクスペリエンスでの宣言による)、分類されます。
ALID は、初期パッケージと新しいアセットを含む更新済みパッケージとの間で一致する必要がある唯一の ID です。
MMC フィールドリスト次の表は
、使用可能な MMC フィールドと Prime Video 固有の注意事項をまとめたものです。 (フィールド階層の例を確認するには、MMC Manifest v1.10 のサンプルファイルをダウンロードしてください)。
フィールド名列には MMC フィールドが一覧表示され、フィールドの属性は @ 記号で示されます。
[許容値] 列には、許容値の一覧や、各フィールドに期待される値のタイプが表示されます。 空白のままにすると、文字列の入力が許可されていることを示します。 入力は UTF-8 文字に制限されています。
プライム・ビデオの使用状況列には、そのフィールドが必須か、オプションか、またはプライム・ビデオでは使用されないかが示されます。
この表と注記は、MovieLabs が提供するドキュメントと定義に追加されるものです。 両者の間に矛盾が生じた場合は、プライム・ビデオへの配信には以下の注意事項とガイドラインが優先されます。
フィールド名 |
定義と注記 |
許容値 |
プライム・ビデオの使用状況 |
MediaManifest-type |
|||
@ManifestID |
マニフェストの一意の識別子。 |
未使用 |
|
@updateNum |
このマニフェスト配信のバージョン。 |
整数 |
未使用 |
@updateDeliveryType |
オブジェクトには更新に必要な部分のみが含まれていることを示します。 これは完全なオブジェクトではありません。 |
未使用 |
|
Compatibility |
どのバージョンがこの入力を完全に使用できるかを示します。 |
必須 |
|
SpecVersion |
サポートされているバージョンは v1.5 です。 |
列挙されています。 |
必須 |
Profile |
マニフェストのプロフィール。 |
「MMC-1」 |
未使用 |
Inventory |
パッケージの一部として配信される個々のアセット (メザニンファイル、タイムテキスト、オーディオなど) をすべてアセット固有のメタデータとともに識別します。 |
必須 |
|
Audio |
サポートされているフォーマット、チャンネルマッピング、その他の技術的要件について詳しくは、「オーディオ」を参照してください。 エピソードや映画の配信には、少なくとも 1 つのオーディオトラックが必要です。 ビデオファイルに埋め込まれたオーディオトラックも、オーディオトラックとしてインベントリに登録されている必要があります。 コンテナの場所 (ファイル名) は、1 つのオーディオファイルと 1 つのビデオファイルで同じであってもかまいません。 |
(オプション) |
|
@AudioTrackID |
MMC 全体でオーディオトラックを参照するために使用される ID。 |
Audio に必須 |
|
Type |
|
列挙。 |
オーディオで必須 |
Encoding |
ファイルの出力/拡張子。 |
[オプション] |
|
Codec |
ファイルの出力に使用されるコーデック。 |
[オプション] |
|
Language |
オーディオトラックに含まれるプライマリダイアログの言語。 |
RFC 5646 |
Audio に必須 |
Language |
オーディオトラックに含まれるプライマリダイアログの言語。 |
RFC 5646 |
Audio に必須 |
@dubbed |
True はオーディオトラックが吹き替えられていることを示します。 False は、これが OV オーディオトラックであることを示します。 省略した場合、プライム・ビデオは false と見なします。 |
ブール値 |
未使用 |
@forced |
オーディオトラックに強制的なナラティブが含まれていることを示します。 |
ブール値 |
未使用 |
Description |
同じ言語の解説や説明用のオーディオトラックが複数ある場合は必須です。 |
[オプション] |
|
ContainerReference |
アセットのファイル名を提供します。 メザニンビデオファイルに埋め込まれたオーディオの場合は、ビデオファイルを指定します。 |
必須 |
|
ContainerLocation |
オーディオトラックのファイル名。 フォルダー、リンク、またはパスを指定しないでください。 |
必須 |
|
Hash |
配信されたファイルのチェックサム。 |
[オプション] |
|
@method |
チェックサムメソッド。 MD5 のみがサポートされます。 |
「MD5」 |
オプション |
Video |
サポートされている形式と技術要件の詳細については、「ビデオ」を参照してください。 エピソードや映画の配信には、少なくとも 1 つのビデオトラックが必要です。 |
[オプション] |
|
@VideoTrackID |
MMC 全体でビデオトラックを参照するために使用される ID。 |
Video に必須 |
|
Type |
サポートされている値:
|
列挙されています。 |
Video に必須 |
Picture |
HDR アセットのメタデータに使用されます。 |
HDR に必要です |
|
AspectRatio |
ビデオファイルのアスペクト比。 |
[オプション] |
|
MasteredColorVolume |
マスタリング時に使用するカラーボリューム。 これはエンコードされた色の境界を表します。 |
HDR に必要です |
|
PrimaryRChromaticity |
赤色度値。 |
HDR に必要です |
|
ChromaticityCIEx |
十進法 |
||
ChromaticityCIEy |
十進法 |
||
PrimaryGChromaticity |
緑の色度値。 |
HDR に必要です |
|
ChromaticityCIEx |
十進法 |
||
ChromaticityCIEy |
十進法 |
||
PrimaryBChromaticity |
青色度値。 |
HDR に必要です |
|
ChromaticityCIEx |
十進法 |
||
ChromaticityCIEy |
十進法 |
||
WhitePointChromaticity |
ホワイトポイントの公称色度。 |
HDR に必要です |
|
ChromaticityCIEx |
十進法 |
||
ChromaticityCIEy |
十進法 |
||
LightLevel |
HDR コンテンツのライトレベルを表し、輝度の単位であるニットで表される HDR メタデータ。 |
HDR に必要です |
|
ContentMax |
ストリーム全体で最も明るいピクセルに対応する HDR メタデータ。 値が不明な場合は、「0」の値でもかまいません。 |
整数 |
LightLevel に必須 |
FrameAverageMax |
ストリーム全体のフレームあたりの最高フレーム平均輝度に対応する HDR メタデータ。 値が不明な場合は、「0」の値でもかまいません。 |
整数 |
LightLevel に必須 |
Language |
ビデオトラックに含まれるメインダイアログの言語。 |
RFC 5646 |
使用されていません。 |
CardsetList |
ビデオファイルをダブカード (ダビングクレジット) として識別します。 プライム・ビデオは動画吹き替えクレジットのみを受け付けます。 画像をダブカードとして受け付けることはできません。 |
[オプション] |
|
Cardset |
CardsetList に必須 |
||
type |
カードセットの種類を識別します。 |
「ダビングクレジット」 |
Cardset に必須 |
language |
クレジットされている吹き替え言語を識別します。 |
RFC 5646 |
Cardset に必須 |
ContainerReference |
アセットのファイル名を提供します。 |
Video に必須 |
|
ContainerLocation |
オーディオトラックのファイル名。 フォルダー、リンク、またはパスを指定しないでください。 |
必須 |
|
Hash |
配信されたファイルのチェックサム。 |
[オプション] |
|
@method |
チェックサムメソッド。 |
「MD5」 |
オプション |
Subtitle |
サポートされている形式と要件について詳しくは、「タイムテキスト」を参照してください。 |
[オプション] |
|
@SubtitleTrackID |
MMC 全体で字幕トラックを参照するために使用される ID。 |
Subtitle に必須 |
|
Type |
字幕トラックのタイプ。
|
列挙されています。 |
Subtitle に必須 |
Language |
字幕トラックの言語 |
5646 |
Subtitle に必須 |
Encoding |
ファイルの出力/拡張子。 |
Subtitle に必須 |
|
FrameRate |
このフィールドは、Common Metadata 仕様の MMC を拡張したもので、時間指定のテキストフレームレート情報の配信をサポートします。 元々整数 (30 など) のフレームレートには、整数を使用する必要があります。 10 進数のフレームレート (29.97 など) の場合、FrameRate 要素タグには、整数のフレームレート、乗数、ドロップフレーム/ノンドロップフレームの情報を含める必要があります。 |
列挙型整数 |
Subtitle に必須 |
@multiplier |
10 進数のフレームレート (29.97 など) では、次の形式で乗数を含める必要があります。29.97 または 23.976 のフレームレートには「1000/1001」の 24 フレームレート乗数が使用されます。 他の乗数はサポートされていません。 |
「1000/1001" は整数以外のフレームレートでサポートされる値です。 |
(オプション) |
@timecode |
このフィールドは Drop または NonDrop との通信に使用されます。 省略された値はノンドロップとみなされます。 |
Drop = ドロップフレーム。 |
必須 |
ContainerReference |
アセットのファイル名を提供します。 |
Subtitle に必須 |
|
ContainerLocation |
タイムテキストのファイル名。 フォルダー、リンク、またはパスを指定しないでください。 字幕は動画ファイルを指さない場合があります。 |
Subtitle に必須 |
|
Hash |
配信されたファイルのチェックサム。 |
[オプション] |
|
@method |
チェックサムメソッド。 |
「MD5」 |
オプション |
Presentations |
適合したトラックのセットごとに 1 つのプレゼンテーションインスタンスが必要です。 |
必須 |
|
Presentation |
適合したアセットをグループ化するのに使用されます。 ビデオファイルに適合するオーディオとタイムテキストをすべて含めます。 |
必須 |
|
@PresentationID |
MMC 全体で Presentation を参照するために使用される ID。 |
必須 |
|
TrackMetadata |
一緒に再生できるトラックのセット。 |
必須 |
|
TrackSelectionNumber |
同じタイプに属するトラックのグループに割り当てられるトラック選択番号。 一緒に再生すべきトラックの組み合わせごとに 1 つのセットがあります。 TrackSelectionNumber=0 がプライマリグループです。 |
整数 |
必須 |
VideoTrackReference |
1 つのビデオファイルが必要です。 HDR コンテンツには、Inventory から SDR と HDR の両方のソースへの参照を含めてください。 |
必須 |
|
VideoTrackID |
Inventory に含まれている VideoTrackID を参照する必要があります。 |
必須 |
|
AudioTrackReference |
少なくとも 1 つのオーディオリファレンスが必要です。 各 Presentation のビデオに合致するオーディオトラックをすべて含めてください。 予告編の Presentation には、オーディオトラックを 1 つだけ含めることができます。 |
必須 |
|
AudioTrackID |
Inventory に含まれている AudioTrackID を参照する必要があります。 |
必須 |
|
SubtitleTrackReference |
各 Presentation のビデオに合わせて、時間指定のテキスト参照をすべて含めてください。 |
[オプション] |
|
SubtitleTrackID |
インベントリに含まれるサブタイトルトラックIDを参照する必要があります。 |
[オプション] |
|
PlayableSequence(s) |
メインコンテンツの前後のプレロールとポストロールを定義します。 |
[オプション] |
|
PlayableSequence |
ダブカードでのみサポートされます。 |
PlayableSequence(s) に必須 |
|
@PlayableSequenceID |
MMC 全体で再生可能なシーケンスを参照するために使用される ID。 |
PlayableSequence に必須 |
|
Clip |
オーディオビジュアル再生素材のクリップ。 |
PlayableSequence(s) に必須 |
|
sequence |
同じグループ内の他のクリップとの相対的なこのクリップのシーケンスを示します。 順序は最小値から最大値の順です。0 = メインコンテンツ。 負の数値 = プレロール。 正の数値 = ポストロール。 |
整数 |
Clip に必須 |
audioLanguage |
このクリップが特定のオーディオ言語に関連付けられていることを示します。 通常はダブカードに使用されます。 |
5646 |
使用されていません。 |
manifest:PresentationID |
再生する Presentation の ID。 |
クリップに必須 |
|
Experiences |
エクスペリエンスは顧客のプレイ体験を定義します。 |
必須 |
|
Experience |
Playable Sequences と Presentations を顧客にどのように提示するかを定義します。 |
必須 |
|
@ExperienceID |
MMC 全体で Experience を参照するために使用される ID。 |
必須 |
|
@Version |
MovieLabs XSD には必須。 プライム・ビデオでは使用されません。 |
整数 |
未使用 |
@updateNum |
配信中のエクスペリエンスのバージョン。 |
整数 |
未使用 |
Language |
言語タグと除外言語タグはサポートされていません。 avails を使用して、許可する言語または言語ホールドバックを指定します。 |
RFC 5646 |
使用されていません。 |
ExcludedLanguage |
言語タグと除外言語タグはサポートされていません。 avails を使用して、許可する言語または言語ホールドバックを指定します。 |
RFC 5646 |
使用されていません。 |
Region |
地域タグと除外地域タグはサポートされていません。 avails を使用してリージョンを指定してください。 |
未使用 |
|
ExcludedRegion |
地域タグと除外地域タグはサポートされていません。 avails を使用してリージョンを指定してください。 |
未使用 |
|
ContentID |
プライム・ビデオでは使用されません。 マッチングは UniqueID に基づいて行われます。 |
未使用 |
|
AudioVisual |
Experience には AudioVisual 要素が 1 つ必要です。 |
必須 |
|
@ContentID |
プライム・ビデオでは使用されません。 マッチングは UniqueID に基づいて行われます。 |
未使用 |
|
Type |
タイプ値は、参照されている PlayableSequence またはプレゼンテーションに関する情報を提供します。
|
列挙 |
AudioVisual に必須 |
SubType |
特定の Type 値にのみ関連します。 |
Feature, Trailer |
(オプション) |
PresentationID |
AudioVisual に必要なプレゼンテーション ID または PlayableSequenceID は 1 つだけです。 プレゼンテーションセクションで定義されている ID を参照する必要があります。 |
PlayableSequenceID が指定されていない場合は必須 |
|
PlayableSequenceID |
AudioVisual に必要なプレゼンテーション ID または PlayableSequenceID は 1 つだけです。 PlayableSequences セクションで定義されている ID を参照する必要があります。 |
PresentationID が提供されていない場合は必須 |
|
ContentID |
プライム・ビデオでは使用されません。 |
未使用 |
|
ExperienceChild |
予告編をフィーチャーに関連付けるのに使用。 |
[オプション] |
|
Relationship |
のプロモーションなのか、それともエピソードなのか |
列挙 |
ExperienceChild に必須 |
ExperienceID |
別のエクスペリエンスで定義されている ID を参照する必要があります。 |
ExperienceChild に必須 |
|
ALIDExerienceMap(s) |
アベイル (ALID) をエクスペリエンスに関連付けます。 |
必須 |
|
manifest:ALID |
ALID は解析され、Amazon が割り当てたパートナーエイリアス ID と、マッチングエクスペリエンスに対応する固有の ID の両方が抽出されます。 ユニーク ID は AltID と一致し、MEC タイトルメタデータの AltID セクションに含まれている必要があります。 ALID を正しく作成する方法の詳細については、MovieLabs ID に関するセクションを参照してください。 |
必須 |
|
manifest:ExperienceID |
Experiences セクションで定義されている ID を参照する必要があります。 |
必須 |