カタログデータ形式(CDF)スキーマ


カタログデータ形式(CDF)スキーマ

このトピックでは、カタログデータ形式(CDF)スキーマに用意されている要素の一覧を紹介します。CDFスキーマは、Amazon Fire TVにアップロードするメディアコンテンツのカタログの作成に使用されます。

CDFカタログファイルの構造の概要と各要素の相互作用については、手順1: カタログファイルを作成するを参照してください。カタログのサンプルファイル(cdf-examples.zip)をダウンロードして、カタログファイルの構成を理解するための参考にしてください。XSDの内容は、catalog.xsdをダウンロードして直接確認できます。

この情報を活用するには、XMLに関する十分な知識が必要です。次のセクションでは、CDFスキーマ要素の定義を示します。

次のCDFリソースにも留意してください。

AdultProduct

省略可能廃止

成人向けコンテンツとして作品を識別します。

プロパティ 詳細
使用 廃止、使用不可
追加 CDFバージョン1.0
廃止 CDFバージョン1.1
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性 なし
使用できる値 truefalse

<Movie>false</Movie>
  ...
  <AdultProduct>false</AdultProduct>
  ...
</Movie>false</Movie>

↑先頭に戻る

AudioLanguage

省略可能

複数の言語に吹き替えられた作品のオーディオオプション。AudioLanguage要素は、その作品で利用できる吹き替え版を指定するため、必要に応じていくつでも追加できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 LaunchDetails
子要素 なし
属性 なし
使用できる値 標準のXML/HTML言語コード(enen-USfrfr-FRなど)

<LaunchDetails>
  <Quality>SD</Quality>
  <Quality>HD</Quality>
  <AudioLanguage>en-US</AudioLanguage>
  <AudioLanguage>es-MX</AudioLanguage>
  <Subtitle>en-US</Subtitle>
  <Subtitle>es-MX</Subtitle>
  <LaunchId>MV123456_HD_es-MX_en</LaunchId>
</LaunchDetails>

↑先頭に戻る

CastMember

省略可能条件付きで必須

作品のキャスト(俳優、ホスト、ナレーター、声優など)についての情報を指定します。Credits要素(省略可能)が存在する場合、CastMemberまたはCrewMemberのいずれかの項目を指定する必要があります。CastMember要素は必要に応じていくつでも追加できます。

プロパティ 詳細
使用 省略可能
必須となる条件 CrewMember要素が存在しない場合は必須、存在する場合は省略可能
追加 CDFバージョン1.0
親要素 Credits
子要素

必須: Name

省略可能: ExternalIDRole

属性 なし

<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <ExternalID scheme="imdb">tt0000000</ExternalID>
    <Role locale="en-US">Self</Role>
  </CastMember>
</Credits>

↑先頭に戻る

Catalog

常に必須

CDFファイルのルート要素。すべてのカタログファイルにはCatalog要素が1つ必要で、この中にそのファイルの残りの要素が指定されます。

プロパティ 詳細
使用 必須
追加 CDFバージョン1.0
親要素 なし
子要素

必須: PartnerWorks

属性
xmlns(必須)
  • XML名前空間。
  • 使用できる値:http://www.amazon.com/
    FireTv/2014-04-11/ingestion
version(省略可能)
  • このカタログで使用されているスキーマのバージョン。使用しているスキーマのバージョンは、スキーマの「id」を参照して確認できます。この属性は互換性の理由から省略できますが、バージョンは指定することをお勧めします。この属性はCDF v1.2で追加されました。
  • 使用できる値: FireTv-v1.2FireTv-v1.3

<xml version="1.0" encoding="utf-8" ?>
<Catalog xmlns="http://www.amazon.com/FireTv/2014-04-11/ingestion" version="FireTv-v1.3">
  <Partner>Everything Ever Made Filmworks</Partner>
  <Works>
    ...
  </Works>
<Catalog>

↑先頭に戻る

Certification

省略可能条件付きで必須

特定の認定システムの下で作品に与えられた証明(評価)。ContentRatingに割り当てることのできるCertification要素は1つだけです。

プロパティ 詳細
使用 省略可能
必須となる条件 ContentRatingで必須
追加 CDFバージョン1.0
親要素 ContentRating
子要素 なし
属性 なし

<ContentRating>
  <System>MPAA</System>
  <Certification>PG-13</Certification>
</ContentRating>

↑先頭に戻る

Color

省略可能

映画が主にカラーであるか白黒であるかを指定します。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性 なし
使用できる値 colorblack_and_white

<Movie>
  ...
  <Color>black_and_white</Color>
  ...
</Movie>

↑先頭に戻る

ContentRating

省略可能条件付きで必須

レーティングシステム(評価機関)およびそのシステムで作品に与えられた評価を指定する要素が格納されます。ContentRatings(省略可能)が存在する場合は、ContentRatingが1つ以上指定されている必要があります。ContentRating要素は必要に応じていくつでも追加できます(システム/評価の組み合わせごとに1つ)。

プロパティ 詳細
使用 省略可能
必須となる条件 ContentRatings要素(省略可能)が存在する場合は必須
追加 CDFバージョン1.0
親要素 ContentRatings
子要素

必須: SystemCertification

属性 なし

<ContentRatings>
  <ContentRating>
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
</ContentRatings>

↑先頭に戻る

ContentRatings

省略可能

特定の認定機関によって作品に与えられた公式な評価が指定されます。ContentRatings要素は、作品ごとに1つのみ指定できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素

必須: ContentRating

注意: 少なくとも1つのContentRating要素が必要です。

属性 なし

<ContentRatings>
  <ContentRating>
    <System>MPAA</System>
    <Certification>PG-13</Certification>
  </ContentRating>
  <ContentRating>
    <System>Eirin</System>
    <Certification>R15+</Certification>
  </ContentRating>
</ContentRatings>

↑先頭に戻る

省略可能

作品の著作権表示。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性
locale(必須)
  • この文字列を使用するデバイスまたはソフトウェアの言語設定。
  • 使用できる値: 標準のXML/HTML言語コード(enen-USfrfr-FRなど)
pronunciation(省略可能)
  • 要素のテキストが漢字で表記される場合に使用されます。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には通常、発音の情報をひらがなで指定します。
  • 使用できる値: 文字列

<Copyright locale="en-US">© 2014 Amazon Studios</Copyright>

↑先頭に戻る

Count

省略可能

視聴者の評価スコアに寄与したユーザーの数。Countは、CustomerRatingごとに1つのみ指定できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.2
親要素 CustomerRating
子要素 なし
属性 なし
使用できる値 負数以外の整数。

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

↑先頭に戻る

Country

常に必須

特定の視聴方法(定期購入、無料、購入、レンタル)の対象となる国または地域。各視聴方法には、必要に応じてCountry要素をいくつでも追加できます。

プロパティ 詳細
使用 必須
追加 CDFバージョン1.0
親要素 Regions
子要素 なし
属性 なし
使用できる値 次に示すISO 3166-1国コードのサブセットを使用できます。 AF AX AL DZ AS AD AO AI AQ AG AR AM AW AU AT AZ BS BH BD BB BY BE BZ BJ BM BT BO BQ BA BW BV BR IO BN BG BF BI KH CM CA CV KY CF TD CL CN CX CC CO KM CG CD CK CR CI HR CU CW CY CZ DK DJ DM DO EC EG SV GQ ER EE ET FK FO FJ FI FR GF PF TF GA GM GE DE GH GI GR GL GD GP GU GT GG GN GW GY HT HM VA HN HK HU IS IN ID IR IQ IE IM IL IT JM JP JE JO KZ KE KI KP KR KW KG LA LV LB LS LR LY LI LT LU MO MK MG MW MY MV ML MT MH MQ MR MU YT MX FM MD MC MN ME MS MA MZ MM NA NR NP NL NC NZ NI NE NG NU NF MP NO OM PK PW PS PA PG PY PE PH PN PL PT PR QA RE RO RU RW BL SH KN LC MF PM VC WS SM ST SA SN RS SC SL SG SX SK SI SB SO ZA GS SS ES LK SD SR SJ SZ SE CH SY TW TJ TZ TH TL TG TK TO TT TN TR TM TC TV UG UA AE GB US UM UY UZ VU VE VN VG VI WF EH YE ZM ZW

