API Level 2 – Wichtige Änderungen

In diesem Abschnitt sind alle wichtigen Änderungen aufgeführt, die Sie verstehen und bei Ihren Kameras oder Apps berücksichtigen müssen.

Wichtige Änderungen

  • sessionId wird nicht mehr unterstützt und die zugehörigen Befehle wurden geändert/verworfen. API Level 2 ist ist für eine Clientverbindung vorgesehen und der Kamerahersteller muss sicherstellen, dass jeweils nur ein Client verbunden ist (zum Beispiel durch Begrenzung auf eine WLAN-Verbindung).
  • Nicht mehr unterstützte Befehle getImage / getMetadata.
    • Die absolute URL einer Datei wird verwendet, um diese direkt vom HTTP-Server der Kamera herunterzuladen.
  • Befehle und Optionen für die Videoaufnahme, Intervallbildaufnahme und Live-Vorschau wurden hinzugefügt/geändert.
    • Die Befehle startCapture / stopCapture / getLivePreview / processPicture / reset wurden hinzugefügt.
    • listImages wurde in listFiles umbenannt und Ein-/Ausgaben wurden geändert, um Videotyp und Bildtyp zu unterstützen.
    • Die Optionen previewFormat, previewFormatSupport, captureInterval, captureIntervalSupport, captureNumber, captureNumberSupport, remainingVideoSeconds, pollingDelay, delayProcessing, delayProcessingSupport, clientVersion wurden hinzugefügt.
    • Die Optionen captureModeSupport, isoSupport, shutterSpeedSupport, fileFormatSupport, hdr, hdrSupport, exposureBracket, exposureBracketSupport wurden geändert.
  • Die Spezifikation 360 Video XMP wurde hinzugefügt.
  • Das Feld apiLevel wurde der Ausgabe /osc/info hinzugefügt.
    • apiLevel: Das Feld wurde in API Level 2 hinzugefügt. Wenn dieses Feld fehlt, wird standardmäßig davon ausgegangen, dass API Level 1 vorliegt. Es liegt in der Verantwortung des Entwicklers, diese Informationen abzurufen und basierend auf dem Wert unterschiedlich zu implementieren.

Abwärtskompatibilität

  • Kamerahersteller: Wenn API Level 1 unterstützt wurde, wird dringend empfohlen, als Zwischenlösung vor dem endgültigen Update für einige Monate API Level 1 und API Level 2 zu unterstützen und ein Firmware-Update für Kameras bereitzustellen, die unter API Level 1 ausgeführt werden. Andernfalls funktionieren Clients, die nur API Level 1 unterstützen, nicht mit Ihren Kameras.
  • App-Entwickler: Beachten Sie, dass sich diese Änderungen auf Ihre zuvor veröffentlichte App auswirken und dass Sie dafür verantwortlich sind, die entsprechenden Änderungen vorzunehmen, um beide Versionen zu unterstützen und die Besitzer der Kameras an die Aktualisierung Ihrer Firmware zu erinnern.