Live TV é um aplicativo de TV de referência projetado 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 do Live TV, como ajuste de imagem, modo de jogo ou modo 3D. Para oferecer suporte a essas funções ou opções específicas do dispositivo, o Live TV oferece suporte a essas personalizações:
- Ativando o modo de mudança de tempo, 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 é a implementação do Google de TV ao vivo que pode ser usada como está em dispositivos com serviços do Google. Para personalizar os 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é-criado com a permissão com.android.tv.permission.CUSTOMIZE_TV_APP
.
O Live TV 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-chave : 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 os dispositivos de televisão Android pausem, retrocedam e avancem a reprodução do canal. Na implementação da TV ao vivo, o time-shifting pode ser usado por meio da interface do usuário de controles do Play . A mudança de horário é ativada por padrão na TV ao vivo, mas pode ser desativada. 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 para uma destas opções:
-
enabled
: Ativa a mudança de tempo. Este é o valor padrão quando nenhuma opção é fornecida. -
disabled
: Desabilita o time-shifting. -
use_external_storage_only
: Configure o time-shifting para usar o armazenamento externo.
<string name="trickplay_mode">use_external_storage_only</string>
Personalizar 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 de som.
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 à interface do usuário 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 pode diferenciar filtros de intenção em uma atividade com a mesma categoria devido à limitação do Android. Consulte Lidar com várias 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 um valor de prioridade definido menor que 100 aparece antes dos itens existentes e um valor maior que 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 é 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>
Lidar com várias 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ção com as mesmas categorias e ações, uma atividade lida apenas com uma opção, mesmo que vários filtros de intenção 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>
Criar uma linha personalizada
Os fabricantes de dispositivos podem adicionar e personalizar uma linha acima da linha de opções de TV. Essa linha personalizada é opcional.
Título da linha
Defina uma string 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>