Dodawanie programów na kanale Warte obejrzenia

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:

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.