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

Podczas wstawiania treści do kanału Warte obejrzenia postępuj zgodnie z tymi wskazówkami.

Rodzaje treści, które należy uwzględnić na kanale Warte obejrzenia

Ogranicz programowe dodawanie treści w aplikacji do tradycyjnych filmów i seriali. Nie dodawaj klipów ani innych krótkich treści.

Uwzględnianie nieobejrzanych filmów

Dodaj nieobejrzane filmy do kanału Warte obejrzenia, używając TYPE_MOVIE. Film jest nieukończony, jeśli użytkownik zaczął go oglądać, ale nie obejrzał do końca. Obowiązują te wytyczne:

  • Film jest uznawany za rozpoczęty, jeśli użytkownik obejrzy ponad 3% lub 2 minuty, w zależności od tego, który moment nastąpi wcześniej.
  • Film jest uznawany za obejrzany, jeśli zaczną się napisy końcowe. W takim przypadku nie dodawaj go do kanału Warte obejrzenia. Ten stan możesz określić za pomocą technologii, która automatycznie wykrywa napisy końcowe, lub użyć przybliżenia na podstawie długości treści.

Uwzględnianie nieobejrzanych odcinków seriali

Dodaj nieobejrzane odcinki seriali do kanału Warte obejrzenia, używając TYPE_TV_EPISODE. Odcinek jest nieukończony, jeśli został rozpoczęty, ale nie ukończony zgodnie z poniższymi wytycznymi:

  • Odcinek jest uznawany za rozpoczęty, jeśli użytkownik obejrzy ponad 2 minuty.
  • Odcinek jest uznawany za obejrzany, jeśli zaczną się napisy końcowe. W takim przypadku nie dodawaj go do kanału Warte obejrzenia. Ten stan możesz określić za pomocą technologii, która automatycznie wykrywa napisy końcowe, lub użyć przybliżenia na podstawie długości treści, np. jeśli do końca odcinka pozostały mniej niż 3 minuty.

Obsługa nowych i następnych odcinków seriali

Dodaj nowe i następne odcinki seriali, które użytkownik zaczął oglądać, do kanału Warte obejrzenia, używając TYPE_TV_EPISODE. Obowiązują te wytyczne:

  • Użytkownik zaczyna oglądać serial, jeśli obejrzy ponad 2 minuty lub 1 minutę po zakończeniu wprowadzenia dowolnego odcinka serialu.
  • Jeśli użytkownik zacznie oglądać serial i obejrzy odcinek do końca, a następny odcinek serialu jest dostępny w Twojej usłudze, dodaj ten następny odcinek do kanału Warte obejrzenia, używając WATCH_NEXT_TYPE_NEXT.
  • Jeśli użytkownik obejrzał wszystkie aktualne odcinki serialu i pojawi się nowy sezon lub odcinek, dodaj ten nowy odcinek do kanału Warte obejrzenia , używając WATCH_NEXT_TYPE_NEW. Dodaj nowy odcinek niezależnie od tego, jak długo użytkownik nie oglądał serialu, np. po roku lub dłużej.

Kiedy dodawać element do kanału Warte obejrzenia

Dodaj nieobejrzane treści i nowe odcinki wcześniej oglądanych seriali do kanału Warte obejrzenia zgodnie z tymi wytycznymi.

Kiedy dodawać nieukończone treści

Gdy użytkownik ma nieukończoną treść, dodaj tę treść do kanału Warte obejrzenia natychmiast, gdy wystąpi jedna z tych sytuacji:

  • Użytkownik zamknie aplikację na Androidzie TV.
  • Użytkownik wstrzyma lub zatrzyma odtwarzanie treści na ponad 5 minut.

W takich sytuacjach opublikuj nieukończone treści natychmiast, z maksymalnym opóźnieniem wynoszącym 5 sekund. Jeśli np. użytkownik zamknie aplikację na Androidzie TV, opublikuj wszystkie nieobejrzane elementy za pomocą interfejsu Watch Next API w ciągu 5 sekund.

Opublikuj wszystkie nieobejrzane treści na Androidzie TV za pomocą interfejsu Watch Next API niezależnie od tego, gdzie użytkownik je oglądał. Jeśli np. użytkownik ogląda film w przeglądarce Chrome i wstrzymuje odtwarzanie, aplikacja na Androidzie TV musi natychmiast opublikować nieobejrzaną treść na Androidzie TV, z maksymalnym opóźnieniem wynoszącym 5 sekund.

Kiedy dodawać nowe odcinki

Dodaj nowe odcinki wcześniej oglądanego serialu natychmiast, gdy spełnione są wszystkie te warunki:

  • Nowy odcinek jest dostępny w Twojej usłudze.
  • Użytkownik obejrzy poprzedni odcinek do końca.
  • Użytkownik ma uprawnienia do oglądania nowego odcinka.

Dodaj nowy odcinek niezależnie od tego, jak długo użytkownik nie oglądał serialu, np. po roku lub dłużej.

Kwalifikowanie się treści i aktualizacje interfejsu

Aby treść mogła zostać opublikowana na kanale Warte obejrzenia, użytkownik musi wejść z nią w interakcję w Twojej aplikacji.

Nie dodawaj więcej niż 1 odcinka tego samego serialu telewizyjnego. Nie dodawaj np. nieobejrzanego odcinka i nowego odcinka tego samego serialu.

Nie aktualizuj wszystkich elementów w wierszu Odtwórz następny , gdy zmieni się jeden element. Aktualizuj tylko element, z którym użytkownik wszedł w interakcję od czasu ostatniej aktualizacji.

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

W przypadku każdego elementu Warte obejrzenia uwzględnij te informacje:

  • Typ Warte obejrzenia
  • Ostatnia pozycja odtwarzania
  • Czas trwania
  • Czas ostatniego działania związanego z zaangażowaniem
  • Atrybuty programu wideo: oprócz wymaganych atrybutów oznaczonych w tabeli atrybutów programu wideo dla każdego programu wideo należy 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 może skuteczniej dopasowywać zasoby i zapewniać użytkownikom funkcję o wysokim poziomie pewności.

Usuwanie treści z kanału Warte obejrzenia

Usuń treść, gdy użytkownik obejrzy film do końca lub gdy nie ma dostępnego nieobejrzanego odcinka serialu telewizyjnego.