प्रोसेस की गई वे इमेज, जो पहले कैप्चर की गई थीं, लेकिन अब तक प्रोसेस नहीं की गई हैं.
यह निर्देश सिर्फ़ तब काम करता है, जब delayProcessing
पर काम करता है. इसकी वजह यह है कि प्रोसेसिंग में ज़्यादा समय लगता है. अगर आपने delayProcessing
पर काम नहीं किया,
तो इस निर्देश के लिए अनुरोध पूरा नहीं होगा. साथ ही, गड़बड़ी कोड बंद हो जाना चाहिए.
यह निर्देश, एपीआई लेवल 2 में जोड़ा गया था.
पैरामीटर
- previewFileUrls: प्रोसेस नहीं की गई इमेज के यूआरएल की सूची.
अगर आपको कैमरे में मौजूद, प्रोसेस नहीं की गई सभी इमेज को प्रोसेस करना है, तो यह [“सभी”] होगी.
इसे खाली नहीं छोड़ा जा सकता. अगर कैमरे को कोई इमेज प्रोसेस करने में समस्या आ रही है, तो कैमरा गड़बड़ी के साथ जवाब नहीं देता. इसके बजाय, इसे इस यूआरएल को अनदेखा करके अन्य यूआरएल के साथ आगे बढ़ना चाहिए. बहुत ही गंभीर मामला यह हो सकता है कि
previewToFinalFileUrls
को खाली JSONObject के तौर पर दिखाया जाए.
नतीजे
- previewToFINALFileUrls: JSON <key, value="">
जोड़े गए JSONObject हैं, जिनमें हर कुंजी, झलक वाली इमेज का पूरा यूआरएल होती है. साथ ही, हर कुंजी, प्रोसेस की गई आखिरी इमेज होती है और इसे सीधे कैमरे से डाउनलोड करने के लिए इस्तेमाल किया जा सकता है. कृपया ध्यान रखें कि यह निर्देश, Cam.takepicture की तरह ही है. यह तुरंत
previewToFinalFileUrls
नहीं दिखाता (इस पैराग्राफ़ में बाद में बताए गए कोने के केस को छोड़कर), क्योंकि प्रोसेसिंग (इसमें कैमरे के अंदर की स्टिचिंग भी शामिल है) को पूरा होने में आम तौर पर कुछ समय (सेकंड से मिनट तक) लगता है. निर्देश की प्रोग्रेस की पुष्टि करने के लिए, कैमरे को समय-समय पर /osc/commands/status एपीआई का इस्तेमाल करके पोल कराया जाता है. कमांड पूरा होने पर,previewToFinalFileUrls
नतीजा मिलता है. अगर निर्देश पूरा होने से पहले ही कैमरे से कनेक्शन टूट जाता है, तो क्लाइंट फिर से कैमरे से कनेक्ट होने पर, फ़ाइनल इमेज के यूआरएल पाने के लिएlistFiles
का इस्तेमाल कर सकता है या प्रोसेस के लिए कोई दूसरा निर्देश जारी कर सकता है. अगर इमेज को फिर से कनेक्ट करने से पहले, प्रोसेस किया गया है, तो उसके तुरंत बादpreviewToFinalFileUrls
दिखेगा.</key,>
गड़बड़ियां
- disableCommand: अगर यह सुविधा देरी से प्रोसेस करने की सुविधा नहीं देती है.
- अमान्य parameterName: इनपुट पैरामीटर के नाम की पहचान नहीं की जा सकी.
- अमान्यparameterValue: इनपुट पैरामीटर के नाम की
पहचान की जाती है, लेकिन इसकी वैल्यू अमान्य है. उदाहरण के लिए,
previewFileUrls
में मौजूद कोई भी यूआरएल अमान्य है.
निर्देश I/O | |
---|---|
कमांड इनपुट | { "parameters": { "previewFileUrls": [ "previewFileUrl1", "previewFileUrl2", "previewFileUrl3", ... "previewFileUrln" ] } } |
कमांड आउटपुट | { "results": { "previewToFinalFileUrls":{ "previewFileUrl1": "finalFileUrl1", "previewFileUrl2": "finalFileUrl2", "previewFileUrl3": "finalFileUrl3", ... "previewFileUrln": "finalFileUrln" } } } |
कमांड आउटपुट (गड़बड़ी) | { "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |