Atribut program video bergantung pada jenis kontennya. Jenis program tersebut memberi tahu sistem metadata apa yang diharapkan agar UI dapat diisi dengan benar. Program video dapat berupa salah satu dari jenis berikut:
Gunakan PreviewProgram.Builder untuk membuat program. Anda dapat membaca lebih lanjut mengenai nilai-nilai yang memungkinkan bagi masing-masing kolom di dokumen referensi untuk setiap penyetel pada 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();
Tabel berikut menampilkan atribut yang dapat ditetapkan ke setiap jenis program video dan link untuk penyetel terkait di PreviewProgram.Builder. Atribut yang ditandai dengan ✔ bersifat wajib, sedangkan atribut yang ditandai (✔) bersifat opsional:
| Atribut | Film | Serial Televisi | Season TV | Episode TV | Klip | Acara | Channel |
|---|---|---|---|---|---|---|---|
| Penulis | (✔) | ||||||
| Ketersediaan | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Genre Kanonis | (✔) | (✔) | (✔) | (✔) | |||
| ID Channel | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| ID Konten | (✔) | ||||||
| Rating Konten | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| DurationMillis | ✔ | ✔ | ✔ | (✔) | |||
| Nomor Episode | ✔ | ||||||
| Judul Episode | (✔) | ||||||
| Genre | (✔) | (✔) | (✔) | (✔) | |||
| URI Intent | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Hitungan Interaksi | (✔) | (✔) | |||||
| Jenis Interaksi | (✔) | (✔) | |||||
| ID Penyedia Internal | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Hitungan Item | (✔) | (✔) | |||||
| Live | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Logo URI (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Logo Deskripsi Konten (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Harga Penawaran | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Rasio Tinggi Lebar Gambar Poster | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| URI Seni Poster | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| URI Video Pratinjau | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Tanggal Rilis | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| Rating Ulasan | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Gaya Rating Ulasan | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Nomor Tampilan Season | ✔ | ✔ | |||||
| Deskripsi Singkat | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Waktu Mulai UTC dalam Milidetik (*) | ✔ | ✔ | ✔ | ✔ | |||
| Waktu Berakhir UTC dalam Milidetik (*) | ✔ | ✔ | ✔ | ✔ | |||
| Harga Awal | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Rasio Tinggi Lebar Thumbnail | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| URI Thumbnail | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Judul | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Tinggi Video | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Lebar Video | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Berat | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
Gambar pratinjau
Ukuran yang disarankan untuk gambar pratinjau adalah:
| Atribut | Rasio Tinggi Lebar | Lebar | Tinggi |
| ASPECT_RATIO_16_9 | 16:9 | 272dp | 153dp |
| ASPECT_RATIO_3_2 | 3:2 | 229,5dp | 153dp |
| ASPECT_RATIO_4_3 | 4:3 | 204dp | 153dp |
| ASPECT_RATIO_1_1 | 1:1 | 153dp | 153dp |
| ASPECT_RATIO_2_3 | 2:3 | 102dp | 153dp |
| ASPECT_RATIO_MOVIE_POSTER | 1:1,441 | 106dp | 153dp |
Untuk kualitas terbaik, video pratinjau harus 16:9 atau 4:3 dan setidaknya berukuran yang ditentukan dalam tabel di atas. Logo juga harus berjenis opaque untuk pengalaman pengguna terbaik.
Anda dapat menentukan ukuran video pratinjau yang tepat menggunakan VIDEO_WIDTH dan VIDEO_HEIGHT.