Diretrizes do "Assistir a seguir" para desenvolvedores de apps

Siga estas diretrizes ao inserir conteúdo no canal "Assistir a seguir".

Tipos de conteúdo a serem incluídos no canal "Assistir a seguir"

Limite as adições programáticas do seu app a filmes e programas de TV tradicionais. Não adicione clipes e outros conteúdos curtos.

Incluir filmes inacabados

Adicione filmes inacabados ao canal "Assistir a seguir" usando TYPE_MOVIE. Um filme é considerado inacabado se for iniciado, mas não concluído, de acordo com as seguintes diretrizes:

  • Um filme é iniciado se o usuário assistir mais de 3% ou 2 minutos, o que acontecer primeiro.
  • Um filme é concluído se os créditos finais começarem. Nesse caso, não adicione o filme ao canal "Assistir a seguir". É possível determinar esse estado usando uma tecnologia de detecção automática dos créditos finais ou uma estimativa com base na duração do conteúdo.

Incluir episódios de TV inacabados

Adicione episódios de TV inacabados ao canal "Assistir a seguir" usando TYPE_TV_EPISODE. Um episódio é considerado inacabado se for iniciado, mas não concluído, de acordo com as seguintes diretrizes:

  • Um episódio é iniciado se o usuário assistir mais de 2 minutos.
  • Um episódio é concluído se os créditos finais começarem. Nesse caso, não adicione o episódio ao canal "Assistir a seguir". É possível determinar esse estado usando uma tecnologia de detecção automática dos créditos finais ou uma estimativa com base na duração do conteúdo, por exemplo, quando houver menos de 3 minutos restantes no episódio.

Como gerenciar os episódios de TV futuros e novos

Adicione os episódios futuros e novos de séries que o usuário iniciou, com base em nas seguintes diretrizes, ao canal "Assistir a seguir" usando TYPE_TV_EPISODE:

  • O usuário inicia uma série se assistir mais de 2 minutos ou 1 minuto após a conclusão da introdução de qualquer episódio da série.
  • Se o usuário iniciar uma série e terminar um episódio, e se o próximo episódio da série estiver disponível no seu serviço, adicione-o ao canal "Assistir a seguir" usando WATCH_NEXT_TYPE_NEXT.
  • Se o usuário estiver em dia com todos os episódios atuais de uma série e uma nova temporada ou episódio ficar disponível, adicione esse novo episódio ao canal "Assistir a seguir" usando WATCH_NEXT_TYPE_NEW. Adicione o novo episódio, não importa quanto tempo tenha passado desde que o usuário assistiu a série pela última vez, por exemplo, após um ano ou mais.

Quando adicionar um item ao canal "Assistir a seguir"

Adicione conteúdo inacabado e novos episódios de séries visualizadas anteriormente ao canal "Assistir a seguir" de acordo com as diretrizes a seguir.

Quando adicionar conteúdo inacabado

Quando um usuário tiver um conteúdo inacabado, adicione-o ao canal "Assistir a seguir" imediatamente em qualquer das seguintes situações:

  • O usuário sai do app no Android TV.
  • O usuário pausa ou interrompe a reprodução de um conteúdo por mais de 5 minutos.

Nesses cenários, publique qualquer conteúdo inacabado imediatamente, com uma latência máxima de 5 segundos. Por exemplo, quando o usuário sair do app Android TV, publique todos os itens inacabados usando a API Watch Next em 5 segundos.

Publique qualquer conteúdo inacabado no Android TV usando a API Watch Next, independentemente de onde a visualização ocorreu. Por exemplo, se o usuário assistir um filme no navegador Chrome e pausá-lo, o app no Android TV precisará publicar o conteúdo inacabado no Android TV imediatamente, com uma latência máxima de 5 segundos.

Quando adicionar novos episódios

Adicione novos episódios de uma série assistida anteriormente imediatamente quando todas as condições a seguir forem verdadeiras:

  • O novo episódio está disponível no seu serviço.
  • O usuário conclui o episódio anterior.
  • O usuário tem o direito de assistir ao novo episódio.

Adicione o novo episódio, não importa quanto tempo tenha passado desde que o usuário assistiu a série pela última vez, por exemplo, após um ano ou mais.

Qualificação do conteúdo e das atualizações da IU

O usuário precisa interagir com o conteúdo do seu app para que ele se qualifique para ser publicado no canal "Assistir a seguir".

Não adicione mais de um episódio da mesma série de TV. Por exemplo, não adicione um episódio inacabado e um novo episódio da mesma série.

Não atualize todos os itens na linha Assistir em seguida quando um item mudar. Somente atualize o item com que o usuário interagiu desde a última atualização.

Quais dados incluir em um item do "Assistir a seguir"

É preciso incluir o seguinte para cada item do "Assistir a seguir".

  • Tipo de "Assistir a seguir"
  • Última posição de reprodução
  • Duração
  • Last engagement time
  • Atributos de programas de vídeo: além dos atributos obrigatórios marcados em a tabela de atributos de programas de vídeo, o atributo Content ID precisa ser definido para cada programa de vídeo. O atributo Content ID precisa corresponder ao ID interno fornecido no feed de Ações de mídia. Isso permite que o Android TV reconcilie o recurso com mais eficiência e forneça uma funcionalidade de alta confiança aos usuários.

Remover conteúdo do canal "Assistir a seguir"

Remova o conteúdo quando o usuário terminar de assistir um filme ou quando não houver um episódio não assistido disponível para uma série de TV.