Lieferantenspezifisch

Das API-Level 1 der OSC-API-Spezifikation konzentriert sich auf den Image-Typ. Videosupport wird in API-Ebene 2 hinzugefügt. Kameraherstellern wird empfohlen, benutzerdefinierte Befehle zu definieren und/oder den Parametersatz der Standardbefehle bei Bedarf zu erweitern. Diese werden als Anbieterbefehle und Anbieterparameter bezeichnet.

Der Name der anbieterspezifischen Befehle und Parameter muss alphanumerisch sein und mit einem Unterstrich ( _ ) versehen sein.

Lieferantenspezifische Funktionen sind an folgenden vier Stellen möglich:

Beispiel
Anfrage (API 1) 
POST /osc/commands/execute HTTP/1.1
Host: [camera ip address]:[httpPort]
Content-Type: application/json;charset=utf-8
Accept: application/json
Content-Length: {CONTENT_LENGTH}
X-XSRF-Protected: 1

{
    "name": "camera.setOptions",
    "parameters": {
        "sessionId": "12ABC3",
        "iso": 200,
        "exposureCompensation": -2,
        "captureMode": "_video"
    }
}
Antwort 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
    "name": "camera.setOptions",
    "state": "done"
}
Anfrage 
POST /osc/commands/execute HTTP/1.1
Host: [camera ip address]:[httpPort]
Content-Type: application/json;charset=utf-8
Accept: application/json
Content-Length: {CONTENT_LENGTH}
X-XSRF-Protected: 1

{
    "name": "camera._startRecording",
    "parameters": {
        "sessionId": "12ABC3",
        ...
    }
}
Antwort 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
    "name": "camera._startRecording",
    "state": "done"
}