Informationen

Die /osc/info API gibt grundlegende Informationen zur Kamera und zur Funktionalität zurück unterstützt wird.

Eingabe

  • Für diesen Befehl ist keine Eingabe erforderlich.

Ausgabe

Name Typ Beschreibung
manufacturer String Den Kamerahersteller
model String Das Kameramodell.
serialNumber String Seriennummer.
firmwareVersion String Aktuelle Firmwareversion.
supportUrl String URL der Support-Webseite für die Kamera.
gps Boolesch „True“, wenn die Kamera über GPS verfügt.
gyro Boolesch „True“, wenn die Kamera ein Gyroskop hat.
uptime Ganzzahl Anzahl der Sekunden seit dem Start der Kamera.
api String-Array Liste der unterstützten APIs.
endpoints Object Ein JSON-Objekt mit Informationen zu den Endpunkte der Kamera. Siehe die nächste Tabelle.
apiLevel Ganzzahl-Array Standardmäßig ist es [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-Ebene 2 hinzugefügt. Bitte geben Sie auch „2“ an, wenn Sie API 2.1 unterstützen.
cameraId String Eine eindeutige ID für die Kamera. Dieses Feld wurde in API-Ebene 2.1 hinzugefügt und ist für den direkten Upload relevant.
_vendorSpecific type Anbieterspezifische zusätzliche Informationen zur Kamera. Stellen Sie anbieterspezifischen Schlüsseln einen Unterstrich ( _ ) voran, um Namespace-Konflikte zu vermeiden.

endpoints Objekt

Dieses JSON-Objekt stellt Informationen zu den Ports bereit, die die Kamera für Endpunkte verwendet.

Hinweis: HTTPS-Endpunkte sind optional.

Name Typ Beschreibung
httpPort Ganzzahl Port für HTTP-Server. (Standardeinstellung: 80)
httpUpdatesPort Ganzzahl Port zum Empfangen von Updates über HTTP
httpsPort Ganzzahl (Optional) Port für HTTPS-Server. (Standardeinstellung: 443)
httpsUpdatesPort Ganzzahl (Optional) Port zum Empfangen von Updates über HTTPS.

Fehler

  • Dieser Befehl gibt keine Fehler zurück.

Beispiel
Anfrage 
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"
        ]
}