OSC API স্পেসিফিকেশনের API স্তর 1 চিত্রের প্রকারের উপর ফোকাস করে, এবং API স্তর 2-এ ভিডিও সমর্থন যোগ করা হয়েছে। ক্যামেরা নির্মাতাদের কাস্টম কমান্ডগুলি সংজ্ঞায়িত করতে এবং/অথবা প্রয়োজন হলে মানক কমান্ডের প্যারামিটার সেট প্রসারিত করতে উত্সাহিত করা হয়। এগুলি ভেন্ডর কমান্ড এবং ভেন্ডর প্যারামিটার নামে পরিচিত।
বিক্রেতা-নির্দিষ্ট কমান্ড এবং প্যারামিটারের নাম অবশ্যই বর্ণানুক্রমিক এবং একটি আন্ডারস্কোর ( _ ) সহ উপসর্গযুক্ত হতে হবে।
বিক্রেতা-নির্দিষ্ট কার্যকারিতা নিম্নরূপ চারটি জায়গায় ঘটতে পারে:
- /osc/info API-এর আউটপুট
- /osc/state API-এর আউটপুট
- OSC API স্পেসিফিকেশন , /osc/commands/execute-এর জন্য কমান্ড
- OSC API স্পেসিফিকেশন , কমান্ড পরামিতি; উদাহরণস্বরূপ,
setOptions
এবংgetOptions
কমান্ডের পরামিতি।
উদাহরণ | |
---|---|
অনুরোধ (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" } } |
প্রতিক্রিয়া | 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" } |