Kanał Warte obejrzenia to drugi wiersz, który pojawia się na ekranie głównym, po wierszu aplikacji. Ten kanał jest tworzony i zarządzany przez system. Twoja aplikacja może dodawać programy do kanału Warte obejrzenia: programy, które użytkownik oznaczył jako interesujące, przestał oglądać w połowie lub które są powiązane z treściami, które użytkownik ogląda (np. kolejny odcinek serialu lub kolejny sezon programu).
Kanał Warte obejrzenia ma pewne ograniczenia: aplikacja nie może przenosić, usuwać ani ukrywać wiersza kanału Warte obejrzenia.
Kroki
Wstawianie programów do kanału Warte obejrzenia jest podobne do wstawiania programów do własnego kanału. Szczegółowe informacje o sekcji Warte obejrzenia znajdziesz w sekcjach poniżej.
Podczas wstawiania treści do kanału Warte obejrzenia musisz przestrzegać tych wytycznych:
- Wskazówki dotyczące sekcji Warte obejrzenia dla deweloperów aplikacji
- Wytyczne dotyczące sekcji Warte obejrzenia dla dostawców telewizji
Wybierz typ programu
Istnieją 4 rodzaje programów Warte obejrzenia. Wybierz odpowiedni typ:
| Typ | Uwagi |
|---|---|
WATCH_NEXT_TYPE_CONTINUE |
Użytkownik zatrzymał się podczas oglądania treści. |
WATCH_NEXT_TYPE_NEXT |
Dostępny jest następny program z serii, którą ogląda użytkownik. Jeśli na przykład użytkownik ogląda trzeci odcinek serialu, aplikacja może zasugerować mu obejrzenie czwartego odcinka. |
WATCH_NEXT_TYPE_NEW |
Już jest dostępna nowa treść, która wyraźnie nawiązuje do tego, co ogląda użytkownik. Na przykład użytkownik ogląda odcinek 5 serialu, a odcinek 6 staje się dostępny do obejrzenia. |
WATCH_NEXT_TYPE_WATCHLIST |
Wstawiane przez system lub aplikację, gdy użytkownik zapisuje program. |
Więcej informacji znajdziesz w artykule Atrybuty Warte obejrzenia.
Używanie kreatora WatchNextProgram
Użyj WatchNextProgram.Builder. Więcej informacji znajdziesz w artykule Atrybuty Warte obejrzenia.
val builder = WatchNextProgram.Builder() builder.setType(TvContractCompat.WatchNextPrograms.TYPE_MOVIE) .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE) .setLastEngagementTimeUtcMillis(time) .setTitle("Title") .setDescription("Program description") .setPosterArtUri(uri) .setIntentUri(uri) .setInternalProviderId(appProgramId) val watchNextProgramUri = context.contentResolver .insert( TvContractCompat.WatchNextPrograms.CONTENT_URI, builder.build().toContentValues() )
Użyj TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId), aby utworzyć Uri, który jest potrzebny do zaktualizowania programu Warte obejrzenia.
Gdy użytkownik doda program do kanału Warte obejrzenia, system skopiuje go do wiersza. Wysyła intencję TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT, aby powiadomić aplikację o dodaniu programu. Intencja zawiera 2 dodatkowe elementy: skopiowany identyfikator programu i identyfikator programu utworzony dla programu na kanale Warte obejrzenia.