<SubscriptionOffer>
  <Regions>
    <Country>US</Country>
    <Country>CA</Country>
  </Regions>
  ...
</SubscriptionOffer>

↑先頭に戻る

Credits

省略可能

作品のキャストとクルーを表す要素が格納されます。同じ人物をキャストまたはクルーとして複数回指定できます。指定できるCredits要素は各作品につき1つだけです。Creditsが存在する場合、CastMemberまたはCrewMemberが少なくとも1つ必要です。いずれの要素も必要に応じていくつでも追加できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素

必須: CastMemberCrewMember

注意: この2つの子要素のうち少なくとも1つが必須

属性 なし

<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <Role locale="en-US">Self</Role>
  </CastMember>
</Credits>

↑先頭に戻る

CrewMember

省略可能条件付きで必須

作品の裏方のクルー(ディレクター、ライター、カメラマン、照明係第一助手、アニメーター、撮影助手など)に関する情報を表す要素が格納されます。Credits(省略可能)が存在する場合、CastMemberまたはCrewMemberのいずれかの項目が少なくとも1つが必要です。CrewMember要素は必要に応じていくつでも追加できます。

プロパティ 詳細
使用 省略可能
必須となる条件 CastMember要素が存在しない場合は必須、存在する場合は省略可能。
追加 CDFバージョン1.0
親要素 Credits
子要素

必須: Name

省略可能: ExternalIDJob

属性 なし

<Credits>
  <CrewMember>
    <Name locale="en-US">Alan Smithee</Name>
    <ExternalID scheme="imdb">tt0000000</ExternalID>
    <Job locale="en-US">Director</Job>
  </CrewMember>
</Credits>

↑先頭に戻る

CustomerRating

省略可能

作品に対する視聴者の評価の平均スコア、最大値、スコアに寄与した評価の数を表す要素が格納されます。指定できるCustomerRating要素は各作品につき1つだけです。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素

必須: ScoreMaxValue

省略可能: Count

注意: CountはCDF v1.2以降でのみ使用できます。

属性 なし

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

↑先頭に戻る

Duration

常に必須

作品のレンタル期間(時間単位)を定義します。指定できるDuration要素は1つのRentalOfferにつき1つだけです。

プロパティ 詳細
使用 必須
追加 CDFバージョン1.0
親要素 RentalOffer
子要素 なし
属性 なし

<RentalOffer>
  ...
  <Duration>120</Duration>
</RentalOffer>

↑先頭に戻る

EpisodeInSeason

省略可能条件付きで必須

テレビのシーズンに含まれているエピソードの連続番号。指定できるEpisodeInSeason要素は各TvEpisodeにつき1つだけです。

プロパティ 詳細
使用 省略可能
必須となる条件 TvEpisodeを使用する場合は必須
追加 CDFバージョン1.0
親要素 TvEpisode
子要素 なし
属性 なし

<TvEpisode>
  ...
  <EpisodeInSeason>6</EpisodeInSeason>
  ...
</TvEpisode>

↑先頭に戻る

EpisodeInSeries

省略可能条件付きで必須

シリーズに含まれているミニシリーズのエピソードの連続番号。指定できるEpisodeInSeries要素は各MiniSeriesEpisodeにつき1つだけです。

プロパティ 詳細
使用 省略可能
必須となる条件 MiniSeriesEpisodeを使用する場合は必須
追加 CDFバージョン1.3
親要素 MiniSeriesEpisode
子要素 なし
属性 なし

<MiniSeriesEpisode>
  ...
  <EpisodeInSeries>13</EpisodeInSeries>
  ...
</MiniSeriesEpisode>

↑先頭に戻る

ExternalID

省略可能

外部ソース(IMDbなど)の分類に基づく作品の識別子。この値は、コンテンツのマッチングに使用されます。別のカタログ内の対応する値と比較し、作品や人物が同一であるかどうかを判断します。画像など外部コンテンツのソースとしても使用できます。外部IDを格納するExternalID要素は、必要に応じていくつでも追加できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 CastMemberCrewMemberExtraMiniSeriesMiniSeriesEpisodeMovieTvEpisodeTvSeasonTvShowTvSpecial
子要素 なし
属性
scheme(必須)
  • このIDの提供元となった外部ソース。
  • 使用できる値:
    • imdb: Internet Movie Database(IMDb)。IDは、特定のページのURLの構成要素として存在します。
    • tms: GracenoteTMデータベースで使用されているID。
    • isan: International Standard Audiovisual Number(ISAN)。26文字の英数字で、通常はダッシュ区切りで表示されます。
    • ean: International Article Number(EAN)。通常は13桁のバーコードです。
    • upc: Universal Product Code(UPC)。通常は12桁のバーコードです。

<Movie>
  <ID>MV123456</ID>
  <ExternalID scheme="imdb">tt0000000</ExternalID>
  <ExternalID scheme="tms">MV000000000000</ExternalID>
  <ExternalID scheme="isan">0000-0000-0F00-0000-X-0000-0000-Y</ExternalID>
  <ExternalID scheme="ean">0011559514120</ExternalID>
  <ExternalID scheme="upc">123456789990</ExternalID>
  ...
</Movie>

↑先頭に戻る

Extra

省略可能

Extraは基本的な作品タイプの1つで、クリップまたはトレーラーを表します。単発の作品の場合もありますが、通常はほかの作品(外部の作品またはカタログ内の別の作品)に関連付けられます。一般に、DVDに収録されるボーナストラックに相当するものと考えてください。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.3
親要素 Catalog
子要素

必須: IDOffersTitle

省略可能: AdultProductColorContentRatingsJP_Require18PlusAgeConfirmationCopyrightCreditsCustomerRatingExternalIDGenresImageUrlLanguageRankReleaseInfoShortDescriptionReleaseYearRuntimeMinutesSourceStudiosSynopsis

この要素のみに固有の子要素

必須: TypeRelatesToIDRelatesToExternalID

注意: RelatesToIDまたはRelatesToExternalIDのいずれかが必須(両方は不要)

属性 なし

<Extra>
  <ID>EXTRA-11111</ID>
  <Title locale="en-US">Wishenpoof! Trailer</Title>
  <Offers>
    <FreeOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </FreeOffer>
  </Offers>
  <Type>trailer</Type>
</Extra>

↑先頭に戻る

FreeOffer

省略可能条件付きで必須

4つある視聴方法タイプの1つで、作品をいつでも無料で視聴できます。視聴できる期間を指定することもできます。必要に応じて、Offersに複数のFreeOffer要素を追加できます。

プロパティ 詳細
使用 省略可能
必須となる条件 省略可能(ただし、Offersには少なくとも1つの視聴方法タイプが必須)
追加 CDFバージョン1.0
親要素 Offers
子要素

必須: Regions

省略可能: LaunchDetailsQualityWindowStartWindowEnd

属性 なし

<FreeOffer>
  <Regions>
    <Country>US</Country>
    <Country>CA</Country>
  </Regions>
  <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
  <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
</FreeOffer>

↑先頭に戻る

Genre

省略可能条件付きで必須

作品のジャンル(コメディー、ホラー、ドラマ、ドキュメンタリーなど)。必要に応じて、1つの作品に複数のGenre要素を指定できます。検索とマッチングの機能を最大限に活かすため、できる限り標準的なジャンル名を使用してください。複数の説明を組み合わせて1つの文字列にするのではなく複数のGenreタグを使用してください。

プロパティ 詳細
使用 省略可能
必須となる条件 Genres要素(省略可能)が存在する場合は必須
追加 CDFバージョン1.0
親要素 Movie
子要素 なし
属性
locale(必須)
  • この文字列を使用するデバイスまたはソフトウェアの言語設定。
  • 使用できる値: 標準のXML/HTML言語コード(enen-USfrfr-FRなど)
pronunciation(必須)
  • 要素のテキストが漢字で表記される場合に使用されます。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には通常、発音の情報をひらがなで指定します。
  • 使用できる値: 文字列

<Genres>
  <Genre locale="en-US">horror</Genre>
  <Genre locale="en-US">sci-fi</Genre>
</Genres>

↑先頭に戻る

Genres

省略可能

作品のカテゴリー(コメディー、ホラー、ドキュメンタリーなど)を表す1つ以上のGenreタグを格納します。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素

