कैमरा.startकैप्चर

विकल्प में मौजूद 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 का इस्तेमाल करके इमेज मिल जाएंगी. ऐसा तब होगा, जब क्लाइंट और कैमरे के बीच नया कनेक्शन बन जाएगा.

गड़बड़ियां

  • disableCommand: कमांड फ़िलहाल बंद है; उदाहरण के लिए, कैमरा वीडियो कैप्चर या इंटरवल कैप्चर के बीच में है.
  • अमान्य parameterName: पैरामीटर का नाम पहचाना नहीं गया; उदाहरण के लिए, sessionId की पहचान नहीं की गई.

निर्देश I/O
कमांड इनपुट 
none
कमांड आउटपुट 
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
कमांड आउटपुट (गड़बड़ी) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}