Atrybuty programu wideo zależą od rodzaju jego zawartości. Typ programu informuje system, jakich metadanych oczekiwać, aby interfejs użytkownika mógł zostać odpowiednio wypełniony.
Programy wideo mogą być jednego z następujących typów:
Użyj PreviewProgram.Builder, aby utworzyć program. Więcej informacji na temat możliwych wartości dla każdego pola można znaleźć w dokumentacji referencyjnej każdego settera w konstruktorze.
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();
W tabeli poniżej znajdziesz atrybuty, które można przypisać do każdego typu programu wideo. Każdy atrybut jest połączony z odpowiednim setterem w PreviewProgram.Builder.
Atrybuty oznaczone ✔ są wymagane; te oznaczone (✔) są opcjonalne.
| Atrybut | Film | Serial telewizyjny | Sezon TV | Odcinek telewizyjny | Klip | Zdarzenie | Kanał |
|---|---|---|---|---|---|---|---|
| Autor | (✔) | ||||||
| Dostępność | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Gatunki kanoniczne | (✔) | (✔) | (✔) | (✔) | |||
| Identyfikator kanału | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| System Content ID | (✔) | ||||||
| Oceny treści | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| DurationMillis | ✔ | ✔ | ✔ | (✔) | |||
| Numer odcinka | ✔ | ||||||
| Tytuł odcinka | (✔) | ||||||
| Gatunek | (✔) | (✔) | (✔) | (✔) | |||
| Identyfikator URI intencji | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Liczba interakcji | (✔) | (✔) | |||||
| Typ interakcji | (✔) | (✔) | |||||
| Wewnętrzny identyfikator dostawcy | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Liczba elementów | (✔) | (✔) | |||||
| Na żywo | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Identyfikator URI logo (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Opis treści logo (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Cena oferty | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Format obrazu plakatu | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Identyfikator URI grafiki plakatu | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Identyfikator URI filmu z podglądem | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Data wydania | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| Ocena recenzji | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Styl oceniania recenzji | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| Numer sezonu | ✔ | ✔ | |||||
| Short Description | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Czas rozpoczęcia UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| Czas zakończenia UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| Cena początkowa | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Format miniatury | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Identyfikator URI miniatury | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Title | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Wysokość wideo | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Szerokość wideo | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Waga | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
Podgląd obrazów
Zalecane rozmiary obrazów podglądowych są następujące:
| Atrybut | Format obrazu | Szerokość | Wysokość |
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 |
Aby uzyskać najlepszą jakość, używaj filmów podglądowych w formacie 16:9 lub 4:3, które mają co najmniej rozmiary podane w tej tabeli. Aby zapewnić użytkownikom jak najlepsze wrażenia, używaj nieprzezroczystego logo.
Dokładne rozmiary podglądu wideo można określić za pomocą VIDEO_WIDTH i VIDEO_HEIGHT.