Configurações da propriedade

O ID da propriedade. Ela precisa ser uma das propriedades do sistema definidas do VehicleProperty.aidl ou uma propriedade do fornecedor. O ID da propriedade é criado usando a operação OR de bits dos seguintes campos (da direita para a esquerda):

• (0x00000000) 16 bits: um ID exclusivo do intervalo 0x0100 a 0xffff.
• (0x00000000) 8 bits: tipos de propriedade, que define o tipo da propriedade.
• (0x00000000) 4 bits: tipos de área.
• (0x00000000) 4 bits: VehiclePropertyGroup É SYSTEM (0x10000000) ou VENDOR (0x20000000). Consulte Propriedades do fornecedor para saber quais propriedades podem ser personalizadas.

Por exemplo,
INFO_VIN (0x11100100) = UniqueID (0x00000100) | VehiclePropertyType.STRING (0x00100000) | VehicleArea.GLOBAL (0x01000000) | VehiclePropertyGroup.SYSTEM (0x10000000)

• Mude o modo da propriedade. Precisa ser STATIC, ON_CHANGE ou CONTINUOUS. STATIC significa que o valor da propriedade nunca muda após a inicialização do sistema. ON_CHANGE significa que o VHAL precisa informar quando o valor muda. CONTINUOUS significa que o valor da propriedade muda continuamente, e o VHAL precisa informar com base na taxa de amostragem de assinatura.
• Para propriedades do sistema, esse valor precisa ser igual ao modo de mudança documentado em VehicleProperty.aidl.

• Valor mínimo e máximo opcional para propriedades do tipo INT64 na inicialização. Precisa ser 0 para todos os outros tipos. Será ignorado se ambos forem 0.
• Para a propriedade global, se o valor mínimo e máximo precisar ser definido, use uma configuração de área com o ID de área 0.
• Esse valor é estático e não muda, mesmo que o valor mínimo ou máximo mude durante a execução. Implemente IVehicle#getMinMaxSupportedValue para o valor mínimo ou máximo dinâmico.

• Lista opcional de valores aceitos na inicialização, se a propriedade for definida como uma propriedade enum. Se não for especificado (vazio) ou antes do Android 14, será considerado que todos os valores de tipo enumerado são aceitos.
• Para a propriedade global, se for necessário definir valores de tipo enumerado com suporte, use uma configuração de área com o ID de área 0.
• Esse valor é estático e não muda, mesmo que os valores compatíveis mudem durante a execução. Implemente IVehicle#getSupportedValuesLists para valores dinâmicos compatíveis.
• Isso se aplica apenas a propriedades do tipo de enumeração. Para outros tipos, esse campo precisa estar vazio. Para expor valores aceitos para outros tipos que não são enum, use IVehicle#getSupportedValuesLists.

• Se a taxa de atualização variável é compatível. Isso se aplica apenas a propriedades contínuas.
• Se esse valor for true, o app poderá ativar a taxa de atualização variável para uma assinatura e receber eventos de atualização de propriedade somente quando o valor da propriedade mudar, tratando propriedades contínuas como propriedades de mudança.
• Se todos os assinantes de uma propriedade ativarem a taxa de atualização variável, a solicitação de assinatura ativa a taxa de atualização variável para a propriedade, e o VHAL vai precisar enviar eventos de atualização da propriedade somente quando o valor da propriedade mudar.
• Se algum assinante solicitar uma taxa de atualização fixa, a solicitação de assinatura para o VHAL desativa a taxa de atualização variável para a propriedade, e o AAOS filtra os eventos duplicados para os clientes que solicitam a taxa de atualização variável.
• É ALTAMENTE RECOMENDADO oferecer suporte à taxa de atualização variável para todas as propriedades contínuas que não sejam de batimentos cardíacos para um melhor desempenho, a menos que os dados da propriedade sejam grandes (por exemplo, uma matriz de bytes de 1k de tamanho) e possam ocupar uma grande quantidade de memória para armazenamento em cache.

• Se não for null, mostra se essa propriedade especifica valores mínimos ou máximos ou a lista de valores compatíveis.
• Esse campo controla se as APIs de valor com suporte dinâmico: getMinMaxSupportedValue, getSupportedValuesLists, subscribeSupportedValueChange, unsubscribeSupportedValueChange têm suporte para esse ID de propriedade e ID de área.
• Se não for null, o VHAL precisa implementar essas APIs para esse ID de propriedade e de área.
• Se null ou no Android 15 ou anterior, os valores com suporte dinâmico para esse ID de propriedade e ID de área não são aceitos. O cliente precisa usar as informações de valor com suporte estático fornecidas na configuração da propriedade do veículo.