動画プログラムの属性は、コンテンツのタイプによって異なります。プログラム タイプは、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_WIDTH
と VIDEO_HEIGHT
を使用します。