API Vario di Spedmo Javascript

L'API Vario di Spedmo Javascript è costruita utilizzando funzionalità web standard e, di conseguenza, tutte le funzionalità standard disponibili con Javascript e i browser moderni sono disponibili per i piloti e gli sviluppatori, senza alcuna limitazione, oltre agli oggetti specifici di Spedmo Vario elencati di seguito.

Esistono molti tutorial Web e JavaScript disponibili sul Web per i nuovi sviluppatori, questo documento API non intende insegnare agli sviluppatori come programmare, ma definisce gli oggetti specifici disponibili per la creazione di display Vario personalizzati per dispositivi Android e IOS.

Comprensione della dipendenza dell'app Spedmo

L'API Vario di Spedmo Javascript utilizza un'applicazione personalizzata che è disponibile sia su piattaforme Android che IOS. Questa applicazione ha funzionalità personalizzate che possono negoziare le chiamate a vari BLE predefiniti tramite l'applicazione. Man mano che mettiamo le mani su più dispositivi, la gamma di vari supportati aumenterà nel tempo, tuttavia il vantaggio principale per gli sviluppatori è che il duro lavoro di programmazione direttamente sui dispositivi BLE è stato semplificato per ridurre la complessità della programmazione e consentire ai piloti di concentrarsi specificamente sul funzionalità di visualizzazione. L'app Spedmo restituisce allo sviluppatore eventi Javascript semplificati che possono essere utilizzati per richiedere aggiornamenti della visualizzazione o interazione dell'utente. Questo è il concetto fondamentale alla base del framework che dovrebbe essere compreso prima di iniziare qualsiasi sviluppo.

Gli sviluppatori possono gestire le funzionalità e le versioni delle loro app tramite Gestore app Spedmo e consigliamo di utilizzare il cablaggio di test GitHub per creare funzionalità offline prima di caricare la versione di prova.

Dipendenze Javascript

Non tutte le dipendenze Javascript sono elencate qui, ma la dipendenza principale di cui gli sviluppatori devono essere consapevoli è l'uso di Jquery.

Jquery è la libreria Javascript di base obbligatoria che viene utilizzata per tutte le chiamate agli oggetti BLE Spedmo e che non verrà rimossa presto. Altri framework come React / Angular ecc. Sono teoricamente disponibili per gli sviluppatori, tuttavia non esiste documentazione o supporto offerti per questi framework oltre a quelli già disponibili pubblicamente su qualsiasi forum online.

Oggetti Javascript BLE

Oggetto base

$ .spedmo

L'oggetto base che dovrebbe essere definito su tutte le rappresentazioni di una pagina è l'oggetto $ .spedmo . Questo oggetto non dovrebbe mai essere indefinito , se sta eseguendo il debug della causa principale molto probabilmente rivelerebbe un problema introdotto dallo sviluppatore che dovrebbe essere risolto prima di pubblicare l'applicazione. Se si sospetta un bug di causa non sviluppatore, non esitare a sollevare un bug sul progetto di esempio Spedmo Github per le indagini.

Evento pronto BLE

$ .spedmo.bleReady

Questo evento viene chiamato quando l'app Spedmo ha negoziato con successo con i piloti BLE vario. Gli sviluppatori dovrebbero presumere che quando questo evento viene chiamato il dispositivo BLE sta trasmettendo dati utili e questo dovrebbe essere generalmente il punto in cui è costruito il layout dello schermo iniziale per la visualizzazione dell'utente, nonché eventuali hook di eventi che devono essere stabiliti.

BLE Evento alimentazione riga non elaborata

$ .spedmo.ble.event.rawLineFeed

Questo è un evento dispositivo di basso livello che viene generato quando i dati vengono inviati dal dispositivo BLE e viene passato direttamente all'applicazione Developers senza analisi o filtro di alcun tipo. Ciò può essere utile per scrivere specifiche funzionalità del dispositivo o supporto per funzioni non ancora supportate dall'API Javascript Vario.

Evento di aggiornamento GPS BLE

$ .spedmo.ble.event.gpsUpdate

Questo evento viene generato quando un aggiornamento GPS è stato passato dal dispositivo BLE. Viene passato un oggetto stato che viene creato utilizzando la libreria GPS.js e ha il seguente formato.

  • ora: ora corrente
  • lat: latitudine
  • lon: Longitudine
  • alt: Altitudine (da non confondere con Vario Altitude)
  • satsActive: matrice di satelliti attivi
  • velocità: velocità fuori terra in km / h
  • traccia: traccia in gradi
  • satsVisible: matrice di tutti i satelliti visibili

Evento di aggiornamento dell'altitudine BLE

$ .spedmo.ble.event.altitudeUpdate

Questo evento viene generato quando è stato ricevuto un aggiornamento dell'altitudine dal dispositivo BLE. Viene passato un oggetto altitudine che ha il seguente formato.

  • loggerStored: logger archiviato (S / N)
  • iasKph: IAS (km / h)
  • baroAltitudeM: baroaltitude (m)
  • varioChangeMs1: vario (m / s) (ultime 6 misurazioni nell'ultimo secondo)
  • varioChangeMs2: vario (m / s) (ultime 6 misurazioni nell'ultimo secondo)
  • varioChangeMs3: vario (m / s) (ultime 6 misurazioni nell'ultimo secondo)
  • varioChangeMs4: vario (m / s) (ultime 6 misurazioni nell'ultimo secondo)
  • varioChangeMs5: vario (m / s) (ultime 6 misurazioni nell'ultimo secondo)
  • varioChangeMs6: vario (m / s) (ultime 6 misurazioni nell'ultimo secondo)
  • titolo: titolo
  • windCourseDeg: Wind Course (deg)
  • windSpeedKph: velocità del vento (km / h)