Principaux changements de l'API niveau 2

Cette section présente les principaux changements que vous devez connaître et gérer dans vos appareils photo ou applications.

Principaux changements

  • Paramètre sessionId obsolète et commandes associées obsolètes/modifiées. L'API niveau 2 est conçue pour la connexion d'un client unique. Les fabricants d'appareils photo doivent s'assurer qu'un seul client est connecté à la fois (en imposant une limite d'une seule connexion Wi-Fi, par exemple).
  • Commandes obsolètes : getImage / getMetadata.
    • L'URL absolue du fichier est utilisée pour télécharger directement les données à partir du serveur HTTP de l'appareil photo.
  • Commandes et options ajoutées/modifiées pour l'enregistrement vidéo, la prise de photos à intervalles et la visualisation en temps réel.
    • Commandes ajoutées : startCapture / stopCapture / getLivePreview / processPicture / reset.
    • Commande listImages renommée listFiles et entrées/sorties modifiées pour gérer le type de vidéo et le type d'image.
    • Options ajoutées : previewFormat, previewFormatSupport, captureInterval, captureIntervalSupport, captureNumber, captureNumberSupport, remainingVideoSeconds, pollingDelay, delayProcessing, delayProcessingSupport, clientVersion.
    • Options modifiées : captureModeSupport, isoSupport, shutterSpeedSupport, fileFormatSupport, hdr, hdrSupport, exposureBracket, exposureBracketSupport.
  • Spécification XMP de vidéo immersive ajoutée.
  • Champ apiLevel ajouté à la sortie de /osc/info.
    • apiLevel : Champ ajouté dans l'API niveau 2. Elle est considérée comme étant API niveau 1 par défaut si ce champ est manquant. Il relève de la responsabilité du développeur d'extraire cette information et d'adapter l'implémentation selon cette valeur.

Rétrocompatibilité

  • Fabricants d'appareils photo : Si vous prenez en charge l'API niveau 1, il est vivement recommandé de prendre en charge à la fois l'API niveau 1 et l'API niveau 2 comme solution intermédiaire pendant quelques mois avant la mise à jour finale et de fournir une mise à jour du micrologiciel pour les appareils photo qui exécutent l'API niveau 1. Sinon, les clients prenant en charge uniquement l'API niveau 1 ne seront pas compatibles avec vos appareils photo.
  • Développeurs d'applications : Notez bien que ces changements ont un impact sur les applications que vous avez déjà publiées. Il relève de votre responsabilité d'effectuer les changements appropriés pour gérer les deux versions et de rappeler aux propriétaires des appareils photo de mettre à jour leur micrologiciel.