API Spedmo Javascript Vario

L'API Spedmo Javascript Vario est construite à l'aide de fonctionnalités Web standard. Par conséquent, les pilotes et les développeurs disposent des fonctionnalités standard disponibles avec Javascript et des navigateurs modernes, sans restriction, en plus des objets Spedmo Vario spécifiques répertoriés ci-dessous.

Il existe de nombreux didacticiels Web et JavaScript destinés aux nouveaux développeurs. Ce document de l'API n'a pas pour but d'enseigner aux développeurs comment programmer, mais définit les objets spécifiques disponibles pour la création d'écrans Vario personnalisés pour les appareils Android et IOS.

Comprendre la dépendance de Spedmo App

L'API Spedmo Javascript Vario utilise une version personnalisée de l'application, disponible sur les plates-formes Android et IOS. Cette application a une fonctionnalité personnalisée qui permet de négocier des appels à des varios BLE prédéfinis via l'application. Au fur et à mesure que nous aurons accès à plus de périphériques, le nombre de variantes prises en charge augmentera avec le temps. Cependant, le principal avantage des développeurs est que la tâche difficile de programmer directement sur des périphériques BLE a été simplifiée pour réduire la complexité de la programmation et permettre aux pilotes de se concentrer spécifiquement sur les fonctionnalité d'affichage. L'application Spedmo renvoie au développeur des événements Javascript simplifiés qui peuvent être utilisés pour demander des actualisations de l'affichage ou une interaction de l'utilisateur. C’est le concept fondamental du cadre qui doit être compris avant de commencer tout développement.

Les développeurs peuvent gérer les fonctionnalités et les versions de leurs applications via Spedmo App Manager . Nous vous recommandons d’utiliser le faisceau de tests GitHub pour créer des fonctionnalités hors ligne avant de télécharger la version de test.

Dépendances Javascript

Toutes les dépendances Javascript ne sont pas répertoriées ici, mais la principale dépendance à l'attention des développeurs est l'utilisation de Jquery.

Jquery est la bibliothèque Javascript de base obligatoire qui est utilisée pour tous les appels d'objet Spedmo BLE et ne sera pas supprimée de si tôt. D'autres cadres tels que React / Angular, etc. sont théoriquement disponibles pour les développeurs. Toutefois, aucune documentation ou assistance n'est offerte pour ces cadres au-delà de ce qui est déjà accessible au public sur les forums en ligne.

Objets Javascript BLE

Objet de base

$ .spedmo

L'objet de base qui doit être défini sur tous les rendus d'une page est l'objet $ .spedmo . Cet objet ne doit jamais être indéfini . S'il est en train de déboguer, la cause première révélerait vraisemblablement un problème introduit par le développeur qui aurait besoin d'être résolu avant la publication de l'application. Si un bogue causant une cause autre que le développeur est suspecté, n'hésitez pas à créer un bogue sur le projet exemple Spedmo Github pour enquête.

BLE Ready Event

$ .spedmo.bleReady

Cet événement est appelé lorsque l'application Spedmo a réussi à négocier avec les pilotes BLE vario. Les développeurs doivent supposer que, lorsque cet événement est appelé, le périphérique BLE transmet des données utiles, la structure de l'écran initial doit généralement être créée pour l'affichage par l'utilisateur, ainsi que pour tous les points d'ancrage d'événement devant être établis.

Évènement de ligne brute BLE

$ .spedmo.ble.event.rawLineFeed

Il s'agit d'un événement de périphérique de bas niveau qui est déclenché lorsque des données sont envoyées à partir du périphérique BLE et qu'il est directement transmis à l'application Developers sans analyse ni filtrage d'aucune sorte. Cela peut être utile pour l'écriture de fonctionnalités spécifiques de l'appareil ou la prise en charge de fonctions qui ne sont pas encore prises en charge par l'API Javascript Vario.

Evénement de mise à jour GPS BLE

$ .spedmo.ble.event.gpsUpdate

Cet événement est déclenché lorsqu'une mise à jour GPS a été transmise par le périphérique BLE. Un objet d' état est généré, construit à l'aide de la bibliothèque GPS.js et au format suivant.

  • heure: heure actuelle
  • lat: latitude
  • lon: Longitude
  • alt: Altitude (à ne pas confondre avec Vario Altitude)
  • satsActive: Tableau de satellites actifs
  • vitesse: vitesse au sol en km / h
  • piste: piste en degrés
  • satsVisible: Tableau de tous les satellites visibles

BLE Altitude Event Event

$ .spedmo.ble.event.altitudeUpdate

Cet événement est déclenché lorsqu'une mise à jour de l'altitude a été reçue du périphérique BLE. Un objet d' altitude est passé qui a le format suivant.

  • loggerStored: logger stocké (Y / N)
  • iasKph: IAS (km / h)
  • baroAltitudeM: baroaltitude (m)
  • varioChangeMs1: vario (m / s) (6 dernières mesures en dernière seconde)
  • varioChangeMs2: vario (m / s) (6 dernières mesures en dernière seconde)
  • varioChangeMs3: vario (m / s) (6 dernières mesures en dernière seconde)
  • varioChangeMs4: vario (m / s) (6 dernières mesures en dernière seconde)
  • varioChangeMs5: vario (m / s) (6 dernières mesures en dernière seconde)
  • varioChangeMs6: vario (m / s) (les 6 dernières mesures en dernière seconde)
  • rubrique: rubrique
  • windCourseDeg: cours du vent (deg)
  • windSpeedKph: Vitesse du vent (km / h)