Dodawanie programów na kanale Warte obejrzenia

Kanał „Warte obejrzenia” to drugi wiersz na ekranie głównym, po wierszu aplikacji. System utworzy i będzie utrzymywać ten kanał. Aplikacja może dodawać programy do kanału Warte obejrzenia: programy, które użytkownik oznaczył jako ciekawe, przestały oglądać w środku lub są związane z oglądanymi przez niego treściami (np. następny odcinek serialu lub kolejny sezon serialu).

Na kanale Warte obejrzenia są pewne ograniczenia: aplikacja nie może przenosić, usuwać ani ukrywać wiersza Warte obejrzenia.

Kroki

Wstawianie programów na kanale Warte obejrzenia przypomina dodawanie programów na własnym kanale. Poniżej znajdziesz szczegółowe informacje na temat sekcji Warte obejrzenia.

Publikowanie treści na kanale Warte obejrzenia w Google TV (wyświetlane jako „Oglądaj dalej”) wymaga wcześniejszego zatwierdzenia przez Google w ramach procesu certyfikacji. Wykorzystuje również przetwarzanie po stronie serwera do sortowania programów na podstawie ich atrybutów. Aby rozpocząć proces certyfikacji, prześlij ten formularz.

Podczas umieszczania treści na kanale Warte obejrzenia musisz przestrzegać tych wytycznych:

Wybierz typ programu

Istnieją 4 typy programów Warte obejrzenia. Wybierz odpowiedni typ:

TypUwagi
WATCH_NEXT_TYPE_CONTINUEUżytkownik zatrzymał się podczas oglądania treści.
WATCH_NEXT_TYPE_NEXTDostępny jest kolejny dostępny program z serii, który może oglądać użytkownik. Jeśli np. użytkownik ogląda 3 odcinek serialu, aplikacja może zaproponować mu obejrzenie 4 odcinka jako następnego.
WATCH_NEXT_TYPE_NEWDostępne są teraz nowe treści, które wyraźnie pokazują, 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_WATCHLISTWstawiane przez system lub aplikację, gdy użytkownik zapisze program.

Więcej informacji znajdziesz w artykule Atrybuty Warte obejrzenia.

Używanie kreatora WatchNextProgram

Użyj konta WatchNextProgram.Builder. Więcej informacji znajdziesz w artykule o atrybutach w sekcji Warte obejrzenia.

Kotlin

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())

Java

WatchNextProgram.Builder builder = new 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);

Uri watchNextProgramUri = context.getContentResolver()
        .insert(TvContractCompat.WatchNextPrograms.CONTENT_URI, builder.build().toContentValues());

Użyj TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId), aby utworzyć Uri, którego potrzebujesz do aktualizacji 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 informowania aplikacji o dodaniu programu. Intencja zawiera 2 dodatkowe elementy: identyfikator programu, który został skopiowany, oraz identyfikator programu utworzony dla programu na kanale Warte obejrzenia.