Use entradas personalizadas OEM para adicionar novos eventos de entrada de carro para recursos Android novos e não padrão. Os eventos de entrada não padrão não são mapeados pelo Android KeyEvent existente, projetados para serem genéricos e funcionarem em qualquer superfície Android, mas não estendidos para implementar recursos específicos do OEM. Por exemplo, um botão localizado no controle do volante que, ao ser pressionado, abre um aplicativo de mapas (através de uma intent) com a localização atual do carro. Este recurso permite que os motoristas visualizem sua localização atual sem se distrair enquanto dirigem.
Este artigo descreve como reutilizar um Android KeyEvent existente para criar um CustomInputEvent para uso somente quando nenhum Android KeyEvent puder ser usado para representar o recurso.
HW_CUSTOM_INPUT
Uma entrada personalizada OEM é representada por HW_CUSTOM_INPUT e CustomInputEvent.java . HW_CUSTOM_INPUT é o evento nativo, instanciado pelo hardware do carro (Vehicle HAL). Os OEMs determinam como instanciar esse evento. O acesso a HW_CUSTOM_INPUT é definido como [somente leitura]{:.external}, com VehiclePropertyAccess:READ .
Para garantir que o HAL do veículo sempre possa 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]{:.external} (com VehicleArea:GLOBAL ). Os três inteiros genéricos são:
O primeiro elemento representa o código de entrada a ser definido pelo OEM. Você pode associar qualquer semântica ao código de entrada.
O segundo elemento armazena a exibição de destino, como a exibição principal ou 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.
API CustomInputEvent e entrada de carro
InputHalService é o serviço Car que recebe um HW_CUSTOM_INPUT de entrada do HAL do veículo.
InputHalService converte o HW_CUSTOM_INPUT recebido em CustomInputEvent , uma classe Java parcelavel localizada em car-lib/src/android/car/input , junto com a respectiva interface aidl .
CarInputService , um serviço principal de Car Input, recebe CustomInputEvents de entrada e os envia para qualquer serviço registrado do sistema Android.
Para registrar e receber CustomInputEvents recebidos, os serviços do sistema devem:
Implemente CarInputManager.CarInputCaptureCallback#onKeyEvents .
Registre-se através de CarInputManager#requestInputEventCapture , passando
CarInputManager.INPUT_TYPE_CUSTOM_INPUT_EVENTcomo parâmetro de tipo de entrada.Para cancelar o registro, os serviços devem invocar CarInputManager#releaseInputEventCapture .
O diagrama a seguir ilustra o fluxo de trabalho de um evento de entrada personalizada OEM.
Serviços de sistema OEM Android
Os OEMs fornecem seu serviço de sistema Android para lidar com CustomInputEvents recebidos de 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 esta permissão do sistema Android (apenas serviços OEM). Portanto, nenhum serviço ou aplicativo de terceiros pode se registrar na API Car Input.
Os serviços do sistema OEM Android 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 exemplo e diretriz. Por exemplo, para adicionar um novo botão no controle do volante. Quando pressionado, este novo botão inicia o aplicativo 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 (abrindo o aplicativo de mapas com a localização atual do carro).
Durante a inicialização, esse serviço se registra no CarInputManager por meio de requestInputEventCapture (consulte o código de registro de implementação de referência .
Ao receber CustomInputEvents recebidos, este serviço envia a intenção de iniciar o aplicativo de mapas. Para saber como isso é feito, consulte CustomInputEventListener.java .