動画プログラムの属性

動画プログラムの属性は、コンテンツのタイプによって異なります。プログラム タイプは、どのようなメタデータが予期されるかをシステムに知らせて、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(動画の高さ)を使用すると、プレビュー動画の正確なサイズを指定できます。