Os desenvolvedores de apps precisam seguir estas diretrizes ao inserir conteúdo no canal "Assistir a seguir".
Que tipos de conteúdo podem ser incluídos no canal "Assistir a seguir"?
Seu app precisa limitar as adições programáticas a filmes e programas de TV tradicionais. Evite adicionar clipes e outros conteúdos curtos.
Filmes inacabados
Adicione filmes ainda não concluídos (conforme definido abaixo) ao canal "Assistir a seguir" usando TYPE_MOVIE.
- Considera-se que o usuário "iniciou" um filme se tiver assistido mais de 3% ou dois minutos, o que acontecer primeiro.
- O usuário "concluiu" um filme se os créditos finais começarem. Nesse caso, não o adicione ao canal "Assistir a seguir". É possível determinar esse estado por meio de uma tecnologia de detecção automática dos créditos finais ou por meio de uma estimativa com base no tamanho do conteúdo.
Episódios de TV inacabados
Adicione episódios ainda não concluídos (conforme definido abaixo) ao canal "Assistir a seguir" usando TYPE_TV_EPISODE.
- Considera-se que o usuário "iniciou" um episódio se tiver assistido mais de três minutos.
- O usuário "concluiu" um episódio se os créditos finais começarem. Nesse caso, não o adicione ao canal "Assistir a seguir". É possível determinar esse estado por meio de uma tecnologia de detecção automática dos créditos finais ou por meio de uma aproximação com base na duração do conteúdo (por exemplo, menos de 3 minutos restantes em um episódio).
Como gerenciar os episódios de TV futuros e novos
Adicione os episódios futuros e novos (conforme definido abaixo) ao canal "Assistir a seguir" usando TYPE_TV_EPISODE.
- Considera-se que o usuário "iniciou" uma série se assistiu mais de três minutos (ou um minuto após a introdução) de qualquer episódio da série.
- Se o usuário tiver "iniciado" uma série e "concluído" 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 tiver "iniciado" uma série, estiver em dia (ou seja, assistiu todos os episódios disponíveis até o último) e uma nova temporada ou episódio se tornar disponível posteriormente, adicione esse novo episódio ao canal "Assista ao canal" usando
WATCH_NEXT_TYPE_NEW. Adicione o novo episódio independentemente de quando o episódio ficará disponível no futuro (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 uma série visualizada anteriormente ao canal "Assistir a seguir" de acordo com as diretrizes a seguir.
Conteúdo inacabado
Sempre que 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 cinco minutos.
Publique qualquer conteúdo inacabado das situações acima imediatamente (com uma latência máxima de cinco segundos). Por exemplo, a partir do momento em que o usuário sair do Android TV, o app deverá publicar todos os itens inacabados usando a API Next Watch em cinco 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 deverá publicar o conteúdo inacabado no Android TV imediatamente (com uma latência máxima de cinco segundos).
Episódios novos
Adicione um item WATCH_NEXT_TYPE_NEW imediatamente quando as seguintes condições forem todas verdadeiras:
- O novo episódio está disponível no seu serviço.
- O usuário concluiu o episódio anterior.
- O usuário tem o direito de assistir ao novo episódio.
Adicione o novo episódio independentemente de quando o episódio ficará disponível no futuro (por exemplo, após um ano ou mais).
Qualificação do conteúdo e das atualizações da IU
O usuário deve ter interagido 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 à mesma série de TV. Por exemplo, não adicione um episódio inacabado e um novo episódio para o mesmo programa de TV.
Não atualize todos os itens na linha Novidades Play quando algum deles for alterado. Somente atualize o item com o qual o usuário interagiu desde a última atualização.
Quais dados você precisa 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
- Horário do último engajamento
- Atributos de programas de vídeo: além dos atributos obrigatórios marcados na 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.