省略可能: Genre

注意: Genresが存在するときは、少なくとも1つの<a href='../catalog/data-format-schema-reference.html#Genre'Genre</a>要素が必須

属性 なし

<Genres>
  <Genre locale="en-US">horror</Genre>
  <Genre locale="en-US">sci-fi</Genre>
</Genres>

↑先頭に戻る

ID

常に必須

作品の識別子となる文字列。この値は1文字以上とし、カタログに存在するほかのすべてのIDを通じて一意である必要があります。同じIDの作品が2つ存在すると、統合システムによってカタログが却下されます。IDの決め方に方針を設け、重複を防ぐようにしてください。たとえば、パートナーID+作品タイプ+十分な長さを持った識別子(GUIDなど)をIDとして使用することが考えられます(例:AmazonStudios_ Movie_01152ce2-de7e-44c1-9736-e8f3b15a1ddf)。カタログ内でIDの一意性を確保できれば、どのような方針でもかまいません。

既存のカタログをアップデートするときに作品のIDを変更しないようご注意ください。カタログからIDが消えた場合、Amazonではその作品がサービス上で利用できなくなったものと判断し、Amazonのインデックスから削除します。

プロパティ 詳細
使用 必須
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性 なし

<Movie>
  <ID>AmazonStudios_Movie_01152ce2-de7e-44c1-9736-e8f3b15a1ddf</ID>
  ...
</Movie>

↑先頭に戻る

ImageUrl

省略可能条件付きで必須

作品を表す画像のURL。「ボックスアート」とも呼ばれます。 指定できるImageUrl要素は各作品につき1つだけです。ImageUrlが指定されていない場合、ほかのソース(IMDbなど)の利用可能なアートや、汎用的なプレースホルダー画像を使用します。画像の要件については、ボックスアート画像(ImageUrl)の要件を参照してください。

プロパティ 詳細
使用 省略可能
必須となる条件 ImageUrl要素は省略可能ですが、登録対象の50%以上にこの要素が含まれており、かつその画像の参照先が有効である必要があります。ファイル内の50%を超える画像が無効と判断された場合(画像の欠落も無効と見なされます)、アップロードしたカタログは統合システムによって却下されます。

複数のプロバイダーから同じ作品が提出された場合、Amazonでマッチングを行い、そのすべての提供作品を1つの検索結果にまとめることで、検索に対する顧客満足度を高めていますが、画像はこのマッチング作業でも重要となります。最終的には作品の見つけやすさにもつながります。画像のサイズと縦横比の要件については、ボックスアート画像(ImageUrl)の要件を参照してください。

追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性 なし

<TvShow>
  ...
  <ImageUrl>http://amazon.com/images/01152ce2de7e44c1/image.jpg</ImageUrl>
  ...
</TvShow>

↑先頭に戻る

Job

省略可能

作品のCrewMemberの職種(ディレクター、カメラマン、ライター、アニメーターなど)。CrewMemberには、Job要素を必要に応じていくつでも追加できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 CrewMember
子要素 なし
属性
locale(必須)
  • この文字列を使用するデバイスまたはソフトウェアの言語設定。
  • 使用できる値: 標準のXML/HTML言語コード(enen-USfrfr-FRなど)
pronunciation(省略可能)
  • 要素のテキストが漢字で表記される場合に使用されます。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には通常、発音の情報をひらがなで指定します。
  • 使用できる値: 文字列

<CrewMember>
  <Name locale="en-US">Alan Smithee</Name>
  <ExternalID scheme="imdb">tt0000000</ExternalID>
  <Job locale="en-US">Grip</Job>
</CrewMember>

↑先頭に戻る

JP_Require18PlusAgeConfirmation

省略可能

18歳以上の視聴者を対象とした、日本市場向けのコンテンツとしてマークします。このフラグをtrueに設定した場合、日本におけるそのコンテンツの視聴者は、日本の法的要件に従って18歳以上であることを確認する必要があります。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.2
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性 なし
使用できる値 truefalse

<Movie>
  ...
  <JP_Require18PlusAgeConfirmation>true</JP_Require18PlusAgeConfirmation>
</Movie>

↑先頭に戻る

Language

省略可能

作品が最初に制作された言語。音声言語を指す場合と、サイレント作品の画面上に表示されるテキスト言語を指す場合とがあります。指定できるLanguage要素は各作品につき1つだけです。吹き替えオプションを指定するには、AudioLanguageも使用します。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性 なし
使用できる値 標準のXML/HTML言語コード(enen-USfrfr-FRなど)

<Movie>
  ...
  <Language>ja</Language>
  ...
</Movie>

↑先頭に戻る

LaunchDetails

省略可能

作品の特定の視聴方法で利用できるビデオ画質、音声言語、字幕オプションを指定する要素が格納されます。LaunchDetailsに含まれるLaunchIdという要素(省略可能)を使用すると、あらかじめ決まった画質、言語、字幕の構成で作品の再生を開始できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.2
親要素 SubscriptionOfferFreeOfferPurchaseOfferRentalOffer
子要素

省略可能: QualityAudioLanguageSubtitleLaunchId

属性 なし

<FreeOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <LaunchDetails>
    <Quality>SD</Quality>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <AudioLanguage>fr-FR</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
</FreeOffer>

↑先頭に戻る

LaunchId

省略可能

あらかじめ決まった画質、音声言語、字幕の構成で(またはそれらを一部組み合わせて)作品を再生するための識別子。LaunchIdに決まった形式はありませんが、開発者のアプリのロジックで確実に認識できる形式にしてください。各LaunchDetails要素に追加できるLaunchIdは1つだけです。複数のLaunchIdを指定するには、複数のLaunchDetails要素を追加する必要があります。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.2
親要素 LaunchDetails
子要素 なし
属性 なし

<SubscriptionOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <LaunchDetails>
    <Quality>SD</Quality>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <AudioLanguage>fr-FR</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
  <LaunchDetails>
    <Quality>SD</Quality>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <AudioLanguage>fr-FR</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <LaunchId>EXTRA-11113_SD_fr-FR_en-US</LaunchId>
  </LaunchDetails>
</SubscriptionOffer>

↑先頭に戻る

MaxValue

省略可能条件付きで必須

作品に対する視聴者の評価として指定できる最高スコア。指定できるMaxValueは、各CustomerRatingにつき1つだけです。

プロパティ 詳細
使用 省略可能
必須となる条件 CustomerRating要素(省略可能)が存在する場合は必須
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性 なし

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

↑先頭に戻る

MiniSeries

省略可能

MiniSeriesは基本的な作品タイプの1つです。シーズンとしては提供されない、少数の一連のエピソードから成るテレビ番組として大まかに定義されます。MiniSeriesに指定できるエピソード数に明示的な制限はありませんが、常識的な数のエピソードに限定してください。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.3
親要素 Catalog
子要素

必須: IDOffersTitle

省略可能: AdultProductColorContentRatingsJP_Require18PlusAgeConfirmationCopyrightCreditsCustomerRatingExternalID, GenresImageUrlLanguageRankReleaseInfoShortDescriptionReleaseYearRuntimeMinutesSourceStudiosSynopsis

この要素のみに固有の子要素

省略可能: ReleaseDate

属性 なし

<MiniSeries>
  <ID>MS-2329880</ID>
  <Title locale="en-US">All the Best People</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <ReleaseDate>2005-04-29T20:00:00</ReleaseDate>
</MiniSeries>

↑先頭に戻る

MiniSeriesEpisode

省略可能

MiniSeriesEpisodeは基本的な作品タイプの1つで、MiniSeries内の単一のエピソードを表します。このコンテンツはシーズンには関連付けられず、MiniSeriesとの関連で順序付けされます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.3
親要素 Catalog
子要素

必須: IDOffersTitle

省略可能: AdultProductColorContentRatingsJP_Require18PlusAgeConfirmationCopyrightCreditsCustomerRatingExternalIDGenresImageUrlLanguageRankReleaseInfoShortDescriptionReleaseYearRuntimeMinutesSourceStudiosSynopsis

注意: MiniSeriesIDまたはMiniSeriesTitleのいずれか。

この要素のみに固有の子要素

必須: EpisodeInSeriesMiniSeriesIDMiniSeriesTitle

省略可能: OriginalAirDate

属性 なし

