Principais mudanças na API de nível 2

Esta seção destaca todas as principais mudanças que deem ser compreendidas e consideradas em câmeras ou aplicativos.

Principais mudanças

  • sessionId ficou obsoleto e os comandos relacionados ficaram obsoletos ou foram modificados. A API de nível 2 foi projetada para uma conexão de um único cliente e o fabricante da câmera deve assegurar que apenas um cliente esteja conectado em um determinado momento (por exemplo, limitando as conexões Wi-Fi a somente uma).
  • Comandos obsoletos 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 imagens em intervalos e visualização ao vivo.
    • Comandos adicionados startCapture / stopCapture / getLivePreview / processPicture / reset.
    • listImages renomeado para listFiles e entradas/saídas foram modificadas para processar tipos de vídeo e imagens.
    • Opções adicionadas previewFormat, previewFormatSupport, captureInterval, captureIntervalSupport, captureNumber, captureNumberSupport, remainingVideoSeconds, pollingDelay, delayProcessing, delayProcessingSupport, clientVersion.
    • Opções modificadas captureModeSupport, isoSupport, shutterSpeedSupport, fileFormatSupport, hdr, hdrSupport, exposureBracket, exposureBracketSupport.
  • Especificação 360 video XMP adicionada.
  • Campo apiLevel adicionado à saída de /osc/info.
    • apiLevel: campo adicionado na API de nível 2. Se o campo não for informado, será usada a API de nível 1 por padrão. É responsabilidade do desenvolvedor recuperar essas informações e implementar de forma diferente de acordo com o valor.

Compatibilidade com versões anteriores

  • Fabricantes de câmeras: se você já mantinha a compatibilidade com a API de nível 1, é altamente recomendado que você passe a manter a compatibilidade com as APIs de nível 1 e 2 como solução intermediária por alguns meses antes da atualização final e forneça uma atualização de firmware para câmeras operando com a API de nível 1. Caso contrário, os clientes compatíveis apenas com a API de nível 1 não funcionarão com suas câmeras.
  • Desenvolvedores de aplicativos: esteja ciente de que essas mudanças afetam aplicativos previamente publicados é que é sua responsabilidade efetuar as mudanças correspondentes para processar as duas versões e lembrar os proprietários de câmera a atualizar o firmware.