Wskazówki dla deweloperów aplikacji na temat sekcji Warte obejrzenia

Przestrzegaj tych wytycznych podczas wstawiania treści na kanale Warte obejrzenia.

Rodzaje treści, które można umieścić na kanale Warte obejrzenia

Ogranicz automatyczne aktualizacje aplikacji do tradycyjnych filmów i programów telewizyjnych. Nie dodawaj klipów ani innych krótkich treści.

Uwzględnij niedokończone filmy

Dodaj niedokończone filmy do kanału Warte obejrzenia za pomocą TYPE_MOVIE. Film jest nieukończony, jeśli rozpoczął się, ale nie został dokończony zgodnie z tymi wytycznymi:

  • Film zaczyna się, gdy użytkownik obejrzy co najmniej 3% lub 2 minuty (w zależności od tego, która sygnatura czasowa przypada wcześniej).
  • Film jest zakończony, jeśli zaczynają się napisy końcowe. W takim przypadku nie dodawaj filmu do kanału Warte obejrzenia. Możesz określić ten stan za pomocą technologii, która automatycznie wykrywa napisy końcowe, lub skorzystać z orientacji opartej na długości filmu.

Uwzględnij niedokończone odcinki seriali telewizyjnych

Dodawanie niedokończonych odcinków programów telewizyjnych do kanału Warte obejrzenia za pomocą pola TYPE_TV_EPISODE. Odcinek nie dokończy się, jeśli się rozpoczął, ale nie zakończył się zgodnie z tymi wytycznymi:

  • Odcinek rozpoczyna się, gdy widz obejrzy ponad 2 minuty.
  • Odcinek kończy się, jeśli zaczynają się napisy końcowe. W takim przypadku nie dodawaj filmu do kanału Warte obejrzenia. Możesz określić ten stan za pomocą technologii, która automatycznie wykrywa napisy końcowe, lub skorzystać z orientacji przybliżonej na podstawie długości treści, np. gdy pozostanie mniej niż 3 minuty w odcinku.

Obsługuj nowe odcinki i kolejne odcinki

dodawać nowe odcinki i kolejne odcinki seriali rozpoczynających się od użytkownika (zgodnie z tymi wytycznymi) do kanału Warte obejrzenia za pomocą TYPE_TV_EPISODE:

  • Użytkownik rozpoczyna odtwarzanie serii, jeśli obejrzy dowolny odcinek serialu przez ponad 2 minuty, czyli minutę po zakończeniu wprowadzenia.
  • Jeśli użytkownik rozpoczyna odtwarzanie serialu i kończy jeden z jego odcinków, a w Twojej usłudze dostępny jest kolejny odcinek, dodaj kolejny odcinek do kanału Warte obejrzenia za pomocą funkcji WATCH_NEXT_TYPE_NEXT.
  • Jeśli użytkownik obejrzy wszystkie aktualne odcinki serialu i zostanie udostępniony nowy sezon lub odcinek, dodaj nowy odcinek do kanału Warte obejrzenia za pomocą funkcji WATCH_NEXT_TYPE_NEW. Dodaj nowy odcinek bez względu na to, ile czasu minęło od ostatniego oglądania serialu przez użytkownika (np. po roku lub później).

Kiedy dodawać filmy do kanału Warte obejrzenia

Zgodnie z tymi wytycznymi na kanale Warte obejrzenia możesz dodawać niedokończone treści i nowe odcinki oglądanych wcześniej seriali.

Kiedy dodawać nieukończone treści

Jeśli użytkownik ma niedokończone treści, dodaj je do kanału Obejrzyj następny w jednej z tych sytuacji:

  • Użytkownik zamyka aplikację na Androidzie TV.
  • użytkownik wstrzymuje lub zatrzymuje odtwarzanie fragmentu treści na ponad 5 minut;

W takich przypadkach opublikuj wszelkie niedokończone treści od razu (maksymalny czas oczekiwania to 5 sekund). Na przykład: gdy użytkownik wyjdzie z aplikacji na Androida TV, w ciągu 5 sekund opublikujesz wszystkie niedokończone produkty za pomocą interfejsu API Warte obejrzenia w ciągu 5 sekund.

Publikuj na Androidzie TV dowolne niedokończone treści za pomocą interfejsu Watch Next API, niezależnie od tego, gdzie zostały obejrzane. Jeśli na przykład użytkownik obejrzy film w przeglądarce Chrome i wstrzyma odtwarzanie, aplikacja na Androidzie TV musi natychmiast opublikować niedokończoną treść na Androidzie TV z maksymalnym opóźnieniem 5 sekund.

Kiedy dodawać nowe odcinki

Dodaj nowe odcinki wcześniej obejrzanego serialu od razu, gdy są spełnione wszystkie te warunki:

  • Nowy odcinek jest dostępny w Twojej usłudze.
  • użytkownik kończy poprzedni odcinek,
  • Użytkownik ma prawo obejrzeć nowy odcinek.

Dodaj nowy odcinek bez względu na to, ile czasu minęło od ostatniego oglądania serialu przez użytkownika (np. po roku lub później).

Możliwość udostępniania treści i aktualizacji interfejsu

Aby treści mogły zostać opublikowane na kanale Warte obejrzenia, użytkownik musi wejść w interakcję z treściami w aplikacji.

Nie dodawaj więcej niż 1 odcinka z tego samego serialu telewizyjnego. Nie dodawaj np. niedokończonego odcinka i nowego odcinka z tej samej serii.

Nie aktualizuj wszystkich elementów w wierszu Następne po zmianie jednego elementu. Tylko: aktualizuj element, z którym użytkownik wszedł w interakcję od ostatniej aktualizacji.

Jakie dane należy uwzględnić w przypadku elementu „Warte obejrzenia”.

W przypadku każdego elementu „Warte obejrzenia” uwzględnij te elementy:

  • Typ „Warte obejrzenia”
  • Ostatnia pozycja odtwarzania
  • Czas działania
  • Czas ostatniego zaangażowania
  • Atrybuty programu wideo: oprócz wymaganych atrybutów oznaczonych w tabeli atrybutów programu wideo dla każdego programu musisz ustawić atrybut Content ID. Atrybut Content ID musi być zgodny z wewnętrznym identyfikatorem podanym w pliku danych Media Actions. Dzięki temu Android TV będzie mógł skuteczniej uzgadniać zasoby i zapewnić użytkownikom wysoki poziom ufności.

Usuwanie treści z kanału Warte obejrzenia

Usuń treści, gdy użytkownik skończy oglądać film lub gdy nie będzie już dostępnych nieobejrzanych odcinków serialu telewizyjnego.