A partir de 2026, para alinhar com nosso modelo de desenvolvimento estável de tronco e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, recomendamos usar android-latest-release em vez de aosp-main. O branch de manifesto android-latest-release sempre vai fazer referência à versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Entradas personalizadas do OEM

Use entradas personalizadas de OEM para adicionar novos eventos de entrada do carro em recursos novos e não padrão do Android. Os eventos de entrada não padrão não são mapeados pelo KeyEvent do Android, que foi projetado para ser genérico e funcionar em qualquer superfície do Android, mas não foi estendido para implementar recursos específicos do OEM. Por exemplo, um botão localizado no controle do volante que, quando pressionado, abre um app de mapas (por uma intent) com a localização atual do carro. Esse recurso permite que os motoristas visualizem a localização atual sem se distrair enquanto dirigem.

Este artigo descreve como reutilizar um KeyEvent do Android para criar um CustomInputEvent para uso somente quando nenhum KeyEvent do Android puder ser usado para representar o recurso.

HW_CUSTOM_INPUT

Uma entrada personalizada de OEM é representada por HW_CUSTOM_INPUT e CustomInputEvent.java. HW_CUSTOM_INPUT é o evento nativo, instanciado pelo hardware do carro (HAL veicular). Os OEMs determinam como instanciar esse evento. O acesso ao HW_CUSTOM_INPUT é definido como [somente leitura], com VehiclePropertyAccess:READ.

Para garantir que o HAL veicular possa sempre transmitir o valor mais recente disponível, a notificação HW_CUSTOM_INPUT é definida como ON_CHANGE, com VehiclePropertyChangeMode:ON_CHANGE.

Os valores HW_CUSTOM_INPUT são compostos por uma matriz de int32 genéricos, definidos como GLOBAL (com VehicleArea:GLOBAL). Os três números inteiros genéricos são:

O primeiro elemento representa o código de entrada a ser definido pelo OEM. É possível associar qualquer semântica ao código de entrada.

Observação: se você não precisar de mais de 10 códigos de entrada, use as funções genéricas (consulte as constantes INPUT_CODE_F1 a INPUT_CODE_F10 definidas em CustomInputType, consulte o arquivo types.hal) para facilitar a leitura. O uso das funções genéricas é totalmente opcional.
O segundo elemento armazena a tela de destino, como a tela principal ou o cluster.
O terceiro elemento contém o número de vezes que o evento foi repetido. Por exemplo, para indicar quantas vezes um botão foi pressionado.

CustomInputEvent e API Car Input

InputHalService é o serviço de carro que recebe um HW_CUSTOM_INPUT do HAL veicular.

InputHalService converte o HW_CUSTOM_INPUT recebido no CustomInputEvent, uma classe parcelável Java localizada em car-lib/src/android/car/input, junto com a interface aidl respectiva.

O CarInputService, um serviço principal de entrada do carro, recebe CustomInputEvents e os envia para qualquer serviço do sistema Android registrado.

Para registrar e receber CustomInputEvents, os serviços do sistema precisam:

Implementar CarInputManager.CarInputCaptureCallback#onKeyEvents.
Registrar usando CarInputManager#requestInputEventCapture, transmitindo CarInputManager.INPUT_TYPE_CUSTOM_INPUT_EVENT como o parâmetro do tipo de entrada.

Para cancelar o registro, os serviços precisam invocar CarInputManager#releaseInputEventCapture.

O diagrama a seguir ilustra o fluxo de trabalho de um evento de entrada personalizada de OEM.

Fluxo de trabalho de entrada personalizada do OEM

Serviços do sistema Android OEM

Os OEMs fornecem o serviço do sistema Android para processar CustomInputEvents recebidos do CarInputService.

Somente os serviços marcados com a permissão de privilégio android.permission.INJECT_EVENTS podem registrar e receber CustomInputEvents da API Car Input (CarInputManager). Nenhum serviço ou aplicativo de terceiros pode ser assinado com essa permissão do sistema Android (somente serviços OEM). Portanto, nenhum serviço ou aplicativo de terceiros pode ser registrado na API Car Input.

Os serviços do sistema Android OEM podem acessar SystemApi e métodos públicos.

Implementação de referência

Consulte a implementação de referência em packages/services/Car/tests/SampleCustomInputService, que é fornecida como um exemplo e uma diretriz. Por exemplo, para adicionar um novo botão no controle do volante. Quando pressionado, esse novo botão inicia o app de mapas com a localização atual do carro.

Neste exemplo, o OEM selecionou INPUT_CODE_F1 (a primeira função de conveniência CustomInputEvent) para representar esse novo recurso (abrir o app de mapas com a localização atual do carro).

Durante a inicialização, esse serviço se registra no CarInputManager usando requestInputEventCapture (consulte o código de registro da implementação de referência.

Ao receber CustomInputEvents, esse serviço envia a intent para iniciar o app de mapas. Para saber como isso é feito, consulte CustomInputEventListener.java.