<MiniSeries>
  <ID>MS-123456789</ID>
  ...
</MiniSeries>
<MiniSeriesEpisode>
  <ID>MSE-2329880</ID>
  <Title locale="en-US">The First Steps on a New Planet</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <MiniSeriesID>MS-123456789</MiniSeriesID>
  <EpisodeInSeries>1</EpisodeInSeries>
  <OriginalAirDate>2012-07-02T20:00:00</OriginalAirDate>
</MiniSeriesEpisode>

↑先頭に戻る

MiniSeriesID

省略可能条件付きで必須

エピソードの従属先となっているミニシリーズを指定するための要素です。このIDMiniSeriesが、このMiniSeriesEpisodeと同じカタログに存在している必要があります。ミニシリーズはMiniSeriesIDまたはMiniSeriesTitleを使用して指定できますが、両方を使用することはできません。カタログにミニシリーズが存在する場合は、必ずMiniSeriesIDを使用します。カタログに存在しない場合は、MiniSeries項目を作成して使用することをお勧めします。

プロパティ 詳細
使用 省略可能
必須となる条件 MiniSeriesTitle要素が存在しない場合は必須
追加 CDFバージョン1.3
親要素 MiniSeriesEpisode
子要素 なし
属性 なし

<MiniSeries>
  <ID>MS-2329880</ID>
  ...
</MiniSeries>
</MiniSeriesEpisode>
  ...
  <MiniSeriesID>MS-2329880</MiniSeriesID>
  <EpisodeInSeries>3</EpisodeInSeries>
</MiniSeriesEpisode>

↑先頭に戻る

MiniSeriesTitle

条件付きで必須

ミニシリーズがカタログに含まれていない場合にエピソードの従属先となるミニシリーズを指定します。MiniSeriesTitleは単にUIに使用される文字列であり、カタログ内の既存のタイトルと一致している必要はありません。ミニシリーズはMiniSeriesIDまたはMiniSeriesTitleを使用して指定できますが、両方を使用することはできません。MiniSeriesTitleMiniSeriesIDが存在しない場合にのみ使用します(ごくまれなケースです)。

プロパティ 詳細
使用 省略可能
必須となる条件 MiniSeriesID要素が存在しない場合は必須
追加 CDFバージョン1.3
親要素 MiniSeriesEpisode
子要素 なし
属性 なし

<MiniSeriesEpisode>
  ...
  <MiniSeriesTitle>Cats, The Most Beautiful Creature</MiniSeriesTitle>
  <EpisodeInSeries>3</EpisodeInSeries>
</MiniSeriesEpisode>

↑先頭に戻る

Movie

省略可能

Movieは基本的な作品タイプの1つで、短編映画にも使用されますが、通常は長編映画を表します。作品は劇場向けの映画でも、テレビ用の映画でもかまいません。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 Catalog
子要素

必須: IDOffersTitle

省略可能: AdultProductColorContentRatingsJP_Require18PlusAgeConfirmationCopyrightCreditsCustomerRatingExternalIDGenresImageUrlLanguageRankReleaseInfoShortDescriptionReleaseYearRuntimeMinutesSourceStudiosSynopsis

この要素のみに固有の子要素

省略可能: ReleaseDate

属性 なし

<Movie>
  <ID>MV-123456</ID>
  <Title locale="en-US">Chase the Prawns</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <ReleaseDate>2013-10-04T00:00:00</ReleaseDate>
</Movie>

↑先頭に戻る

Name

条件付きで必須

作品のキャストまたはクルーの名前。キャストの場合は、役柄の名前ではなく、その俳優の名前です。

プロパティ 詳細
使用 省略可能
必須となる条件 CastMember要素またはCrewMember要素で必須
追加 CDFバージョン1.0
親要素 CastMemberCrewMember
子要素 なし
属性
locale(必須)
  • この文字列を使用するデバイスまたはソフトウェアの言語設定。
  • 使用できる値: 標準のXML/HTML言語コード(enen-USfrfr-FRなど)
pronunciation(省略可能)
  • 要素のテキストが漢字で表記される場合に使用されます。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には通常、発音の情報をひらがなで指定します。
  • 使用できる値: 文字列

<CastMember>
  <Name locale="en-US">Alan Smithee</Name>
  ...
</CastMember>

↑先頭に戻る

Offers

常に必須

視聴者が特定の作品を再生できる方法(無料、サービスの定期購入、レンタル、購入のいずれか)を表します。指定できるOffers要素は作品タイプごとに1つのみで、そのOffers要素には少なくとも1つの視聴方法タイプを追加する必要があります。

プロパティ 詳細
使用 必須
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素

省略可能: SubscriptionOfferFreeOfferPurchaseOfferRentalOffer

属性 なし

<Offers>
  <FreeOffer>
    <Regions>
      <Country>CA</Country>
    </Regions>
    <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
    <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
    <LaunchDetails>
      <Quality>SD</Quality>
    </LaunchDetails>
  </FreeOffer>
  <SubscriptionOffer>
    <Regions>
      <Country>CA</Country>
    </Regions>
    <LaunchDetails>
      <Quality>HD</Quality>
    </LaunchDetails>
  </SubscriptionOffer>
</Offers>

↑先頭に戻る

OriginalAirDate

省略可能

作品が最初にテレビで放送された日時。ReleaseYear(省略可能)が存在する場合、この値の年部分がReleaseYearと一致している必要があります。この情報は、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.3
親要素 TvEpisodeTvSpecialMiniSeriesEpisode
子要素 なし
属性 なし
使用できる値 XMLのdateTime値。この値の形式はYYYY-MM-DDThh:mm:ssです。YYYY-MM-DDは年、月、日を、hh:mm:ssは時、分、秒を表します。Tはその2つの区切りとなります。年から秒までの値全体を指定する必要があります。時刻値が不明な場合は単に00:00:00とします。UTCとのオフセットを値の最後に追加して特定のタイムゾーンを示すこともできます。

<TvSpecial>
  ...
  <OriginalAirDate>2012-05-13T00:00:00</OriginalAirDate>
</TvSpecial>

↑先頭に戻る

Partner

常に必須

このカタログのプロバイダーを識別します。決められた形式はありませんが、人が判読できる形式にすることをお勧めします。たとえば、Amazonアプリストアに表示されるアプリ名をそのまま使用するのも1つの方法です。プロバイダーのフルネームを使用することもできます。個々のカタログファイルにPartner要素が1つ必要です。

プロパティ 詳細
使用 必須
追加 CDFバージョン1.0
親要素 Catalog
子要素 なし
属性 なし

<Catalog xmlns="http://www.amazon.com/FireTv/2014-04-11/ingestion" version="FireTv-v1.3">
  <Partner>Everything Ever Made Filmworks</Partner>
  ...
<Catalog>

↑先頭に戻る

Price

省略可能条件付きで必須

作品のレンタルまたは購入にかかる費用。

プロパティ 詳細
使用 省略可能
必須となる条件 PurchaseOfferRentalOfferで必須
追加 CDFバージョン1.0
親要素 PurchaseOfferRentalOffer
子要素 なし
属性
currency(必須)
  • 価格の通貨。指定できる通貨は、視聴方法タイプごとに1つだけ(ドル、ポンド、円、ユーロのいずれか)です。
  • 使用できる値: USDGBPJPYEUR

<PurchaseOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <Price currency="USD">1.99</Price>
</PurchaseOffer>

↑先頭に戻る

PurchaseOffer

条件付きで必須

4つある視聴方法タイプの1つで、作品を購入することで視聴できます。1回購入すれば、作品を所有していつでも視聴できます。必要に応じて、Offersに複数のPurchaseOffer要素を追加できます。現時点では、Fire TVはディスプレイ内のPurchaseOffer情報に対して何も行いません。

プロパティ 詳細
使用 省略可能
必須となる条件 省略可能(ただし、Offersには少なくとも1つの視聴方法タイプが必須)
追加 CDFバージョン1.0
親要素 Offers
子要素

必須: RegionsPrice

省略可能: LaunchDetailsQualityWindowStartWindowEnd

属性 なし

<PurchaseOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
  </LaunchDetails>
  <Price currency="USD">1.99</Price>
</PurchaseOffer>

↑先頭に戻る

Quality

省略可能

