Comparação AIDL e HIDL Audio HAL

A partir do Android 14, os parceiros e fornecedores de SoC são incentivados a substituir a implementação atual do HIDL HAL por uma implementação do AIDL HAL.

Para facilitar uma transição suave de HIDL Audio HAL para AIDL Audio HAL, algumas das principais diferenças são destacadas nesta página. Esta página também mostra o mapeamento entre as interfaces AIDL e HIDL para o Audio HAL.

Diferença entre a implementação AIDL e HIDL Audio HAL

As principais diferenças entre a estrutura HIDL e a estrutura AIDL são as seguintes:

• No AIDL Audio Core HAL , a interface IConfig é introduzida como um substituto para os parâmetros de todo o sistema em arquivos XML no HIDL HAL. A estrutura lê esses parâmetros do Core HAL em vez do arquivo de configuração do fornecedor. Por exemplo, a lista de formatos surround exibidos para controle do usuário é fornecida pelo método IConfig.getSurroundSoundConfig no Core HAL.

  No AIDL Audio Effects HAL , a lógica effectProxy definida em arquivos XML no HIDL Effects HAL é movida para a estrutura de áudio. A estrutura de áudio consulta todas as instâncias de efeitos no sistema usando IFactory.queryEffects e todos os processamentos de efeitos usando IFactory.queryProcessing .

• Para evitar confusão com o uso do termo dispositivo para tipos de dispositivos de áudio, IDevice no HIDL Audio HAL foi renomeado para IModule no AIDL Audio HAL.

• IPrimaryDevice é substituído no AIDL Audio HAL. Atualizações sobre o modo de áudio atual e rotação da tela são enviadas para cada instância IModule . Parâmetros relacionados à conexão síncrona Bluetooth orientada (BT SCO) e ao perfil mãos-livres (HFP) são tratados por uma interface IBluetooth dedicada. Uma interface ITelephony dedicada fornece controles específicos de telefonia. As instâncias de ambas as interfaces podem ser recuperadas da instância primária da interface IModule . Consulte as tabelas de comparação sobre Core HAL e funcionalidades relacionadas a recursos para obter mais informações.

• IDevicesFactory foi removido no AIDL Audio HAL para evitar redundância. Os módulos HAL (ou seja, instâncias de interface IModule ) agora são registrados diretamente no Service Manager usando seus nomes para nomes de instância, como bluetooth ou r_submix . A única exceção é o módulo primary que é registrado com o nome de instância default .

Mapeamento HAL de áudio AIDL e HIDL

As tabelas nas seções a seguir mostram o mapeamento entre as interfaces HAL de áudio HIDL e AIDL. Consulte o arquivo README de áudio HAL para obter mais informações sobre a estrutura de diretórios.

Núcleo HAL

Todas as interfaces HIDL estão dentro do pacote android.hardware.audio@NM , onde NM denota a versão Major.Minor . Todas as interfaces AIDL estão no pacote android.hardware.audio.core .

Portas de áudio, perfis dinâmicos, rotas e patches

Nesta tabela, os elementos dos arquivos XML são designados usando colchetes angulares.

Configurações e fluxos de portas de áudio

Conexão de efeitos de áudio

Configuração de todo o sistema

A configuração de todo o sistema que foi definida anteriormente nos arquivos de configuração XML da política de áudio (ou seja, audio_policy_configuration.xml e audio_policy_engine_configuration.xml ) deve ser fornecida por meio de IConfig . No entanto, para facilitar a transição para AIDL, os fornecedores ainda têm a opção de usar os mesmos arquivos XML usados ​​anteriormente para definir a configuração de todo o sistema. A implementação de referência para IConfig contém o código necessário para representar informações do arquivo XML usando tipos de dados AIDL, o que facilita a conversão de XML para AIDL.

Funcionalidade relacionada a recursos

Métodos obsoletos

Extensões de fornecedor

Na API HIDL, as extensões do fornecedor são implementadas usando os métodos getParameters ou setParameters das interfaces IDevice e IStream . Esses métodos aceitam strings arbitrárias. Na API AIDL, existem métodos correspondentes, como getVendorParameters ou setVendorParameters , que utilizam instâncias arbitrárias Parcelable usando encapsulamento em ParcelableHolders .

Outras mudanças

Outras mudanças gerais são as seguintes:

1. Para melhorar a testabilidade das APIs HAL, na versão AIDL, introduzimos opções de depuração que são utilizadas pelos testes VTS e estão disponíveis através do parcelable ModuleDebug . Estas opções instruem o HAL a emular determinadas funcionalidades (por exemplo, conexão de dispositivos externos), que de outra forma requerem intervenção manual e uso de equipamento de teste externo.

2. Os serviços HAL são necessários para reiniciar quando o valor da propriedade do sistema sys.audio.restart.hal é definido como 1 . A reinicialização é realizada através de audioserver.rc . Ao implementar o HAL, use o nome de serviço HAL apropriado listado no arquivo audioserver.rc . No Android 14, o nome vendor.audio-hal-aidl é adicionado especificamente para a versão AIDL do HAL.

Efeitos HAL

Todas as interfaces HIDL estão dentro do pacote android.hardware.audio.effect@NM* , onde NM é a versão Major.Minor . Todas as interfaces AIDL estão dentro do pacote android.hardware.audio.effect .

Fábrica de Efeitos

Interfaces de efeito

Comandos de Efeito

Definição de parâmetros de efeito comum

Definição de efeitos específicos