Instrumentos personalizados

Cada medidor personalizado tiene un script. main() en el script es la entrada del dibujo y devuelve una pantalla compuesta de View integrado: Text muestra texto, Circle dibuja círculos, LineChart muestra curvas y el contenedor de diseño es responsable de organizar estos contenidos.

El script puede obtener la velocidad actual, la velocidad de rotación (RPM) y otras lecturas en main(), calcular el número, color o ángulo que se mostrará y luego devolver el resultado como contenido y atributos de View. Por ejemplo, después de leer la velocidad, puede escribir el valor en Text o convertirlo en el ángulo del arco de Circle.

CapDrive llamará a main() nuevamente cuando necesite actualizar la pantalla y extraer el resultado devuelto. El código del instrumento solo necesita describir la pantalla en función de esta entrada, y la animación del atributo también se ejecuta al final del dibujo. Los recursos de imágenes se pueden guardar con el instrumento y usarse por nombre de recurso en el código.

Los instrumentos se importan y comparten a través de archivos .instrument. Los archivos existentes se pueden abrir desde Importar instrumento en el menú del instrumento personalizado, o los archivos se pueden abrir usando CapDrive. Los trabajos importados deben agregarse al tablero por separado.

Los instrumentos importados se guardan en Más（…）→ Instrumentos personalizados. Selecciónelo a través de Más（…）→ Editar panel → + y haga clic en Listo para verlo en el tablero.

Las obras que utilizan parámetros del vehículo también deberán seleccionar sus propios parámetros del vehículo en Ajustes del instrumento → Vinculaciones de entrada para la entrada OBD existente. Mantener el identificador de entrada sin cambios le permite heredar el código del trabajo sin escribir el identificador del dispositivo en el script.

Seleccione Añadir un instrumento en Más（…）→ Instrumentos personalizados para ingresar al editor. El área de edición se utiliza para escribir main() y View; haga clic en el nombre en la parte superior para configurar el nombre del instrumento, los enlaces de entrada y otras opciones. El engranaje abre Configuración de parámetros, que puede gestionar seis tipos de entradas: valor numérico, texto, interruptor, elemento de selección, datos básicos y datos OBD. El nuevo medidor ya tiene una entrada de velocidad base con el identificador speed.

Puede obtener una vista previa del texto, el diseño, los gráficos y la animación en cualquier momento mientras edita. La vista previa proporciona entrada analógica para una fácil verificación del instrumento mientras está estacionado. Cuando ocurre un error de código, se puede localizar a partir del número de línea en el registro. Después de guardar, agregue el medidor al tablero para usar las lecturas reales.

"First Speed ​​​​Gauge" proporciona código y descripción completos; la referencia de API enumera los View, propiedades, tipos e interfaces de tiempo de ejecución disponibles.

$data proporciona la lectura actual y muestras recientes del script. Los campos básicos como velocidad y distancia se pueden utilizar directamente para la visualización numérica; parámetros como la velocidad del vehículo (RPM) y la temperatura del refrigerante se proporcionan a través del dispositivo OBD configurado. El script también puede generar curvas utilizando muestreo histórico.

Cada vez que se ejecuta main(), se leen los campos obligatorios, se procesan los valores y se genera View. Es posible que las lecturas no estén disponibles temporalmente, por lo que el código de visualización debe proporcionar contenido apropiado para las mediciones faltantes. Los documentos de datos del instrumento describen de forma centralizada la estructura de campos, las referencias OBD, el muestreo histórico y el manejo de valores nulos.