Info

In der API /osc/info werden grundlegende Informationen zur Kamera und den von der Kamera unterstützten Funktionen zurückgegeben.

Eingabe

  • Für diesen Befehl sind keine Eingaben möglich.

Ausgabe

Name Typ Beschreibung
manufacturer Zeichenfolge Der Hersteller der Kamera
model Zeichenfolge Das Kameramodell
serialNumber Zeichenfolge Die Seriennummer
firmwareVersion Zeichenfolge Die aktuelle Firmware-Version.
supportUrl Zeichenfolge Die URL für die Support-Webseite der Kamera
gps Boolescher Wert Der Wert ist „True“, wenn die Kamera über GPS verfügt.
gyro Boolescher Wert Der Wert ist „True“, wenn die Kamera über ein Gyroskop verfügt.
uptime Ganzzahl Anzahl Sekunden nach dem Start der Kamera.
api Zeichenfolgenarray Liste der unterstützten APIs.
endpoints Objekt Ein JSON-Objekt, das Informationen zu den Endgeräten der Kamera enthält. Siehe nachfolgende Tabelle.
apiLevel Ganzzahlarray Standardmäßig [1], wenn dieses Feld fehlt. [1, 2] bedeutet, dass API 1 und 2 unterstützt werden, während [2] bedeutet, dass nur API 2 unterstützt wird. Es liegt in der Verantwortung des Entwicklers, diese Informationen abzurufen und basierend auf dem Wert unterschiedlich zu implementieren. Dieses Feld wurde in API Level 2 hinzugefügt.
_vendorSpecific [Typ] (optional) Lieferantenspezifische Zusatzinformationen zur Kamera. Ein Unterstrich („_“) sollte vorangestellt sein, um Namensraumkonflikte zu vermeiden.

Objekt endpoints

Dieses JSON-Objekt liefert Informationen zu den Anschlüssen, die von der Kamera für Endgeräte verwendet werden.

Name Typ Beschreibung
httpPort Ganzzahl Port für HTTP-Server. (Der Standardport ist 80.)
httpUpdatesPort Ganzzahl Port für den Empfang von Updates über HTTP
httpsPort Ganzzahl (Optional) Port für HTTPS-Server. (Der Standardport ist 443.)
httpsUpdatesPort Ganzzahl Port für den Empfang von Updates über HTTPS

Fehler

  • Dieser Befehl führt nicht zu zurückgegebenen Fehlern.

Beispiel
Anforderung 
GET /osc/info HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Antwort (API 2) 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ],
        "apiLevel": [1, 2]
}
Antwort (API 1) 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ]
}