作品の画質を表します。標準解像度(SD)、高解像度(HD)、超高解像度(UHD)があります。1つの作品を複数の画質オプションで提供できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.2
親要素 LaunchDetails
子要素 なし
属性 なし
使用できる値 SDHDUHD

<FreeOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <LaunchDetails>
    <Quality>HD</Quality>
    <Quality>UHD</Quality>
  </LaunchDetails>
</FreeOffer>

↑先頭に戻る

Rank

省略可能(指定することを強く推奨)

カタログ内のほかのアイテムに対する相対的な数値で人気を示したスコアです。最高ランクは1として定義されます。ランクの決め方は自由です。複数のアイテムに同じランクを割り当ててもかまいません。1つの作品に割り当てることのできるRank要素は1つだけです。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性 なし

<TvShow>
  ...
  <Rank>36</Rank>
  ...
</TvShow>

↑先頭に戻る

Regions

常に必須

特定の視聴方法が利用できる国を表します。指定できるRegions要素は各視聴方法タイプにつき1つだけです。

プロパティ 詳細
使用 必須
追加 CDFバージョン1.0
親要素 SubscriptionOfferFreeOfferPurchaseOfferRentalOffer
子要素

必須: Country

注意: 少なくとも1つのCountryが必須

属性 なし

<FreeOffer>
  <Regions>
    <Country>US</Country>
    <Country>CA</Country>
    <Country>MX</Country>
  </Regions>
</FreeOffer>

↑先頭に戻る

RelatesToExternalID

省略可能

Extra(映画のトレーラーなど)が関連付けられているほかの作品(そのトレーラーの本編となる映画など)を指定するために使用します。外部ソース(IMDbなど)の分類に基づくほかの作品(映画など)を判別するための識別子は、RelatesToExternalIDで指定します。RelatesToExternalIDは、関連付けられている作品が同じカタログに存在しない場合に使用します。関連付けはRelatesToIDまたはRelatesToExternalIDを使用して指定できますが、両方を使用することはできません。RelatesToExternalIDは、RelatesToIDが存在しない場合にのみ使用します。

RelatesToExternalIDExternalIDを混同しないでください。ExternalIDExtraそのものを指すのに対し、RelatesToExternalIDはそれに関連付けられている作品を指します。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.3
親要素 Extra
子要素 なし
属性
scheme(必須)
  • このIDの提供元となった外部ソース。
  • 使用できる値:
    • imdb: Internet Movie Database(IMDb)。IDは、特定のページのURLの構成要素として存在します。
    • tms: GracenoteTMデータベースで使用されているID。
    • isan: International Standard Audiovisual Number(ISAN)。26文字の英数字で、通常はダッシュ区切りで表示されます。
    • ean: International Article Number(EAN)。通常は13桁のバーコードです。
    • upc: Universal Product Code(UPC)。通常は12桁のバーコードです。

<Extra>
  ...
  <Type>trailer</Type>
  <RelatesToExternalID scheme="imdb">tt0000000</RelatesToExternalID>
  <RelatesToExternalID scheme="tms">MV000000000000</RelatesToExternalID>
  <RelatesToExternalID scheme="isan">0000-0000-0F00-0000-X-0000-0000-Y</RelatesToExternalID>
  <RelatesToExternalID scheme="ean">0011559514120</RelatesToExternalID>
  <RelatesToExternalID scheme="upc">123456789990</RelatesToExternalID>
</Extra>

↑先頭に戻る

RelatesToID

省略可能

Extra(映画のトレーラーなど)が関連付けられているほかの作品(そのトレーラーの本編となる映画など)を指定するために使用します。このIDの作品が、このExtraと同じカタログに存在している必要があります。関連付ける作品はRelatesToIDまたはRelatesToExternalIDを使用して指定できますが、両方を使用することはできません。関連付ける作品がカタログに存在する場合は、必ずRelatesToIDを使用します。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.3
親要素 Extra
子要素 なし
属性 なし

<TvShow>
  <ID>TV123456</ID>
  ...
</TvShow>
<Extra>
  ...
  <Type>trailer</Type>
  <RelatesToID>TV123456</RelatesToID>
</Extra>

↑先頭に戻る

ReleaseCountry

省略可能廃止

廃止されました。使用しないでください。 この要素に代わる要素はありません。CDFバージョン1.3で廃止されました。

プロパティ 詳細
使用 廃止、使用不可
追加 CDFバージョン1.0
廃止 true
親要素 ReleaseInfo
子要素 なし
属性 なし
使用できる値 次に示すISO 3166国コードのサブセットを使用できます。 AF AX AL DZ AS AD AO AI AQ AG AR AM AW AU AT AZ BS BH BD BB BY BE BZ BJ BM BT BO BQ BA BW BV BR IO BN BG BF BI KH CM CA CV KY CF TD CL CN CX CC CO KM CG CD CK CR CI HR CU CW CY CZ DK DJ DM DO EC EG SV GQ ER EE ET FK FO FJ FI FR GF PF TF GA GM GE DE GH GI GR GL GD GP GU GT GG GN GW GY HT HM VA HN HK HU IS IN ID IR IQ IE IM IL IT JM JP JE JO KZ KE KI KP KR KW KG LA LV LB LS LR LY LI LT LU MO MK MG MW MY MV ML MT MH MQ MR MU YT MX FM MD MC MN ME MS MA MZ MM NA NR NP NL NC NZ NI NE NG NU NF MP NO OM PK PW PS PA PG PY PE PH PN PL PT PR QA RE RO RU RW BL SH KN LC MF PM VC WS SM ST SA SN RS SC SL SG SX SK SI SB SO ZA GS SS ES LK SD SR SJ SZ SE CH SY TW TJ TZ TH TL TG TK TO TT TN TR TM TC TV UG UA AE GB US UM UY UZ VU VE VN VG VI WF EH YE ZM ZW

<TvEpisode>
  ...
  <ReleaseInfo>
    <ReleaseDate>2002-02-20</ReleaseDate>
    <ReleaseCountry>BT</ReleaseCountry>
  </ReleaseInfo>
  ...
</TvEpisode>

↑先頭に戻る

ReleaseDate

作品が最初に一般公開(テレビの場合は初回放映)された日時。ReleaseYear(省略可能)が存在する場合、この値の年部分がReleaseYearと一致している必要があります。この情報は特に、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.3
親要素 MovieTvShowMiniSeries
子要素 なし
属性 なし
使用できる値 XMLのdateTime値。この値の形式はYYYY-MM-DDThh:mm:ssです。YYYY-MM-DDは年、月、日を、hh:mm:ssは時、分、秒を表します。Tはその2つの区切りとなります。年から秒までの値全体を指定する必要があります。時刻値が不明な場合は単に00:00:00とします。UTCとのオフセットを値の最後に追加して特定のタイムゾーンを示すこともできます。

<TvShow>
  ...
  <ReleaseDate>2012-05-13T00:00:00</ReleaseDate>
</TvShow>

↑先頭に戻る

ReleaseDate

廃止

作品が最初に一般公開(テレビの場合は初回放映)された日付。ReleaseYear(省略可能)が存在する場合、この値の年部分がReleaseYearと一致している必要があります。この情報は特に、この作品をほかのカタログ内のコンテンツとマッチングするときに役立ちます。コンテンツをマッチングすることで、同じ作品について何度も検索しなくても、その作品を視聴できるすべての提供元を単一のリストで表示できます。

プロパティ 詳細
使用 廃止、使用不可
追加 CDFバージョン1.0
廃止 true
親要素 ReleaseInfo
子要素 なし
属性 なし
使用できる値 XMLのdate値。この値の形式はYYYY-MM-DD(年、月、日)です。

<TvShow>
  ...
  <ReleaseInfo>
    <ReleaseDate>2012-05-13</ReleaseDate>
  </ReleaseInfo>
</TvShow>

↑先頭に戻る

ReleaseInfo

省略可能廃止

作品のリリース先となる国または地域とリリース日を指定する要素が格納されます。

プロパティ 詳細
使用 廃止、使用不可
追加 CDFバージョン1.0
廃止 true
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
属性 なし

<TvEpisode>
  ...
  <ReleaseInfo>
    <ReleaseDate>2002-02-20</ReleaseDate>
    <ReleaseCountry>BT</ReleaseCountry>
  </ReleaseInfo>
  ...
