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