動画プログラムの属性は、コンテンツのタイプによって異なります。プログラム タイプは、どのようなメタデータが予期されるかをシステムに知らせて、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 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| コンテンツ ID | （✔） | ||||||
| コンテンツのレーティング | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| 再生時間（ミリ秒） | ✔ | ✔ | ✔ | （✔） | |||
| エピソード番号 | ✔ | ||||||
| エピソードのタイトル | （✔） | ||||||
| ジャンル | （✔） | （✔） | （✔） | （✔） | |||
| インテント URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| インタラクション数 | （✔） | （✔） | |||||
| インタラクション タイプ | （✔） | （✔） | |||||
| 内部プロバイダ ID | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| アイテム数 | （✔） | （✔） | |||||
| ライブ | （✔） | （✔） | （✔） | （✔） | （✔） | ||
| ロゴ URI（*） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| ロゴコンテンツの説明（*） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| 特典の価格 | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| ポスターアートのアスペクト比 | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| ポスターアート URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| プレビュー動画 URI | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| リリース日 | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | |
| レビュー評価 | （✔） | （✔） | （✔） | （✔） | （✔） | ||
| レビュー評価のスタイル | （✔） | （✔） | （✔） | （✔） | （✔） | ||
| シーズン表示番号 | ✔ | ✔ | |||||
| 概要 | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| 開始時刻（UTC、ミリ秒）（*） | ✔ | ✔ | ✔ | ✔ | |||
| 終了時刻（UTC、ミリ秒）（*） | ✔ | ✔ | ✔ | ✔ | |||
| 初回価格 | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| サムネイルのアスペクト比 | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| サムネイル URI | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| タイトル | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| 動画の高さ | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| 動画の幅 | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| 重量 | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
プレビュー画像
プレビュー画像の推奨サイズは次のとおりです。
| 属性 | アスペクト比 | 幅 | 高さ |
| 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_WIDTH（動画の幅）と VIDEO_HEIGHT（動画の高さ）を使用すると、プレビュー動画の正確なサイズを指定できます。