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 :
- Sortie de l'API /osc/info
- Sortie de l'API /osc/state
- Spécification de l'API OSC, commandes pour /osc/commands/execute
- Spécification de l'API OSC, paramètres de commande ; par exemple, paramètres pour les commandes
setOptions
etgetOptions
.
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" } |