OSC API स्पेसिफ़िकेशन का एपीआई लेवल 1, इमेज के टाइप पर फ़ोकस करता है और एपीआई लेवल 2 में वीडियो दिखाने की सुविधा जोड़ी गई है. कैमरा बनाने वालों को सलाह दी जाती है कि वे कस्टम निर्देश तय करें और/या ज़रूरत पड़ने पर स्टैंडर्ड निर्देशों के पैरामीटर सेट को बढ़ाएं. इन्हें वेंडर कमांड और वेंडर पैरामीटर के नाम से जाना जाता है.
वेंडर के लिए खास तौर पर दिए गए निर्देशों और पैरामीटर के नाम में अक्षर और अंक, दोनों होने चाहिए. साथ ही, इसके आगे अंडरस्कोर ( _ ) लगा होना चाहिए.
वेंडर के लिए खास सुविधाएं, नीचे बताए गए चार जगहों पर हो सकती हैं:
- /osc/info API का आउटपुट
- /osc/state API का आउटपुट
- OSC API की जानकारी, /osc/commands/exe प्रक्रिया के लिए निर्देश
- OSC API Specification, कमांड पैरामीटर; उदाहरण के लिए,
setOptions
औरgetOptions
कमांड के लिए पैरामीटर.
उदाहरण | |
---|---|
अनुरोध (एपीआई 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" } } |
जवाब | 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" } |
अनुरोध करें | 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", ... } } |
जवाब | 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" } |