</TvEpisode>

↑先頭に戻る

ReleaseYear

省略可能(指定することを強く推奨)

省略可能(ただし指定することを強く推奨)作品が最初に一般公開(テレビの場合は初回放映)された年。この値は、同じ作品のReleaseDateまたはOriginalAirDate要素に指定されている年と一致している必要があります。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性 なし

<TvEpisode>
  ...
  <ReleaseYear>1959</Releaseyear>
  ...
</TvEpisode>

↑先頭に戻る

RentalOffer

省略可能条件付きで必須

4つある視聴方法タイプの1つで、1回の支払いで限られた期間だけ作品を視聴できます。必要に応じて、Offersに複数のRentalOffer要素を追加することができます。現時点では、Fire TVはディスプレイ内のRentalOffer情報に対して何も行いません。

プロパティ 詳細
使用 省略可能
必須となる条件 省略可能(ただし、Offersには少なくとも1つの視聴方法タイプが必須)
追加 CDFバージョン1.0
親要素 Offers
子要素

必須: RegionsPriceDuration

省略可能: LaunchDetailsQualityWindowStartWindowEnd

属性 なし

<RentalOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
  </LaunchDetails>
  <Price currency="USD">1.99</Price>
  <Duration>120</Duration>
</RentalOffer>

↑先頭に戻る

Role

省略可能

作品の中でCastMemberが演じる役柄の名前。たとえば、ロビン・フッド、湖のランスロ、アテナ、セルフなどと指定します。この値に「actor」や「unknown」は使用しないでください。CastMember項目はすべて俳優(actor)です。1人で複数の役柄を演じている場合、CastMember要素に複数のRole要素を追加できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 CastMember
子要素 なし
属性
locale(必須)
  • この文字列を使用するデバイスまたはソフトウェアの言語設定。
  • 使用できる値: 標準のXML/HTML言語コード(enen-USfrfr-FRなど)
pronunciation(省略可能)
  • 要素のテキストが漢字で表記される場合に使用されます。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には通常、発音の情報をひらがなで指定します。
  • 使用できる値: 文字列

<Credits>
  <CastMember>
    <Name locale="en-US">Alan Smithee</Name>
    <ExternalID scheme="imdb">tt0000000</ExternalID>
    <Role locale="en-US">Robin Hood</Role>
    <Role locale="en-US">Self</Role>
  </CastMember>
</Credits>

↑先頭に戻る

RuntimeMinutes

省略可能

コンテンツ全体の実行時間(分単位)。通常は、2880よりも小さい正の数です。まれに2880を超えることもあります。指定できるRuntimeMinutes要素は各作品につき1つだけです。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性 なし

<TvEpisode>
  ...
  <RuntimeMinutes>37</RuntimeMinutes>
  ...
</TvEpisode>

↑先頭に戻る

Score

省略可能条件付きで必須

視聴者のフィードバックに基づく作品の平均スコア(評価)。この値の収集方法は自由です。レーティングシステムの尺度となるMaxValueに応じて決めてください。スコアに寄与した投票の数を表すCount(省略可能)を追加することもできます。CustomerRatingに指定できるScoreは1つだけです。

プロパティ 詳細
使用 省略可能
必須となる条件 CustomerRatingで必須
追加 CDFバージョン1.0
親要素 CustomerRating
子要素 なし
属性 なし

<CustomerRating>
  <Score>8.2</Score>
  <MaxValue>10</MaxValue>
  <Count>512</Count>
</CustomerRating>

↑先頭に戻る

SeasonID

省略可能条件付きで必須

TVEpisodeの従属先となるシーズンのID。このIDTVSeasonが、このTvEpisodeと同じカタログに存在している必要があります。シーズンはSeasonIDまたはSeasonInShowを使用して指定できますが、両方を使用することはできません。該当するシーズンがカタログに存在する場合は、必ずSeasonIDを使用します。存在しない場合は、TvSeason項目の作成を検討してください。

プロパティ 詳細
使用 省略可能
必須となる条件 SeasonInShow要素が存在しない場合は必須
追加 CDFバージョン1.0
親要素 TvEpisode
子要素 なし
属性 なし

<TvSeason>
  <ID>SEA-2329880</ID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <SeasonID>SEA-2329880</SeasonID>
  ...
</TvEpisode>

↑先頭に戻る

SeasonInShow

省略可能条件付きで必須

TVEpisodeの従属先シーズンの番号。従属先シーズンがカタログに存在しない場合に使用されます。SeasonInShowは単にUIで使用される番号であり、何かと一致している必要はありません。シーズンはSeasonIDまたはSeasonInShowを使用して指定できますが、両方を使用することはできません。SeasonInShowSeasonIDが存在しない場合にのみ使用します(ごくまれなケースです)。

プロパティ 詳細
使用 省略可能
必須となる条件 SeasonID要素が存在しない場合は必須
追加 CDFバージョン1.0
親要素 TvEpisode
子要素 なし
属性 なし

<TvEpisode>
  ...
  <SeasonInShow>2</SeasonInShow>
  ...
</TvEpisode>

↑先頭に戻る

SeasonTitle

省略可能

TvEpisodeが従属するシーズンのタイトル(「Season 2」など)。対応するTvSeason要素がカタログに含まれている場合、必ずしもこの値をそのTitleと一致させる必要はありません。指定できるSeasonTitle要素は各TvEpisodeにつき1つだけです。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 TvEpisode
子要素 なし
属性
locale(必須)
  • この文字列を使用するデバイスまたはソフトウェアの言語設定。
  • 使用できる値: 標準のXML/HTML言語コード(enen-USfrfr-FRなど)
pronunciation(省略可能)
  • 要素のテキストが漢字で表記される場合に使用されます。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には通常、発音の情報をひらがなで指定します。
  • 使用できる値: 文字列

<TvEpisode>
  ...
  <SeasonInShow>2</SeasonInShow>
  <SeasonTitle locale="en-US">Season 2</SeasonTitle>
  ...
</TvEpisode>

↑先頭に戻る

ShortDescription

省略可能

作品の内容についての2~3行の説明。ShortDescriptionにほかの場所で確認できる情報(作品のタイトルなど)は指定しないでください。ローカライズされた説明を提供するため、1つの作品に複数のShortDescription要素を追加できます。より長く詳しい説明を入力するには、Synopsis要素を使用してください。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性
locale(必須)
  • この文字列を使用するデバイスまたはソフトウェアの言語設定。
  • 使用できる値: 標準のXML/HTML言語コード(enen-USfrfr-FRなど)
pronunciation(省略可能)
  • 要素のテキストが漢字で表記される場合に使用されます。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には通常、発音の情報をひらがなで指定します。
  • 使用できる値: 文字列

<TvSpecial>
  ...
  <ShortDescription locale="en-US">Alan shows us some trees and sings songs about them.</ShortDescription>
  ...
</TvSpecial>

↑先頭に戻る

ShowID

省略可能条件付きで必須

TvEpisodeTvSeasonTvSpecialをカタログ内のTvShowに関連付けるために使用されます。この値は、TvShow要素のID値と一致している必要があります。番組はShowIDまたはShowTitleを使用して指定できますが、両方を使用することはできません。カタログにTvShowが存在するときは、必ずShowIDを使用します。

プロパティ 詳細
使用 省略可能
必須となる条件 TvEpisodeTvSeasonShowTitleが存在しない場合は必須。TvSpecialの場合は省略可能。
追加 CDFバージョン1.0
親要素 TvSeasonTvEpisodeTvSpecial
子要素 なし
属性 なし

<TvShow>
  <ID>TV-2329880</ID>
  ...
</TvShow>
<TvSeason>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <ShowID>TV-2329880</ShowID>
  ...
</TvEpisode>

↑先頭に戻る

ShowTitle

省略可能条件付きで必須

TvEpisodeTvSeasonTvSpecialをカタログ内のTvShowに関連付けるために使用されます。この値は単にUIで使用される文字列であり、カタログ内のタイトルと一致している必要はありません。番組はShowIDまたはShowTitleを使用して指定できますが、両方を使用することはできません。ShowTitleは、ShowIDが存在しない場合にのみ使用します。

