Instrumentos personalizados

Cada medidor personalizado possui um script. main() no script é a entrada do desenho e retorna uma tela composta por View integrado: Text exibe texto, Circle desenha círculos, LineChart exibe curvas e o contêiner de layout é responsável por organizar esses conteúdos.

O script pode obter a velocidade atual, velocidade de rotação (RPM) e outras leituras em main(), calcular o número, cor ou ângulo a ser exibido e, em seguida, retornar o resultado como conteúdo e atributos de View. Por exemplo, depois de ler a velocidade, você pode escrever o valor em Text ou convertê-lo no ângulo do arco de Circle.

CapDrive chamará main() novamente quando precisar atualizar a tela e desenhar o resultado retornado. O código do instrumento só precisa descrever a tela com base nesta entrada, e a animação do atributo também é executada no final do desenho. Os recursos de imagem podem ser salvos com o instrumento e usados ​​pelo nome do recurso no código.

Os instrumentos são importados e compartilhados por meio de arquivos .instrument. Os arquivos existentes podem ser abertos em Importar instrumento no menu de instrumento personalizado ou os arquivos podem ser abertos usando CapDrive. As obras importadas precisam ser adicionadas ao painel separadamente.

Os instrumentos importados são salvos em Mais（…）→ Instrumentos personalizados. Selecione-o via Mais（…）→ Editar painel → + e clique em OK para visualizá-lo no painel.

Obras que utilizam parâmetros de veículos também precisarão selecionar seus próprios parâmetros de veículo em Ajustes do instrumento → Vínculos de entrada para a entrada OBD existente. Manter o identificador de entrada inalterado permite herdar o código da obra sem gravar o identificador do dispositivo no script.

Selecione Adicionar novo instrumento em Mais（…）→ Instrumentos personalizados para entrar no editor. A área de edição é usada para escrever main() e View; clique no nome na parte superior para definir o nome do instrumento, ligações de entrada e outras opções. A engrenagem abre Configuração de parâmetros, que pode gerenciar seis tipos de entradas: valor numérico, texto, switch, item de seleção, dados básicos e dados OBD. O novo medidor já possui uma entrada de velocidade base com o identificador speed.

Você pode visualizar texto, layout, gráficos e animação a qualquer momento durante a edição. A visualização fornece entrada analógica para fácil verificação do instrumento enquanto estacionado. Quando ocorre um erro de código, ele pode ser localizado no número da linha do log. Após salvar, adicione o medidor ao painel para usar as leituras reais.

"First Speed ​​​​Gauge" fornece código e descrição completos; a referência da API lista o View, propriedades, tipos e interfaces de tempo de execução disponíveis.

$data fornece a leitura atual e amostras recentes para o script. Campos básicos como velocidade e distância podem ser usados ​​diretamente para exibição numérica; parâmetros como velocidade do veículo (RPM) e temperatura do líquido refrigerante são fornecidos por meio do dispositivo OBD configurado. O script também pode gerar curvas usando amostragem histórica.

Cada vez que main() é executado, os campos obrigatórios são lidos, os valores são processados ​​e View é gerado. As leituras podem estar temporariamente indisponíveis, portanto o código de exibição deve fornecer conteúdo apropriado para medições ausentes. Os documentos de dados do instrumento descrevem centralmente a estrutura do campo, as referências OBD, a amostragem histórica e o tratamento de valores nulos.