Configurações da propriedade

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

• (0x00000000) 16 bits: um ID exclusivo do intervalo 0x0100 - 0xffff.
• (0x00000000) 8 bits: Tipos de propriedade, que define o tipo da propriedade.
• (0x00000000) 4 bits: tipos de área.
• (0x00000000) 4 bits: VehiclePropertyGroup. Pode ser SYSTEM (0x10000000) ou VENDOR (0x20000000). Consulte Propriedades do fornecedor para propriedades que 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 depois de uma inicialização do sistema. ON_CHANGE significa que a VHAL precisa informar quando o valor muda. CONTINUOUS significa que o valor da propriedade muda continuamente, e a VHAL precisa gerar relatórios com base na taxa de amostragem da assinatura.
• Para propriedades do sistema, isso precisa ser igual ao modo de mudança documentado em VehicleProperty.aidl.

• Valor mínimo e máximo opcional para propriedades do tipo INT64 no momento da inicialização. Precisa ser 0 para todos os outros tipos. Será ignorado se os dois forem 0.
• Para a propriedade global, se for necessário definir valores mínimo e máximo, use uma configuração de área com o ID 0.
• Esse valor é estático e não muda mesmo que o valor mínimo ou máximo seja alterado no ambiente de execução. Implemente IVehicle#getMinMaxSupportedValue para valor mínimo ou máximo dinâmico.

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

• Se a taxa de atualização variável é compatível. Isso se aplica apenas a propriedades contínuas.
• Se 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 para a VHAL vai ativar a taxa de atualização variável para a propriedade, e a VHAL precisará enviar eventos de atualização de propriedade somente quando o valor da propriedade mudar.
• Se algum assinante solicitar uma taxa de atualização fixa, a solicitação de assinatura para VHAL desativará a taxa de atualização variável para a propriedade, e o AAOS vai filtrar os eventos duplicados para os clientes que solicitarem uma taxa de atualização variável.
• É ALTAMENTE RECOMENDADO oferecer suporte a taxa de atualização variável para todas as propriedades contínuas que não sejam de pulsação para melhorar o 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, vai mostrar se essa propriedade especifica valores mínimos ou máximos compatíveis ou uma lista de valores compatíveis.
• Esse campo controla se as APIs de valores dinâmicos aceitos: getMinMaxSupportedValue, getSupportedValuesLists, subscribeSupportedValueChange, unsubscribeSupportedValueChange são aceitas para esse ID da propriedade e ID da área.
• Se não for null, a VHAL precisará implementar essas APIs para o ID da propriedade e o ID da área.
• Se null ou no Android 15 ou versões anteriores, os valores dinâmicos aceitos para esse ID de propriedade e ID de área não serão compatíveis. O cliente precisa usar as informações de valor estático compatíveis fornecidas na configuração da propriedade do veículo.