API Spedmo Javascript Vario

La API Spedmo Javascript Vario está construida utilizando la funcionalidad web estándar y, como resultado, todas las características estándar disponibles con Javascript y los navegadores modernos están disponibles para los pilotos y desarrolladores, sin restricción, además de los objetos específicos de Spedmo Vario que se enumeran a continuación.

Hay muchos tutoriales web y JavaScript disponibles en la web para nuevos desarrolladores, este documento API no pretende enseñar a los desarrolladores cómo programar sino que define los objetos específicos que están disponibles para construir pantallas Vario personalizadas para dispositivos Android e IOS.

Comprender la dependencia de la aplicación Spedmo

La API Spedmo Javascript Vario utiliza una compilación de aplicación personalizada que está disponible en las plataformas Android e IOS. Esta aplicación tiene una funcionalidad personalizada que puede negociar llamadas a varios BLE predefinidos a través de la aplicación. A medida que tengamos en nuestras manos más dispositivos, la gama de varios compatibles aumentará con el tiempo, sin embargo, la principal ventaja para los desarrolladores es que el trabajo duro de programar directamente en dispositivos BLE se ha simplificado para reducir la complejidad de la programación y permitir que los pilotos se centren específicamente en Funcionalidad de visualización. La aplicación Spedmo devuelve eventos Javascript simplificados al desarrollador que se pueden utilizar para solicitar actualizaciones de pantalla o interacción del usuario. Este es el concepto fundamental detrás del marco que debe entenderse antes de comenzar cualquier desarrollo.

Los desarrolladores pueden administrar la funcionalidad y las versiones de sus aplicaciones a través del Administrador de aplicaciones Spedmo y recomendamos utilizar el arnés de prueba de GitHub para construir la funcionalidad fuera de línea antes de cargar la versión de prueba.

Dependencias Javascript

Aquí no se enumeran todas las dependencias de Javascript, pero la dependencia principal que deben tener en cuenta los desarrolladores es el uso de Jquery.

Jquery es la biblioteca Javascript base obligatoria que se usa para todas las llamadas a objetos BLE de Spedmo y no se eliminará pronto. En teoría, otros marcos, como React / Angular, etc., están disponibles para que los desarrolladores los utilicen, sin embargo, no existe documentación ni soporte para estos marcos más allá de lo que ya está disponible públicamente en los foros en línea.

Objetos BLE Javascript

Objeto base

$ .spedmo

El objeto base que debe definirse en todas las representaciones de una página es el objeto $ .spedmo . Este objeto nunca debe estar indefinido , si está depurando la causa raíz probablemente revelaría un problema introducido por el desarrollador que debería resolverse antes de publicar la aplicación. Si se sospecha que la causa no es un desarrollador, no dude en plantear un error en el Proyecto de muestra Spedmo Github para su investigación.

Evento listo para BLE

$ .spedmo.bleReady

Este evento se llama cuando la aplicación Spedmo ha negociado con éxito con los pilotos BLE vario. Los desarrolladores deben suponer que cuando se llama a este evento, el dispositivo BLE está transmitiendo datos útiles y, por lo general, es aquí donde se construye el diseño de pantalla inicial para la visualización del usuario, así como cualquier enlace de evento que deba establecerse.

Evento de alimentación de línea sin formato BLE

$ .spedmo.ble.event.rawLineFeed

Este es un evento de dispositivo de bajo nivel que se dispara cuando los datos se envían desde el dispositivo BLE y se pasan directamente a la aplicación de Desarrolladores sin ningún tipo de análisis o filtrado. Esto puede ser útil para escribir características específicas del dispositivo o soporte para funciones aún no admitidas por la API Javascript Vario.

Evento de actualización de GPS BLE

$ .spedmo.ble.event.gpsUpdate

Este evento se activa cuando se pasa una actualización de GPS desde el dispositivo BLE. Se pasa un objeto de estado que se crea utilizando la biblioteca GPS.js y tiene el siguiente formato.

  • hora: hora actual
  • lat: latitud
  • lon: longitud
  • alt: Altitude (no debe confundirse con Vario Altitude)
  • satsActive: matriz de satélites activos
  • velocidad: velocidad sobre el suelo en km / h
  • seguimiento: seguimiento en grados
  • satsVisible: matriz de todos los satélites visibles

Evento de actualización de altitud BLE

$ .spedmo.ble.event.altitudeUpdate

Este evento se dispara cuando se recibe una actualización de altitud del dispositivo BLE. Se pasa un objeto de altitud que tiene el siguiente formato.

  • loggerStored: registrador almacenado (S / N)
  • iasKph: IAS (km / h)
  • baroAltitudeM: baroaltitude (m)
  • varioChangeMs1: vario (m / s) (últimas 6 mediciones en el último segundo)
  • varioChangeMs2: vario (m / s) (últimas 6 mediciones en el último segundo)
  • varioChangeMs3: vario (m / s) (últimas 6 mediciones en el último segundo)
  • varioChangeMs4: vario (m / s) (últimas 6 mediciones en el último segundo)
  • varioChangeMs5: vario (m / s) (últimas 6 mediciones en el último segundo)
  • varioChangeMs6: vario (m / s) (últimas 6 mediciones en el último segundo)
  • encabezado: encabezado
  • windCourseDeg: Curso de viento (grados)
  • windSpeedKph: Velocidad del viento (km / h)