विकल्प में मौजूद captureMode
की वैल्यू के आधार पर, वीडियो कैप्चर करना या इंटरवल इमेज कैप्चर करना शुरू करता है.
यह निर्देश, एपीआई लेवल 2 में जोड़ा गया था.
पैरामीटर
- अनुरोध के मुख्य हिस्से में, इस निर्देश का कोई पैरामीटर नहीं है. यह
captureMode
विकल्प से तय होता है कि यह इंटरवल इमेज कैप्चर है या वीडियो कैप्चर. इंटरवल कैप्चर करने के लिए, चाहे यह ओपन एंडेड कैप्चर हो या नहीं, यह इस बात पर निर्भर करता है किcaptureNumber
, 0 के बराबर है या उससे ज़्यादा है. इंटरवल कैप्चर करने से पहले,captureMode
,captureInterval
, औरcaptureNumber
को सेट करना ज़रूरी है. वीडियो कैप्चर करने से पहले सिर्फ़captureMode
को "वीडियो" पर सेट करना ज़रूरी है, जिसे सिर्फ़ camera.stopCapture निर्देश से रोका जा सकता है.
नतीजे
- ओपन-एंडेड कैप्चर (जब CaptureMode == "video" या CaptureNumber == 0 हो)
- कोई नतीजा नहीं मिला.
- नॉन-ओपन-एंडेड इंटरवल कैप्चर:
- fileUrls: यह ऐसे सटीक यूआरएल की सूची होती है जो इंटरवल कैप्चर करने के लिए, इमेज फ़ाइलों पर ले जाते हैं. कृपया ध्यान दें कि यह निर्देश तुरंत
fileUrls
नहीं दिखता, क्योंकि कैप्चर पूरा होने मेंcaptureNumber
का समय लगता है. कैमरे को समय-समय पर पोल कराते हुए, निर्देश की प्रोग्रेस को समझा जा सकता है. उदाहरण के लिए, /osc/commands/status एपीआई का इस्तेमाल करके, अनुमानित अवधि (time = captureInterval * (captureNumber - 1)
) के बाद पोल और निर्देश पूरा होने परfileUrls
नतीजा मिलता है. अगर निर्देश प्रोसेस नहीं होता है (जैसे कि कैमरे की बैटरी खत्म होने से पहले सिर्फ़ तीन इमेज ली गई थीं) या क्लाइंट फ़ोन से कैमरा बीच में डिसकनेक्ट हो जाता है, लेकिन निर्देश सही तरीके से पूरा होता है, तो क्लाइंट कोcamera.listFiles
का इस्तेमाल करके इमेज मिल जाएंगी. ऐसा तब होगा, जब क्लाइंट और कैमरे के बीच नया कनेक्शन बन जाएगा.
- fileUrls: यह ऐसे सटीक यूआरएल की सूची होती है जो इंटरवल कैप्चर करने के लिए, इमेज फ़ाइलों पर ले जाते हैं. कृपया ध्यान दें कि यह निर्देश तुरंत
गड़बड़ियां
- disableCommand: कमांड फ़िलहाल बंद है; उदाहरण के लिए, कैमरा वीडियो कैप्चर या इंटरवल कैप्चर के बीच में है.
- अमान्य parameterName: पैरामीटर का नाम पहचाना नहीं गया; उदाहरण के लिए,
sessionId
की पहचान नहीं की गई.
निर्देश I/O | |
---|---|
कमांड इनपुट | none |
कमांड आउटपुट | { "results": { "fileUrls":[ "url1", "url2", "url3", ... "urln" ] } } |
कमांड आउटपुट (गड़बड़ी) | { "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |