Live TV é um aplicativo de TV de referência desenvolvido para dispositivos de televisão Android. No entanto, os fabricantes de dispositivos podem querer adicionar mais funções específicas do produto, que não são cobertas pela implementação padrão da TV ao vivo, como ajuste de imagem, modo de jogo ou modo 3D. Para oferecer suporte a essas funções ou opções específicas do dispositivo, a TV ao vivo oferece suporte a estas personalizações:
- Habilitando o modo de mudança de horário, que permite aos usuários pausar, avançar e retroceder. Configurando o modo de mudança de horário para usar armazenamento externo em vez de armazenamento interno.
- Adicionando opções à linha de opções de TV.
- Adicionando uma linha personalizada e adicionando opções nela.
Observação : Canais ao vivo são a implementação da TV ao vivo do Google que pode ser usada como está em dispositivos com serviços do Google. Para personalizar canais ao vivo, substitua com.android.tv.* por com.google.android.tv.* nestas instruções.
Personalize a TV ao vivo
Para personalizar a TV ao vivo, o dispositivo Android TV de destino precisa de um pacote de personalização instalado, que deve ser um aplicativo de sistema pré-construído com a permissão com.android.tv.permission.CUSTOMIZE_TV_APP .
A TV ao vivo procura um pacote de sistema com essa permissão, verifica os arquivos de recursos e detecta as atividades do pacote marcadas com categorias específicas para processar a personalização.
Ponto principal : apenas um pacote pode personalizar a TV ao vivo.
Configurar o modo de mudança de horário
A mudança de tempo (trickplay) permite que dispositivos de televisão Android pausem, retrocedam e avancem a reprodução do canal. Na implementação de TV ao vivo, a mudança de horário pode ser usada por meio da IU de controles do Play . A mudança de horário está habilitada por padrão na TV ao vivo, mas pode ser desabilitada. A mudança de horário também pode ser configurada para usar apenas armazenamento externo.
Para configurar a mudança de tempo, adicione o recurso de string trickplay_mode e defina seu valor como uma destas opções:
-
enabled: Ativa a mudança de horário. Este é o valor padrão quando nenhuma opção é fornecida. -
disabled: Desativa a mudança de horário. -
use_external_storage_only: Configure a mudança de horário para usar armazenamento externo.
<string name="trickplay_mode">use_external_storage_only</string>
Figura 1 . A IU de controles de reprodução é ativada após pressionar o botão central do D-pad.
Personalize as opções de TV
Os fabricantes de dispositivos podem adicionar opções personalizadas para configurações de TV ao vivo ao menu de opções de TV existente, como adicionar um atalho para as configurações de imagem sonora.
Para indicar uma opção personalizada, declare um filtro de intenção que filtre a categoria com.android.tv.category.OPTIONS_ROW em uma atividade. O recurso personalizado é implementado pelo fabricante do dispositivo na atividade. A atividade é iniciada se a opção for clicada. O título e o ícone da atividade são usados para a opção. As opções de TV personalizadas devem corresponder à IU existente para fornecer a melhor experiência do usuário.
Observação : uma atividade só pode lidar com uma opção porque a TV ao vivo não consegue diferenciar filtros de intenção em uma atividade da mesma categoria devido à limitação do Android. Consulte Lidar com diversas opções em uma atividade para obter uma solução alternativa.
Os fabricantes de dispositivos também podem colocar uma opção personalizada antes ou depois das opções existentes, definindo android:priority em AndroidManifest.xml . Uma opção com valor de prioridade definido inferior a 100 aparece antes dos itens existentes e com valor superior a 100 aparece depois. Várias opções personalizadas (antes ou depois das opções existentes) são classificadas por prioridade em ordem crescente. Se as opções tiverem a mesma prioridade, a ordem entre elas será indefinida.
Neste exemplo, a opção aparece primeiro na linha de opções de TV e PictureSettingsActivity é iniciada se a opção for clicada.
<activity android:name=".PictureSettingsActivity"
android:label="@string/activity_label_picture_settings"
android:theme="@style/Theme.Panel">
<intent-filter
android:icon="@drawable/ic_tvoptions_brightness"
android:label="@string/option_label_brightness"
android:priority="0">
<action android:name="android.intent.action.MAIN" />
<category android:name="com.android.tv.category.OPTIONS_ROW" />
</intent-filter>
</activity> 
Figura 2 . Exemplo de linha de opções de TV personalizadas (brilho e economia de energia).
Figura 3 . Exemplos de opções de TV personalizadas.
Lidar com múltiplas opções em uma atividade
Uma opção é mapeada para o filtro de intenção de uma atividade e vice-versa. Como o Android não diferencia filtros de intenções com as mesmas categorias e ações, uma atividade lida apenas com uma opção, mesmo que vários filtros de intenções sejam declarados nela. Para lidar com várias opções em uma atividade, use <activity-alias> em AndroidManifest.xml . Na atividade, use getIntent().getComponent() para identificar a opção clicada.
<activity-alias android:name=".AnyUniqueName"
android:targetActivity=".PictureSettingsActivity">
<intent-filter
android:icon="@drawable/ic_tvoptions_energy_saving"
android:label="@string/option_label_energy_saving"
android:priority="1">
<action android:name="android.intent.action.MAIN" />
<category android:name="com.android.tv.category.OPTIONS_ROW" />
</intent-filter>
</activity-alias>Crie uma linha personalizada
Os fabricantes de dispositivos podem adicionar e personalizar uma linha acima da linha de opções de TV. Esta linha personalizada é opcional.
Título da linha
Defina uma sequência partner_row_title em res/values/strings.xml . O valor da string é usado para o título da linha personalizada.
<string name="partner_row_title">Partner Row</string>
Opções personalizadas
Para adicionar opções personalizadas à linha personalizada, siga o processo de adição de opções ao menu de opções de TV, mas altere o nome da categoria para com.android.tv.category.PARTNER_ROW .
<activity android:name=".ThreeDimensionalSettingDialogActivity"
android:label="@string/activity_label_3d"
android:theme="@android:style/Theme.Material.Light.Dialog">
<intent-filter
android:icon="@drawable/ic_tvoptions_3d"
android:priority="0">
<action android:name="android.intent.action.MAIN" />
<category android:name="com.android.tv.category.PARTNER_ROW" />
</intent-filter>
</activity>
Figura 4 . Exemplo de linha personalizada opcional.
Figura 5 . Exemplo de caixa de diálogo de opções personalizadas.