Spécificité du fournisseur

L'API niveau 1 de la spécification de l'API OSC est axée sur le type d'image, et la prise en charge vidéo est ajoutée dans l'API niveau 2. Les fabricants d'appareils photo sont invités à définir des commandes personnalisées et/ou à ajouter des paramètres aux commandes standard, si nécessaire. Il s'agit des éléments Commandes fournisseur et Paramètres fournisseur.

Le nom des commandes et paramètres spécifiques du fournisseur doit contenir des caractères alphanumériques précédés d'un tiret bas ( _ ).

La fonctionnalité de spécificité du fournisseur peut s'appliquer à quatre emplacements, comme suit :

Exemple

Requête (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"
    }
}
Réponse
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"
}
Requête
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",
        ...
    }
}
Réponse
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"
}