O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Arquivos de configuração do dispositivo de entrada

Os arquivos de configuração do dispositivo de entrada (arquivos .idc ) contêm propriedades de configuração específicas do dispositivo que afetam o comportamento dos dispositivos de entrada.

Os arquivos de configuração do dispositivo de entrada normalmente não são necessários para periféricos padrão, como teclados e mouses HID, uma vez que o comportamento padrão do sistema geralmente garante que eles funcionem imediatamente. Por outro lado, dispositivos embutidos embutidos, particularmente telas sensíveis ao toque, quase sempre requerem arquivos de configuração de dispositivo de entrada para especificar seu comportamento.

Justificativa

O Android detecta e configura automaticamente a maioria dos recursos do dispositivo de entrada com base nos tipos de eventos e propriedades que são relatados pelo driver de dispositivo de entrada do kernel Linux associado.

Por exemplo, se um dispositivo de entrada compatível com o EV_REL tipo de evento e códigos REL_X e REL_Y , bem como o EV_KEY de tipo de evento e BTN_MOUSE , em seguida, Android vai classificar o dispositivo de entrada como um rato. O comportamento padrão de um mouse é apresentar um cursor na tela que rastreia os movimentos do mouse e simula toques quando o mouse é clicado. Embora o mouse possa ser configurado de forma diferente, o comportamento padrão geralmente é suficiente para periféricos de mouse padrão.

Certas classes de dispositivos de entrada são mais ambíguas. Por exemplo, telas de toque multitoque e touch pads suportam o tipo de evento EV_ABS e códigos ABS_MT_POSITION_X e ABS_MT_POSITION_Y no mínimo. No entanto, os usos pretendidos desses dispositivos são bastante diferentes e nem sempre podem ser determinados automaticamente. Além disso, informações adicionais são necessárias para compreender as informações de pressão e tamanho relatadas pelos dispositivos de toque. Conseqüentemente, dispositivos de toque, especialmente telas de toque integradas, geralmente precisam de arquivos IDC.

Localização

Os arquivos de configuração do dispositivo de entrada estão localizados por fornecedor USB, produto (e opcionalmente versão) id ou pelo nome do dispositivo de entrada.

Os seguintes caminhos são consultados em ordem.

  • /odm/usr/idc/Vendor_XXXX_Product_XXXX_Version_XXXX.idc
  • /vendor/usr/idc/Vendor_XXXX_Product_XXXX_Version_XXXX.idc
  • /system/usr/idc/Vendor_XXXX_Product_XXXX_Version_XXXX.idc
  • /data/system/devices/idc/Vendor_XXXX_Product_XXXX_Version_XXXX.idc
  • /odm/usr/idc/Vendor_XXXX_Product_XXXX.idc
  • /vendor/usr/idc/Vendor_XXXX_Product_XXXX.idc
  • /system/usr/idc/Vendor_XXXX_Product_XXXX.idc
  • /data/system/devices/idc/Vendor_XXXX_Product_XXXX.idc
  • /odm/usr/idc/ device-name .idc
  • /vendor/usr/idc/ device-name .idc
  • /system/usr/idc/ device-name .idc
  • /data/system/devices/idc/ device-name .idc

Ao construir um caminho de arquivo que contém o nome do dispositivo, todos os caracteres no nome do dispositivo diferentes de '0' - '9', 'a' - 'z', 'A' - 'Z', '-' ou '_' são substituídos por '_'.

Sintaxe

Um arquivo de configuração de dispositivo de entrada é um arquivo de texto simples que consiste em atribuições de propriedades e comentários.

Propriedades

Cada atribuição de propriedade consiste em um nome de propriedade, um = , um valor de propriedade e uma nova linha. Como isso:

property = value

Os nomes das propriedades são identificadores de texto literais não vazios. Eles não devem conter espaços em branco. Cada componente do sistema de entrada define um conjunto de propriedades que são usadas para configurar sua função.

Os valores das propriedades são literais de string não vazias, inteiros ou números de ponto flutuante. Eles não devem conter espaços em branco ou os caracteres reservados \ ou " .

Os nomes e valores das propriedades diferenciam maiúsculas de minúsculas.

Comentários

As linhas de comentário começam com '#' e continuam até o final da linha. Como isso:

# A comment!

As linhas em branco são ignoradas.

Exemplo

# This is an example of an input device configuration file.
# It might be used to describe the characteristics of a built-in touch screen.

# This is an internal device, not an external peripheral attached to the USB
# or Bluetooth bus.
device.internal = 1

# The device should behave as a touch screen, which uses the same orientation
# as the built-in display.
touch.deviceType = touchScreen
touch.orientationAware = 1

# Additional calibration properties...
# etc...

Propriedades comuns

A propriedade a seguir é comum a todas as classes de dispositivos de entrada.

Consulte a documentação de cada classe de dispositivo de entrada para obter informações sobre as propriedades especiais usadas por cada classe.

device.internal

Definição: device.internal = 0 | 1

Especifica se o dispositivo de entrada é um componente interno embutido em oposição a um periférico conectado externamente (provavelmente removível).

  • Se o valor for 0 , o dispositivo é externo.

  • Se o valor for 1 , o dispositivo é interno.

  • Se o valor não for especificado, o valor padrão é 0 para todos os dispositivos no barramento USB (BUS_USB) ou Bluetooth (BUS_BLUETOOTH), caso contrário, 1 .

Esta propriedade determina as decisões de política padrão relacionadas aos eventos de ativação.

Dispositivos de entrada interna geralmente não despertam o monitor do modo de espera, a menos que explicitamente configurado para fazer isso no arquivo de layout de chave ou em uma regra de política codificada. Essa distinção evita que os toques e pressionamentos de tecla despertem seu telefone quando ele estiver no bolso. Normalmente, há apenas um pequeno punhado de chaves de ativação definidas.

Por outro lado, os dispositivos de entrada externa geralmente despertam o dispositivo de forma mais agressiva, pois presume-se que eles estejam desligados ou não conectados durante o transporte. Por exemplo, pressionar qualquer tecla em um teclado externo é um bom indicador de que o usuário deseja que o dispositivo acorde e responda.

É importante garantir que o valor da propriedade device.internal seja definido corretamente para todos os dispositivos de entrada internos.

Validação

Certifique-se de validar seus arquivos de configuração de dispositivo de entrada usando a ferramenta Validate Keymaps .