プロパティ 詳細
使用 省略可能
必須となる条件 TvEpisodeTvSeasonShowIDが存在しない場合は必須。TvSpecialの場合は省略可能。
追加 CDFバージョン1.0
親要素 TvSeasonTvEpisodeTvSpecial
子要素 なし
属性
locale(必須)
  • この文字列を使用するデバイスまたはソフトウェアの言語設定。
  • 使用できる値: 標準のXML/HTML言語コード(enen-USfrfr-FRなど)
pronunciation(省略可能)
  • 要素のテキストが漢字で表記される場合に使用されます。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には通常、発音の情報をひらがなで指定します。
  • 使用できる値: 文字列

<TvSeason>
  ...
  <ShowTitle locale="en-US">Depth of Field</ShowTitle>
  ...
</TvSeason>

↑先頭に戻る

Source

省略可能(指定することを強く推奨)

作品の提供元。指定できるSourceは各作品につき1つだけです。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性 なし
使用できる値
  • original: このカタログのプロバイダーによって製作・制作されたコンテンツ。
  • licensed: このカタログのプロバイダーがサードパーティからライセンスを取得した作品。
  • unknown: 提供元が不明なコンテンツ。
  • other: 提供元は判明しているがoriginalにもlicensedにも該当しない作品。

<MiniSeriesEpisode>
  ...
  <Source>licensed</Source>
  ...
</MiniSeriesEpisode>

↑先頭に戻る

Studio

省略可能条件付きで必須

作品が制作されたスタジオ。Studio項目は、1つの作品に複数割り当てることができます。

プロパティ 詳細
使用 省略可能
必須となる条件 Studios要素(省略可能)で必須
追加 CDFバージョン1.0
親要素 Studios
子要素 なし
属性 なし

<TvEpisode>
  ...
  <Studios>
    <Studio>Amazon Studios</Studio>
    <Studio>Another Production Company</Studio>
  </Studios>
  ...
</TvEpisode>

↑先頭に戻る

Studios

省略可能

作品が制作されたスタジオを識別するStudio要素が格納されます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素

必須: Studio

注意: 少なくとも1つは必要

属性 なし

<TvEpisode>
  ...
  <Studios>
    <Studio>Amazon Studios</Studio>
    <Studio>Another Production Company</Studio>
  </Studios>
  ...
</TvEpisode>

↑先頭に戻る

SubscriptionOffer

省略可能条件付きで必須

4つある視聴方法タイプの1つで、プロバイダーのサービスの会員が作品を視聴できます。必要に応じて、Offersに複数のSubscriptionOffer要素を追加できます。

プロパティ 詳細
使用 省略可能
必須となる条件 省略可能(ただし、Offersには少なくとも1つの視聴方法タイプが必須)
追加 CDFバージョン1.0
親要素 Offers
子要素

必須: Regions

省略可能: LaunchDetailsQualityWindowStartWindowEnd

属性 なし

<SubscriptionOffer>
  <Regions>
    <Country>US</Country>
    <Country>CA</Country>
  </Regions>
  <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
  <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>en-US</Subtitle>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
    <LaunchId>EXTRA-11113_HD_en-US</LaunchId>
  </LaunchDetails>
</SubscriptionOffer>

↑先頭に戻る

Subtitle

作品の字幕の言語オプション。字幕オプションは、1つの作品に複数割り当てることができます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.2
親要素 LaunchDetails
子要素 なし
属性 なし
使用できる値 標準のXML/HTML言語コード(enen-USfrfr-FRなど)

<SubscriptionOffer>
  <Regions>
    <Country>US</Country>
  </Regions>
  <LaunchDetails>
    <Quality>HD</Quality>
    <AudioLanguage>en-US</AudioLanguage>
    <Subtitle>fr</Subtitle>
    <Subtitle>es</Subtitle>
  </LaunchDetails>
</SubscriptionOffer>

↑先頭に戻る

Synopsis

省略可能

作品の内容に関する説明。Synopsisは、ShortDescriptionよりも詳しい情報を提供するための要素です。ShortDescriptionや作品のTitleSynopsisとして使用することは避けてください。ローカライズされた説明を提供するため、1つの作品に複数のSynopsis要素を追加できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性
locale(必須)
  • この文字列を使用するデバイスまたはソフトウェアの言語設定。
  • 使用できる値: 標準のXML/HTML言語コード(enen-USfrfr-FRなど)
pronunciation(省略可能)
  • 要素のテキストが漢字で表記される場合に使用されます。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には通常、発音の情報をひらがなで指定します。
  • 使用できる値: 文字列

<TvSpecial>
  ...
  <ShortDescription locale="en-US">Alan shows us some trees and sings songs about them.</ShortDescription>
  <Synopsis locale="en-US">Alan Smithee, man about town and fervent urban arborist, takes us on a musical journey around his home town, stopping by some favorite trees to sing about them.As expected from Mr. Smithee, no path runs straight and his plans meander as he encounters guest stars and battles a lumberjack with a literal ax to grind.</Synopsis>
  ...
</TvSpecial>

↑先頭に戻る

System

省略可能条件付きで必須

作品を評価したレーティングシステム(通常は公式の評価機関)。指定できるSystemは各評価につき1つだけです。

プロパティ 詳細
使用 省略可能
必須となる条件 ContentRatingで必須
追加 CDFバージョン1.0
親要素 ContentRating
子要素 なし
属性 なし

<ContentRatings>
  <ContentRating>
    <System>MPAA</System>
    <Certification>G</Certification>
  </ContentRating>
</ContentRatings>

↑先頭に戻る

Title

作品のタイトル。ローカライズされたタイトルを提供するため、1つの作品に複数のTitle要素を追加できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra
子要素 なし
属性
locale(必須)
  • この文字列を使用するデバイスまたはソフトウェアの言語設定。
  • 使用できる値: 標準のXML/HTML言語コード(enen-USfrfr-FRなど)
pronunciation(省略可能)
  • 要素のテキストが漢字で表記される場合に使用されます。日本語のソート順は、文字ではなく発音(漢字からは特定不可能)に基づいて決まります。pronunciation属性には通常、発音の情報をひらがなで指定します。
  • 使用できる値: 文字列

<TvShow>
  <ID>TV123456</ID>
  <Title locale="en-US">Office Factor</Title>
  ...
</TvShow>

↑先頭に戻る

TvEpisode

省略可能

TvEpisodeは基本的な作品タイプの1つで、TvShowの単一のエピソードを表します。通常、TvSeasonにも関連付けられます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 Catalog
子要素

必須: IDOffersTitle

省略可能: AdultProductColorContentRatingsJP_Require18PlusAgeConfirmationCopyrightCreditsCustomerRatingExternalIDGenresImageUrlLanguageRankReleaseInfoShortDescriptionReleaseYearRuntimeMinutesSourceStudiosSynopsis

この要素のみに固有の子要素

必須: ShowIDShowTitleSeasonIDSeasonInShowEpisodeInSeason

省略可能: SeasonTitleOriginalAirDate

注意: ShowIDまたはShowTitleのどちらか一方のみで、両方は指定できません。また、SeasonIDまたはSeasonInShowのどちらか一方のみで、両方は指定できません。

属性 なし

<TvShow>
  <ID>ABC-123457</ID>
  ...
</TvShow>
<TvSeason>
  <ID>TVS-987654</ID>
  ...
</TvSeason>
<TvEpisode>
  <ID>TVE2329880</ID>
  <Title locale="en-US">What's in a Name?</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <ShowID>ABC-123457</ShowID>
  <SeasonID>TVS-987654</SeasonInShow>
  <EpisodeInSeason>5</EpisodeInSeason>
</TvEpisode>

↑先頭に戻る

TvSeason

省略可能

TvSeasonは基本的な作品タイプの1つで、TvShowの単一のエピソードを表します。TvEpisodeSeasonID値がそのTvSeasonIDと同じである場合、そのエピソードがそのシーズンに属していることを表します。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 Catalog
子要素

必須: IDOffersTitle

省略可能: AdultProductColorContentRatingsJP_Require18PlusAgeConfirmationCopyrightCreditsCustomerRatingExternalIDGenresImageUrlLanguageRankReleaseInfoShortDescriptionReleaseYearRuntimeMinutesSourceStudiosSynopsis

この要素のみに固有の子要素

必須: ShowIDShowTitleSeasonInShow

