動画プログラムの属性は、コンテンツのタイプによって異なります。プログラム タイプは、どのようなメタデータが予期されるかをシステムに知らせて、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 | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| タイトル | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| 動画の高さ | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| 動画の幅 | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
| 重量 | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） | （✔） |
プレビュー画像
プレビュー画像の推奨サイズは次のとおりです。
| 属性 | アスペクト比 | 幅 | 高さ |
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 を使用して、プレビュー動画の正確なサイズを指定できます。