$data · Datos de conducción

Haga clic en el nombre del instrumento en la parte superior del editor para abrir Ajustes del instrumento → Vinculaciones de entrada. Utilice Configuración de parámetros para definir el nombre, identificador y tipo de entrada; devuelva el enlace de entrada y complete los valores nativos, o seleccione los parámetros de su propio vehículo para la entrada OBD. La aplicación proporciona los datos básicos automáticamente.

El script accede a la entrada a través de $data.current.<identifier>. Por ejemplo, la entrada de velocidad base speed usa $data.current.speed y la entrada OBD coolant usa $data.current.coolant. El nombre del campo es independiente del UUID del parámetro del vehículo y del nombre del dispositivo. Cambiar los parámetros del vehículo solo requiere volver a vincularlo; modificar el identificador de entrada requiere modificar el código.

La siguiente tabla de campos utiliza identificadores de ejemplo y no significa que cada medidor tenga automáticamente estos campos. La interfaz real y los mensajes de tipo se generan en función de la definición de entrada del instrumento actual.

El valor de la cantidad básica y la lectura OBD suelen ser { value, unit }; Los datos básicos como posición, valor G, actitud, etc. tienen sus propios componentes y el estado de grabación es un valor booleano. Los valores, texto, modificadores y selecciones devuelven sus valores configurados directamente.

Cuando OBD no está vinculado o la configuración no existe, la entrada completa es null; cuando el enlace existe pero falta temporalmente, se conserva { value: null, unit }. Utilice reading?.value == null para comprobar si faltan pruebas y conserva el 0 válido. value de OBD puede ser un literal de mapeo; la declaración de tipo no realiza conversión en tiempo de ejecución y el tipo debe verificarse antes de llamar a métodos numéricos.

$data.history son los datos seleccionados de El viaje actual dura 30 segundos., ordenados del más antiguo al más nuevo. El host guarda todos los datos recopilados de manera unificada y luego los ensambla según sea necesario de acuerdo con los parámetros de entrada del instrumento; La ventana existente se puede leer abriendo el instrumento. Pausar el dibujo, omitir el renderizado o recrear una instancia en ejecución no pierde la ventana. Reiniciar al finalizar o cambiar viajes o cambiar modos de operación; la ventana del historial está vacía cuando no hay ningún viaje activo.

El historial se muestrea a un máximo de 5 Hz, con muestras adyacentes separadas por al menos 200 ms y se retienen un máximo de 151 elementos. Los tiempos de muestreo repetidos y los redibujados causados ​​únicamente por cambios en el entorno de visualización no aumentarán las muestras; Después de que se detengan los datos, el host seguirá eliminando las muestras caducadas en un tiempo monótono, sin ejecución del script. Este límite superior no impide que current lea esta última entrada, ni inicia consultas OBD adicionales.

Cada muestra tiene una estructura de campos consistente con current y puede contener pruebas faltantes. La modificación de definiciones de entrada o enlaces vuelve a ensamblar la ventana; Los parámetros fijos como valores, interruptores, texto y opciones utilizan la configuración actual. La actualización de datos solo compara el contenido real de $data.current para decidir si ejecutar JS. Los valores, las unidades y los subcampos de grupo participan en la comparación; Las nuevas respuestas con el mismo valor, crecimiento o recorte histórico, tiempo de recopilación interna y actualizaciones de fuentes no seleccionadas no activarán la ejecución por separado. El host continúa manteniendo la ventana completa y la próxima vez que cambie current, el script obtiene el historial más reciente. Las marcas de tiempo seleccionadas explícitamente o las duraciones registradas pertenecen a current y los cambios de valores seguirán activando la ejecución. OBD La lectura conserva el valor, la unidad y el estado de medición faltante en el momento del muestreo y no se completará con lecturas posteriores; la velocidad básica se convertirá según la unidad de visualización actual. elapsed.value es el número de segundos transcurridos durante el viaje actual, timestamp.value es la marca de tiempo en milisegundos y movingTime.value es el tiempo de viaje en segundos. Utilice el tiempo real al dibujar curvas de tiempo y conserve los puntos de interrupción causados ​​por mediciones faltantes.

Defina dos entradas: la entrada de velocidad base con identificador speed y la entrada OBD con identificador coolant. Vincular los parámetros nativos del vehículo a este último. El siguiente ejemplo muestra lecturas y unidades por sus respectivos identificadores de entrada; no se requieren modificaciones en el código de ejemplo al volver a vincular el dispositivo.

function main() {
  const speed = $data.current.speed;
  const parameter = $data.current.coolant;
  return (
    <VStack spacing={8}>
      <Text fontSize={40}>
        {speed?.value == null ? '—' : speed.value.toFixed(0)}
      </Text>
      <Text>{speed?.unit ?? $env.speedUnit}</Text>
      <Text>
        {parameter?.value == null ? '—' : parameter.value.toString()}
      </Text>
      <Text>{parameter?.unit ?? ''}</Text>
    </VStack>
  );
}

Cada ejecución de script utiliza la última entrada; la frecuencia real está determinada por la fuente de datos, los cambios de entrada y el tiempo de procesamiento. current y history devuelven copias de los datos; modificarlas no cambiará las lecturas del sensor ni la configuración del vehículo.

A campos como la velocidad base se les aplicarán configuraciones válidas de reemplazo de datos del viaje. La lectura del parámetro OBD utiliza directamente la propia lectura y unidad del parámetro. Los intervalos de consulta, las respuestas de los vehículos y otras solicitudes afectarán la actualización real. La disponibilidad de datos también se ve afectada por el posicionamiento, el estado de reconocimiento y la conectividad del dispositivo; Las vistas previas del editor utilizan entradas simuladas independientes.