API Spedmo Javascript Vario

A API Spedmo Javascript Vario é criada usando a funcionalidade padrão da Web e, como resultado, todos os recursos padrão disponíveis com Javascript e navegadores modernos estão disponíveis para pilotos e desenvolvedores, sem restrição, além dos objetos específicos do Spedmo Vario listados abaixo.

Existem muitos tutoriais da Web e JavaScript disponíveis na Web para novos desenvolvedores, este documento da API não pretende ensinar aos desenvolvedores como programar, mas define os objetos específicos disponíveis para a criação de telas Vario personalizadas para dispositivos Android e IOS.

Entendendo a dependência do Spedmo App

A API Spedmo Javascript Vario usa uma compilação de aplicativos personalizada, disponível nas plataformas Android e IOS. Esta aplicação possui funcionalidade personalizada que pode negociar chamadas para varios BLE predefinidos através da aplicação. À medida que colocamos as mãos em mais dispositivos, a variedade de varios suportados aumentará com o tempo, mas a principal vantagem para os desenvolvedores é que o trabalho duro de programar diretamente para dispositivos BLE foi simplificado para reduzir a complexidade da programação e permitir que os pilotos se concentrassem especificamente no funcionalidade de exibição. O Spedmo App retorna eventos Javascript simplificados ao desenvolvedor, que podem ser usados para solicitar atualizações de exibição ou interação do usuário. Esse é o conceito fundamental por trás da estrutura que deve ser entendido antes que qualquer desenvolvimento seja iniciado.

Os desenvolvedores podem gerenciar a funcionalidade e as versões do aplicativo por meio do Spedmo App Manager e recomendamos a utilização do equipamento de teste do GitHub para criar a funcionalidade offline antes de fazer o upload da versão de teste.

Dependências de Javascript

Nem todas as dependências de Javascript estão listadas aqui, mas a principal dependência dos desenvolvedores é o uso do Jquery.

Jquery é a biblioteca Javascript básica obrigatória, usada para todas as chamadas de objeto Spedmo BLE e não será removida tão cedo. Outras estruturas, como React / Angular etc., estão teoricamente disponíveis para os desenvolvedores usarem, no entanto, não há documentação ou suporte oferecido para essas estruturas além do que já está disponível publicamente em qualquer fórum online.

Objetos Javascript BLE

Objeto base

$ .spedmo

O objeto base que deve ser definido em todas as renderizações de uma página é o objeto $ .spedmo . Esse objeto nunca deve ser indefinido , se estiver depurando a causa raiz provavelmente revelaria um problema introduzido pelo desenvolvedor que precisaria ser resolvido antes da publicação do aplicativo. Se houver suspeita de um erro de causa que não seja um desenvolvedor, sinta-se à vontade para gerá-lo no Spedmo Github Sample Project para investigação.

Evento Pronto para BLE

$ .spedmo.bleReady

Este evento é chamado quando o Spedmo App negocia com sucesso com os pilotos BLE vario. Os desenvolvedores devem assumir que, quando esse evento é chamado, o dispositivo BLE está transmitindo dados úteis e geralmente deve ser onde o layout da tela inicial é criado para a exibição do usuário, bem como quaisquer ganchos de eventos que precisam ser estabelecidos.

Evento de Feed de Linha Bruta do BLE

$ .spedmo.ble.event.rawLineFeed

Este é um evento de dispositivo de baixo nível que é acionado quando os dados são enviados do dispositivo BLE e passados diretamente para o aplicativo Developers sem nenhuma análise ou filtragem de qualquer tipo. Isso pode ser útil para escrever recursos específicos do dispositivo ou suporte para funções ainda não suportadas pela API Javascript Vario.

Evento de atualização do GPS BLE

$ .spedmo.ble.event.gpsUpdate

Este evento é acionado quando uma atualização de GPS é aprovada no dispositivo BLE. É passado um objeto de estado que é criado usando a biblioteca GPS.js e tem o seguinte formato.

  • time: hora atual
  • lat: Latitude
  • lon: Longitude
  • alt: Altitude (Não confunda com Vario Altitude)
  • satsActive: Matriz de satélites ativos
  • velocidade: velocidade sobre o solo em km / h
  • track: Acompanhe em graus
  • satsVisible: matriz de todos os satélites visíveis

Evento de atualização de altitude do BLE

$ .spedmo.ble.event.altitudeUpdate

Este evento é acionado quando uma atualização de altitude é recebida do dispositivo BLE. É passado um objeto de altitude com o seguinte formato.

  • loggerStored: registrador armazenado (S / N)
  • iasKph: IAS (km / h)
  • baroAltitudeM: baroaltitude (m)
  • varioChangeMs1: vario (m / s) (últimas 6 medições no último segundo)
  • varioChangeMs2: vario (m / s) (últimas 6 medições no último segundo)
  • varioChangeMs3: vario (m / s) (últimas 6 medições no último segundo)
  • varioChangeMs4: vario (m / s) (últimas 6 medições no último segundo)
  • varioChangeMs5: vario (m / s) (últimas 6 medições no último segundo)
  • varioChangeMs6: vario (m / s) (últimas 6 medições no último segundo)
  • cabeçalho: cabeçalho
  • windCourseDeg: Curso de vento (graus)
  • windSpeedKph: Velocidade do vento (km / h)