動画プログラムの属性

動画プログラムの属性は、コンテンツのタイプによって異なります。プログラム タイプは、UI を適切に入力できるように想定されるメタデータをシステムに伝えます。

動画番組のタイプは次のいずれかです。

PreviewProgram.Builder を使用してプログラムを作成します。各フィールドの指定可能な値については、ビルダーの各セッターのリファレンス ドキュメントをご覧ください。

Kotlin

val program = PreviewProgram.Builder()
        .setChannelId(channelId)
        .setTitle(clip.getTitle())
        .setDescription(clip.getDescription())
        .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
        // Set required attributes
        .build()

Java

PreviewProgram program = new PreviewProgram.Builder()
        .setChannelId(channelId)
        .setTitle(clip.getTitle())
        .setDescription(clip.getDescription())
        .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
        // Set required attributes
        .build();

次の表に、各タイプの動画プログラムに割り当てることができる属性を示します。各属性は、PreviewProgram.Builder 内の対応するセッターにリンクされています。 が付いている属性は必須、(✔) が付いている属性はオプションです。

属性 映画 テレビシリーズ テレビ番組のシーズン テレビ番組のエピソード クリップ イベント チャンネル
作成者 (✔)
利用可能な国と地域 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
正規ジャンル (✔)(✔)(✔)(✔)
チャンネル ID
Content ID (✔)
コンテンツのレーティング (✔)(✔) (✔)(✔) (✔)(✔)(✔)
再生時間(ミリ秒) (✔)
エピソード番号
エピソードのタイトル (✔)
ジャンル (✔)(✔) (✔)(✔)
インテント URI
インタラクション数 (✔)(✔)
インタラクション タイプ (✔)(✔)
内部プロバイダ ID (✔)(✔)(✔)(✔)(✔)(✔)(✔)
アイテム数(✔) (✔)
ライブ (✔)(✔)(✔)(✔)(✔)
ロゴ URI(*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
ロゴコンテンツの説明(*) (✔)(✔)(✔)(✔)(✔)(✔)(✔)
特典の価格 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
ポスターアートのアスペクト比
ポスターアート URI
プレビュー動画 URI (✔)(✔)(✔)(✔)(✔)(✔)(✔)
リリース日 (✔)(✔)(✔)(✔)(✔)(✔)
レビュー評価 (✔)(✔)(✔)(✔)(✔)
レビュー評価のスタイル (✔)(✔)(✔)(✔)(✔)
シーズン表示番号
簡単な説明 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
開始時刻(UTC、ミリ秒)(*)
終了時刻(UTC、ミリ秒)(*)
初回価格 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
サムネイルのアスペクト比 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
サムネイル URI (✔)(✔)(✔)(✔)(✔)(✔)(✔)
Title
動画の高さ (✔)(✔)(✔)(✔)(✔)(✔)(✔)
動画の幅 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
重量 (✔)(✔)(✔)(✔)(✔)(✔)(✔)
プレビュー画像

プレビュー画像に推奨されるサイズは次のとおりです。

属性 アスペクト比 高さ
ASPECT_RATIO_16_9 16:9 272 dp 153 dp
ASPECT_RATIO_3_2 3:2 229.5 dp 153 dp
ASPECT_RATIO_4_3 4:3 204 dp 153 dp
ASPECT_RATIO_1_1 1 対 1 153 dp 153 dp
ASPECT_RATIO_2_3 2:3 102 dp 153 dp
ASPECT_RATIO_MOVIE_POSTER 1:1.441 106 dp 153 dp

最適な画質を得るには、この表で指定されているサイズ以上の 16:9 または 4:3 のプレビュー動画を使用してください。最適なユーザー エクスペリエンスを提供するには、不透明なロゴを使用します。

プレビュー用動画の正確なサイズを指定するには、VIDEO_WIDTHVIDEO_HEIGHT を使用します。