Novidades

API de nível 2.1

Lançado em maio de 2017

Principais mudanças

  • Foi adicionado o Upload direto para permitir que as câmeras façam upload diretamente nos servidores.
    • Inclui os novos comandos switchWifi e uploadFile.
    • Adicionadas opções photoStitchingSupport, photoStitching, videoStitchingSupport, videoStitching, videoGPSSupport, videoGPS às opções de OSC.
    • Adicionamos o campo cameraId à saída /osc/info.
  • Substituímos a especificação XMP em 360° por um novo padrão aberto.
  • Foi adicionada recomendação para especificar a make/model da câmera em vídeos MP4s em 360o.

API de nível 2

Lançada em julho de 2016

Principais mudanças

  • O uso de sessionId foi descontinuado e os comandos relacionados foram descontinuados/modificados. A API de nível 2 foi projetada para uma conexão de cliente, e os fabricantes de câmeras precisam garantir que apenas um cliente esteja conectado por vez (por exemplo, limitando apenas uma conexão Wi-Fi).
  • Comandos descontinuados getImage / getMetadata.
    • O URL absoluto de um arquivo é usado para fazer o download diretamente do servidor HTTP da câmera.
  • Comandos e opções adicionados/modificados para captura de vídeo, captura de imagem em intervalos e visualização em tempo real.
    • Foram adicionados os comandos startCapture / stopCapture / getLivePreview / processPicture / reset.
    • Renomeação de listImages para listFiles e entradas/saídas modificadas para processar tipos de vídeo e de imagem.
    • As opções previewFormat, previewFormatSupport, captureInterval, captureIntervalSupport, captureNumber, captureNumberSupport, remainingVideoSeconds, pollingDelay, delayProcessing, delayProcessingSupport e clientVersion foram adicionadas.
    • As opções captureModeSupport, isoSupport, shutterSpeedSupport, fileFormatSupport, hdr, hdrSupport, exposureBracket e exposureBracketSupport foram modificadas.
  • Adicionamos a especificação XMP em 360 vídeos.
  • Adicionamos o campo apiLevel à saída /osc/info.
    • apiLevel: o campo foi adicionado na API de nível 2. Ela é considerada a API de nível 1 por padrão quando esse campo está ausente. É responsabilidade dos desenvolvedores extrair essas informações e implementar de maneira diferente com base no valor.

Compatibilidade com versões anteriores

  • Fabricantes de câmeras: se você oferece suporte ao nível 1 da API, é recomendável oferecer suporte aos níveis 1 e 2 da API como solução intermediária por alguns meses antes da atualização final e fornecer uma atualização de firmware para câmeras que executam a API de nível 1. Caso contrário, os clientes que oferecem suporte apenas à API de nível 1 não vão funcionar com suas câmeras.
  • Desenvolvedores de apps: estejam cientes de que essas mudanças afetam seu app publicado anteriormente, e é sua responsabilidade fazer alterações correspondentes para processar as duas versões e lembrar os proprietários de câmeras de atualizar o firmware.