注意: ShowIDまたはShowTitleのどちらか一方のみで、両方は指定できません。

属性 なし

<TvShow>
  <ID>ABC-123457</ID>
  ...
</TvShow>
<TvSeason>
  <ID>TVS2329880</ID>
  <Title locale="en-US">Season Five</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <ShowID>ABC-123457</ShowID>
  <SeasonInShow>5</SeasonInShow>
</TvSeason>
<TvEpisode>
  ...
  <ShowID>ABC-123457</ShowID>
  <SeasonID>TVS2329880</SeasonID>
  ...
</TvEpisode>

↑先頭に戻る

TvShow

省略可能

TvShowは基本的な作品タイプの1つで、シーズンとエピソードから成るテレビシリーズです。通常の一連のエピソードとは別に特別番組に関連付けられる場合もあります。TvSeasonTvEpisodeTvSpecialShowID値がそのTvShowのIDと同じである場合、そのシーズン、エピソード、特別番組はそのTvShowに属していることを表します。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 Catalog
子要素

必須: IDOffersTitle

省略可能: AdultProductColorContentRatingsJP_Require18PlusAgeConfirmationCopyrightCreditsCustomerRatingExternalIDGenresImageUrlLanguageRankReleaseInfoShortDescriptionReleaseYearRuntimeMinutesSourceStudiosSynopsis

この要素のみに固有の子要素

省略可能: ReleaseDate

属性 なし

<TvShow>
  <ID>RS-2329880</ID>
  <Title locale="en-US">Office Factor</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
</TvShow>
<TvSeason>
  <ID>TVS2329880</ID>
  ...
  <ShowID>RS-2329880</ShowID>
  ...
</TvSeason>
<TvEpisode>
  ...
  <ShowID>RS-2329880</ShowID>
  <SeasonID>TVS2329880</SeasonID>
  ...
</TvEpisode>

↑先頭に戻る

TvSpecial

省略可能

TvSpecialは基本的な作品タイプの1つで、テレビで放送されるイベントのうち、従来の番組-シーズン-エピソードというテレビ階層には該当しないイベントに適用されます。1回限りのイベント(休日特番など)のほか、各エピソードにエピソード番号ではなく一意の放映日が割り当てられている番組(ニュース番組など)が該当します。TvSpecialは、TvShowに関連付けることができるほか(ただしTvSeasonへの関連付けは不可)、単発の番組として存在する場合もあります。また、授賞式関連の番組や、テレビコンサート、回顧録も該当します。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 Catalog
子要素

必須: IDOffersTitle

省略可能: AdultProductColorContentRatingsJP_Require18PlusAgeConfirmationCopyrightCreditsCustomerRatingExternalIDGenresImageUrlLanguageRankReleaseInfoShortDescriptionReleaseYearRuntimeMinutesSourceStudiosSynopsis

この要素のみに固有の子要素

必須: OriginalAirDate

省略可能: ShowIDShowTitle

注意: OriginalAirDateはCDF v1.3で追加されました。ShowIDまたはShowTitleのどちらか一方のみで、両方は指定できません。

属性 なし

<TvSpecial>
  <ID>SP-2329880</ID>
  <Title locale="en-US">Cheese -- Friend or Enemy?</Title>
  <Offers>
    <SubscriptionOffer>
      <Regions>
        <Country>US</Country>
      </Regions>
    </SubscriptionOffer>
  </Offers>
  <OriginalAirDate>2005-04-29T20:00:00</OriginalAirDate>
</TvSpecial>

↑先頭に戻る

タイプ

常に必須

Extraをトレーラー(プレビュー)またはクリップとして指定します。Extraが関連付けられているMovieのメイキングドキュメンタリーのように大規模なものもありますが、トレーラー以外はすべてクリップと見なしてかまいません。指定できるTypeは各Extraにつき1つだけです。

プロパティ 詳細
使用 必須
追加 CDFバージョン1.3
親要素 Extra
子要素 なし
属性 なし
使用できる値 cliptrailer

<Extra>
  ..
  <Type>trailer</Type>
  ...
</Extra>

↑先頭に戻る

WindowEnd

省略可能

特定の視聴方法で作品が視聴できなくなる日時。指定できるWindowEndは各視聴方法につき1つだけです。WindowStartWindowEndを使用して、その視聴方法を利用できる期間を指定できます。WindowEndで指定した期限を過ぎると、対象の視聴者にはその視聴方法が表示されなくなります。すべての視聴方法の期限が切れると、作品そのものが表示されなくなります。

WindowStartWindowEndを個別または組み合わせて使用して、特定の視聴方法における作品の視聴期間を制御できます。

  • WindowStartのみ: 指定された日時以降、作品がカタログから削除されるまで無期限に作品を視聴できます。
  • WindowEndのみ: 作品は直ちに視聴できますが、視聴できるのは指定された日時までです。
  • WindowStartWindowEndの両方を指定した場合: 指定された期間のみ作品を視聴できます。
  • WindowStartWindowEndも指定しない場合: 作品は直ちに視聴できるようになり、カタログから削除されるまで無期限に作品を視聴できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 SubscriptionOfferFreeOfferPurchaseOfferRentalOffer
子要素 なし
属性 なし
使用できる値 XMLのdateTime値。この値の形式はYYYY-MM-DDThh:mm:ssです。YYYY-MM-DDは年、月、日を、hh:mm:ssは時、分、秒を表します。Tはその2つの区切りとなります。年から秒までの値全体を指定する必要があります。時刻値が不明な場合は単に00:00:00とします。UTCとのオフセットを値の最後に追加して特定のタイムゾーンを示すこともできます。

<FreeOffer>
  ...
  <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
  <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
  ...
</FreeOffer>

↑先頭に戻る

WindowStart

省略可能

特定の視聴方法で作品が視聴できるようになる日時。WindowStartWindowEndを使用して、その視聴方法を利用できる期間を指定できます。その期間の前後は、その視聴方法が視聴者に表示されません。その時点で利用できる視聴方法がなければ、作品そのものが表示されなくなります。指定できるWindowStartは各視聴方法につき1つだけです。

WindowStartWindowEndを個別または組み合わせて使用して、特定の視聴方法における作品の視聴期間を制御できます。

  • WindowStartのみ: 指定された日時以降、作品がカタログから削除されるまで無期限に作品を視聴できます。
  • WindowEndのみ: 作品は直ちに視聴できますが、視聴できるのは指定された日時までです。
  • WindowStartWindowEndの両方を指定した場合: 指定された期間のみ作品を視聴できます。
  • WindowStartWindowEndも指定しない場合: 作品は直ちに視聴できるようになり、カタログから削除されるまで無期限に作品を視聴できます。

プロパティ 詳細
使用 省略可能
追加 CDFバージョン1.0
親要素 SubscriptionOfferFreeOfferPurchaseOfferRentalOffer
子要素 なし
属性 なし
使用できる値 XMLのdateTime値。この値の形式はYYYY-MM-DDThh:mm:ssです。YYYY-MM-DDは年、月、日を、hh:mm:ssは時、分、秒を表します。Tはその2つの区切りとなります。年から秒までの値全体を指定する必要があります。時刻値が不明な場合は単に00:00:00とします。UTCとのオフセットを値の最後に追加して特定のタイムゾーンを示すこともできます。

<FreeOffer>
  ...
  <WindowStart>2014-02-06T12:00:00-07:00</WindowStart>
  <WindowEnd>2016-01-01T07:00:00-07:00</WindowEnd>
  ...
</FreeOffer>

↑先頭に戻る

Works

常に必須

カタログ内の個々の項目(映画、テレビ番組、シーズン、特別番組、ミニシリーズ、エピソード、トレーラーやクリップ)がすべて格納されます。個々のカタログファイルには、Works要素が1つ存在している必要があります。Works要素には、作品の項目を必要に応じていくつでも追加できます。また、各タイプも必要に応じていくつでも追加できます。

プロパティ 詳細
使用 必須
追加 CDFバージョン1.0
親要素 Catalog
子要素

省略可能: MovieTvShowTvSeasonTvEpisodeTvSpecialMiniSeriesMiniSeriesEpisodeExtra

属性 なし

<Catalog>
  <Partner>Everything Ever Made Filmworks</Partner>
  <Works>
    ...
  </Works>
</Catalog>

↑先頭に戻る