Criar apps de vídeo para o Android Automotive OS

Além das diretrizes descritas em Criar apps do Android Automotive OS para carros estacionados, há alguns requisitos específicos para apps de vídeo.

Diretrizes de design: na página Adaptar apps de vídeo consulte orientações de UX específicas para apps de vídeo.

Importante: o Google leva a distração do motorista muito a sério. Seu app precisa atender a critérios específicos antes de ser listado no Google Play para o Android Automotive OS. Ao atender a esses requisitos, você pode facilitar a criação e os testes do app. Para mais informações, consulte Qualidade de apps Android para carros.

Marcar como um app de vídeo

Para indicar que o app oferece suporte a vídeo, adicione um arquivo XML chamado automotive_app_desc.xml ao diretório res/xml/ no projeto. Nesse arquivo, inclua o seguinte conteúdo:

<automotiveApp>
  <uses name="video"/>
</automotiveApp>

Observação: talvez você receba um erro de lint no Android Studio com a mensagem "Expecting one of media, notification, sms, or template for the name attribute in uses tag". Você pode ignorar essa mensagem com segurança adicionando tools:ignore="InvalidUsesTagAttribute" ao elemento <uses>.

Em seguida, no elemento <application> do manifesto, adicione o elemento <meta-data> abaixo, que referencia o arquivo XML:

<meta-data
  android:name="com.android.automotive"
  android:resource="@xml/automotive_app_desc"/>

Oferecer suporte a áudio enquanto dirige

O áudio enquanto dirige é um recurso Beta

A publicação de apps com suporte para o recurso "Áudio ao Dirigir" está limitada aos parceiros com acesso antecipado. Enquanto esse recurso estiver na versão Beta, siga as orientações desta seção para preparar seu app para oferecer suporte.

Seja um parceiro de acesso antecipado →

Em geral, todos os apps de vídeo precisam pausar a reprodução quando as restrições de experiência do usuário estão ativas, conforme descrito em Atender aos requisitos de distração do motorista.

No entanto, alguns veículos podem mostrar controles de reprodução otimizados para direção enquanto as restrições de experiência do usuário estão ativas, permitindo continuar a reprodução de áudio.

Figura 1: controles de reprodução otimizados para um app compatível com áudio enquanto dirige.

Codelab

Siga um guia explicativo para implementar o suporte ao recurso Áudio ao Dirigir

Declarar que o app é compatível com o recurso Áudio ao Dirigir

Para indicar que o app é compatível com o recurso Áudio ao Dirigir, adicione o seguinte elemento <uses-feature> ao manifesto:

<application ...>
    ...
    <uses-feature android:name="com.android.car.background_audio_while_driving" android:required="false">
    ....
</application>

Importante: definir o atributo android:required como false garante que o app ainda possa ser distribuído para dispositivos que não são compatíveis com o Áudio ao Dirigir.

Oferecer compatibilidade com a reprodução em segundo plano

Como as atividades do app são ocultas pelas restrições de UX do sistema, ele precisa oferecer suporte à reprodução em segundo plano para continuar reproduzindo áudio enquanto o usuário dirige. Consulte Reprodução em segundo plano com uma MediaSessionService para saber como fazer isso usando a biblioteca Media3.

O app precisa postar uma notificação MediaStyle que inclua o MediaSession. Se você estiver usando MediaSessionService, isso será gerenciado por padrão.

Atenção: se você não usar um serviço para reprodução em segundo plano, a reprodução poderá continuar por um curto período, mas o app será armazenado em cache pelo sistema, fazendo com que a reprodução seja encerrada.

Determinar o suporte

Para determinar se um dispositivo oferece suporte a áudio enquanto o usuário dirige, use a classe CarFeatures da biblioteca androidx.car.app:app.

CarFeatures.isFeatureEnabled(context, CarFeatures.FEATURE_BACKGROUND_AUDIO_WHILE_DRIVING)

Use essas informações para modificar o comportamento do app de acordo com os recursos do dispositivo em que ele está sendo executado. Em dispositivos que não oferecem suporte ao áudio enquanto dirigem, o app ainda precisa atender à diretriz DD-2.

Testar o áudio enquanto dirige

Para testar a implementação, você pode simular a direção usando uma imagem do emulador que oferece suporte a áudio durante a direção.

Atenção: teste se o app ainda atende à diretriz DD-2 em dispositivos que não são compatíveis com o Áudio ao Dirigir.

Perguntas frequentes

Há suporte para o DRM da Widevine?

Sim, o Android Automotive OS oferece suporte ao Widevine DRM L3.