)が格納されたカタログファイルを作成します。カタログファイルの作成にはカタログデータ形式(CDF)スキーマへの準拠が求められ、特定のXML構造に従ってメディアの記述を行わなければなりません。画像の要件CDFに関するよくある質問(FAQ)次のステップカタログファイル作成時のオプションカタログファイルの作成には、2とおりの方法があります。自動プロセスを使用した作成方法です。データベースからエクスポートしたデータをCDFに準拠したカタログファイルに変換します。手動での作成方法です。TVと統合したアプリであればほとんどの場合、自動プロセスを使用してカタログデータ用カタログファイルを作成することができます。自動プロセスを利用した作成方法は、以下のとおりです。アプリのデータベースからメタデータをエクスポートします。データのエクスポートに関してサポートが必要な場合は、組織内のデータベース管理者またはサポート担当者に依頼してください。フィールドをエクスポートする際は、カタログデータ形式スキーマリファレンスで定義されたフィールドに大まかに合わせます。XSLT変換を記述して、エクスポートしたデータをカタログデータ形式スキーマリファレンスに準拠したXMLファイルに変換します。サポートが必要な場合は開発者に依頼してください。カタログファイルの手動作成コンテンツカタログのメタデータがデータベースに保存されていない場合や、メタデータをエクスポートしてXMLファイルに変換することができない場合は、手動でカタログファイルを作成する必要があります。手動による作成方法は、以下のとおりです。XMLの扱いにまだ慣れていない場合は、XMLとその概念について理解を深めます。ここからダウンロードします。CDFドキュメントを参照し、XMLエディター(さまざまな提供元からダウンロード可)を使用して、アプリのカタログデータ用カタログファイルを作成します。以下の例では、項目を1つだけ(映画)格納し、必須要素のみを使用するシンプルなカタログファイルを紹介します。この例はカタログファイルの基本構造を示すために用意されたものです。実際にはより詳しい情報を作品ごとに指定することを強くお勧めします。情報量の多い包括的なサンプルについては、cdf-examples.zipファイルをダウンロード・参照してください。</Catalog>一般的なカタログファイルの構造このセクションでは、CDFスキーマの構造とその要素について大まかに説明します(XMLに関する知識が十分にあることを前提として話を進めます)。このページでは、カタログの主な要素やそれぞれを関連付ける方法など、カタログ形式の概要について説明します。利用可能なすべての要素をカバーするわけではないため、詳細についてはカタログデータ形式(CDF)スキーマリファレンスやXSDスキーマファイルも参照してください。カタログファイルの最上位のアウトラインは、以下のように表すことができます。<Works></Catalog>Catalog(必須)は、全カタログファイルのルート要素です。Partner(必須)は、コンテンツプロバイダーを識別する要素です。Works(必須)は、ファイルの大部分を占める要素です。ライブラリ内のすべての映画やTV番組、各エントリに関して提供する情報、作品の視聴方法などの情報が含まれています。Works要素には、子要素を必要な数だけ格納することができます(子要素は個別の作品(映画やTV番組)を表します)。Works要素に子要素がない場合は、利用できるコンテンツがなくなったとみなされ、インデックスから削除されます。使用できる作品タイプの要素は以下のとおりです。劇場公開用の映画やTV放送用の映画を表します。単発のTV番組を表します。特別なイベントや、シリーズものに関連する番組(通常の番組シリーズの一部ではない)が対象です。連続物のTV番組を表します。通常は複数のエピソードをシーズンとしてまとめて提供します。TV番組の1つのシーズンを表します。TV番組のあるシーズンにおける1つのエピソードを表します。少数の連続エピソードで構成されるTV番組のシリーズを表します。ミニシリーズにおける1つのエピソードを表します。クリップやトレーラーを表します。別の作品に関する内容であることがよくあります。Movieは単独の要素です。TvShow、TvSeason、TvEpisodeは独立した要素ですが、IDで相互に関連付けられています(MiniSeriesとMiniSeriesEpisodeも同様です)。TvSpecialとExtraは単独の要素ですが、別の作品に関連付けることも可能です。詳細については、TV番組、シーズン、エピソードの関連付けを参照してください。上記の作品タイプはいずれも、共通する要素を中心に構成されています。どのタイプでも、拡張に使用される固有の要素は1~5個程度です。共通する要素のうち、必須の要素はほんのわずかになります。カタログスキーマで用意された要素のほとんどは省略可能ですが、追加のメタデータを指定することでユーザーがコンテンツを見つけやすくなります。TVのユニバーサル検索・閲覧機能を実装する場合、カタログファイルにこのメタデータを追加することで、Amazon側でのコンテンツ検出が容易になり、ほかのコンテンツプロバイダーのコンテンツとのマッチ率も上がるので、検索と閲覧の面でより良いユーザーエクスペリエンスを提供することができます。Work要素のアウトラインは、以下のように表すことができます。<Offers></_WorkType_>ID(必須)は作品の識別子で、開発者が指定します。各作品のIDはカタログ内で一意である必要があります。その作品を提供している間はIDを変更しないでください。ID要素は、TVエピソードをTV番組やシーズンの一部として指定する場合など、作品の要素どうしを関連付ける目的でも使用されます。Title(必須)は作品のタイトルです(複数の言語で指定が可能)。Offers(必須)には、ユーザーが作品を視聴できる方法(無料、レンタルまたは購入、定期購入)を指定します。時間やリージョンで制限を設けることも可能です。Offers要素には少なくとも1つの視聴方法を指定する必要があります。指定数に上限はありません。視聴方法には、以下の4つのタイプがあります。常時無料で視聴できる作品です。視聴にはサービスの定期購入が必要な作品です。視聴する際に1回限りの支払いを要する作品です(支払い後はいつでも視聴可能)。視聴する際に1回限りの支払いを要する作品です。支払い後は一定期間のみ視聴することができます。Offer要素のアウトラインは、以下のように表すことができます(省略可能な要素も含む)。<Duration>(レンタルのみ)</_OfferType_>Regions(必須)には、設定した視聴方法を有効にする国を指定します。Regionsは必須要素です。少なくとも1つのCountryを指定してください。WindowStartとWindowEnd(どちらも省略可能)は、設定した視聴方法が有効な期間を指定する際に利用する要素です(どちらかまたは両方を使用してください)。WindowStartより前とWindowEndより後の期間中、設定した視聴方法はユーザーに表示されません。オプションを指定する際に利用する要素です。これらのオプションを事前に構成した設定を使用して、作品を直接公開する際に利用できる特別なIDも定義することができます。Priceは、作品をレンタル・購入する際にかかる費用を指定するための要素です。RentalOfferやPurchaseOfferを使用する場合に必須要素となります。いずれかの通貨を指定することができます。Durationでは、レンタル期間を時間数で指定します。RentalOfferを使用する場合は必須要素となります。カタログに含まれる作品の利用可能状況に変更があった場合は、新しい視聴方法の情報と共に更新したカタログファイルを申請する必要があります。映画、番外編、TV番組の詳細ページには、利用可能な視聴方法とコンテンツプロバイダーが表示されます。視聴方法は以下の順番で表示されます(変更の可能性あり)。上記で紹介した必須および省略可能な共通要素を用いれば、有効なカタログファイルを作成することができます。これらは利用できる要素全体の3分の1にすぎません。残りの共通要素の使用は任意で、より詳細な作品情報を提供する場合に役立つ要素になります。ジャンル、認定情報、キャスト・制作スタッフ、あらすじ、撮影スタジオ、画像、ユーザー評価などの情報を表示可能にする要素があります。すべての要素がまとまったリストは、カタログデータ形式(CDF)スキーマリファレンスで確認することができます。文字列についての留意事項CDFスキーマでは、一部の文字列データ(作品のタイトルや説明など)がカスタマイズされたLocalizedStringタイプとして定義されています。ローカライズされた文字列を用意すれば、同じコンテンツをユーザーデバイスの言語設定に応じて提供することが可能です。このような文字列には、locale(標準型xsd:language)という必須属性が用いられます。以下に一例を紹介します。Sneeze</Title>ローカライズされた文字列には、pronunciation(標準型xsd:string)という省略可能な属性もあります。この属性は、漢字を使用して文字列テキストを指定する日本語のカタログエントリ用です。日本語のソート順は、文字ではなく、(漢字からは特定できない)読み方に基づいて決まります。pronunciation属性には通常、発音の情報をひらがなで指定します。作品タイプには、共通する要素に加えて、それぞれに固有の要素が1~5個あります。一般的に、これらの要素には2つの用途があります。(1)最初の公開日または放送日を指定することと、(2)作品どうしを関連付けることです(TVのエピソードをTV番組に関連付けるなど)。公開日は省略可能ですが、指定することをお勧めします。ReleaseDate(映画、TV番組、ミニシリーズの場合)またはOriginalAirDate(TVおよびミニシリーズのエピソードとTVの特別番組の場合)を利用すれば指定可能です。番組、シーズン、エピソードを関連付ける要素は必須です。これについては次のセクションで詳しく説明します。タイプ固有の要素の特記事項については、カタログデータ形式(CDF)スキーマリファレンスを参照してください。TV番組、シーズン、エピソードの関連付けTVエピソードは特定のTV番組の1シーズンの間に放映され、ミニシリーズは個別のエピソード(複数)で構成されています。番外編は、映画の予告編や舞台裏に関する情報を指します。TV特別番組はTV番組と関連はありますが、通常の連続物には含まれません。CDFには、これらを関連付けるための要素が用意されています。TVユーザーがTV番組を閲覧したときに、その番組がシーズン単位で整理され、各エピソードがシーズン内で順序立って表示されるのは、これらの要素が使用されているためです。通常、作品どうしを関連付けるにはIDまたはタイトルを使用します。IDはカタログに含まれる対象作品のIDと一致する必要がありますが、対象作品がカタログにない場合は、IDの代わりにタイトルを使用してください。カタログ内でのマッチングにタイトルは必要ありません。タイトルは、作品をグループ化する目的でのみ使用されます。以下の表で、作品タイプごとの要素を紹介します。TvEpisodeにはSeasonTitle要素もありますが、この要素はグループ化には使用されません。なしカタログに含まれていないシーズンを指定する場合、TvEpisodeではタイトルではなく番号を使用します。ExtraではIMDbなど、外部のIDスキーマへのリンクを使用します。TvEpisode、TvSeason、MiniSeriesEpisodeでは、上記の関連付け要素の各ペアのうち、どちらか一方が必須となるので、必ず指定してください。TvSpecialとExtraは単独の作品として扱うことができるため、関連付けの値は省略可能です。以下の図は、TV番組向けにIDを使用した際に、さまざまな要素と値がどのようにマッチされるかを示すものです。TV番組、シーズン、エピソード、特別番組の各IDにおける関係図たとえば、TvShowのIDがTV-123456の場合、TvEpisodeとTvSeasonのShowID値も同じくTV-123456になります。完全なカタログの実装例を確認する場合は、カタログデータ形式のサンプルをダウンロードしてください。ボックスアート画像(ImageUrl)の要件ImageUrl要素はすべての作品に共通する省略可能な要素の1つで、作品を表す画像のURLを指定するものです。この画像は「ボックスアート」とも呼ばれています。ImageUrlが未指定の場合、マッチングがうまくいけばIMDbなどのソースから利用可能な画像が選ばれ、使用されます。マッチングができなければ、汎用的なプレースホルダー画像が使用されます。カタログでは、エントリ全体の50%以上に有効な画像を提供する必要があります。50%に満たない場合は統合プロセスが失敗し、カタログ全体が却下されてしまいます。これ以外の画像タイプは使用できません。9に従う必要があります。pxの場合でも使用可能です。px未満の画像は使用できません。最適な品質を維持するために、必要に応じてサイズ変更が可能な大きい画像の使用をお勧めします。画像サイズに上限はありません。アスペクト比が理由で画像がトリミングされる場合でも、元のサイズにかかわらず、高さの要件を満たしている必要があります。少なくとも、上記の仕様を満たす画像を使用してください。この仕様は、作品自体ではなく、ボックスアート画像に適用されるものです。カタログファイルの作成方法を教えてください。メタデータをCDF形式に準拠したXMLファイルにエクスポートする、プログラムを介したファイル作成がお勧めです。TVShow、TVSeason、およびTVEpisodeを使用してください。MiniSeriesおよびMiniSeriesEpisodeタイプを使用してください。エピソードの順序を表すためにEpisodeInSeriesの値を指定する必要があります。シーケンス番号がない連続エピソードを含むTV番組なので、放送日でエピソードの順序付けをしています。TVShowおよびTVSpecialタイプを使用してください。TVSpecialでは、ShowIDまたはShowTitleフィールドを使用してTVShowにリンクさせ、さらに必須の放送日を追加してください。扱っているニュース系コンテンツには複数のエピソードがありますが、シーズン形式ではなく、放送日でエピソードの順序を決めています。TVShowおよびTVSpecialタイプを使用してください。TVSpecialでは、ShowIDまたはShowTitleフィールドを使用してTVShowにリンクさせ、さらに必須の放送日を追加してください。シーズン形式の番組の場合、必ずシーズン値を指定してください。指定しない場合、ユーザーエクスペリエンスに悪影響を及ぼしかねません。シーズン情報を取得するには、IMDbのような信頼性の高いカタログを確認します。快適な視聴体験を維持するため、シーズン値が指定されていないシーズン形式のコンテンツは、カタログに含めないことをお勧めします。カタログに仮のSeason番号やEpisode番号は指定しないでください。この場合はTvEpisodeエントリタイプではなく、TvSpecialを使用してください。引き続き各エントリ(TvSpecial)をTVShowにマッピングすることで、エントリどうしがTvShowを通じて関連付けられるようになります。TvSpecialではOriginalAirDateが必須フィールドであることに注意してください。このフィールドを使用することで、TvShow内のエピソードを適切にマッチングしたり、正しい順序に並べたりすることができます。ほかの情報源を利用してSeason番号とEpisode番号を特定することも可能です。想定されるユーザーの期待値に基づいて判断することをお勧めします。TVシリーズが毎晩放送されるトーク番組の場合、おそらくユーザーはシーズン形式の番組だとは思わないはずです。この場合、最も重要なのは放送日です。ユーザーが一気に視聴する傾向にある人気シリーズの場合は、Season番号やEpisode番号がより重要になるはずです。S3にカタログファイルをアップロードする前に、ファイル内のXMLを検証することを強く推奨します。CDFに不完全または無効なXMLが含まれていると、そのファイルは却下されてしまいます。カタログファイルを検証するを参照してください。カタログファイルを検証するに進んでください。無断複写·転載を禁じます。