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

EXIF (अगर आपके कैमरे में खुद का GPS या GPS चालू है, कनेक्ट किए गए मोबाइल फ़ोन पर चालू है) में अक्षांश/देशांतर निर्देशांक सेव करते हुए, इक्वीरेक्टैंग्युलर इमेज कैप्चर करता है. अगर ज़रूरी हो, तो इस कमांड कॉल से पहले camera.setOptions को कॉल करें. इस निर्देश को एपीआई लेवल 2 में बदला गया था.

पैरामीटर

  • sessionId: camera.startSession कमांड से मिला यूनीक सेशन आइडेंटिफ़ायर. यह फ़ील्ड, एपीआई लेवल 2 में बंद कर दिया गया था.

नतीजे

  • एपीआई लेवल 1
    • fileUri: कैप्चर की गई इमेज का यूआरआई. मैन्युफ़ैक्चरर यह तय करते हैं कि पूरे यूआरआई का इस्तेमाल करना है या मिलते-जुलते यूआरआई का. उदाहरण के लिए, "http://android.com/robots.txt" एक ऐब्सलूट यूआरआई है, जबकि "robots.txt" एक रिलेटिव यूआरआई है. क्लाइंट इसे ओपेक आइडेंटिफ़ायर मान सकते हैं.
  • एपीआई लेवल 2
    • fileUrl: कैप्चर की गई इमेज का पूरा यूआरएल, जिसका इस्तेमाल सीधे कैमरे के एचटीटीपी सर्वर से डाउनलोड करने के लिए किया जा सकता है. कृपया ध्यान दें कि इस निर्देश के बाद fileUrl तुरंत नहीं मिलता, क्योंकि कैप्चर करने (इसमें कैमरे के अंदर स्टिचिंग भी शामिल है) को पूरा होने में आम तौर पर कुछ समय (सेकंड से लेकर मिनट तक अलग-अलग होता है) लगता है. निर्देश की प्रोग्रेस, कैमरे के ज़रिए समय-समय पर /osc/commands/status एपीआई का इस्तेमाल करके हासिल की जाती है. कमांड पूरा होने पर, fileUrl नतीजा मिलता है. delayProcessing सही होने पर, यह झलक वाली इमेज का कुल यूआरएल होता है, जिसका इस्तेमाल इमेज को प्रोसेस करने के लिए प्रोसेस में इनपुट के तौर पर किया जा सकता है. ऐसा न होने पर, यह प्रोसेस की गई आखिरी इमेज का पूरा यूआरएल होगा.

गड़बड़ियां

  • missing पैरामीटर: sessionId मौजूद नहीं है. गड़बड़ी के इस कोड को एपीआई लेवल 2 में हटा दिया गया था.
  • अमान्यparameterName: पैरामीटर का नाम पहचाना नहीं जा सका, उदाहरण के लिए, एपीआई लेवल 2 में sessionId की पहचान नहीं की गई.
  • अमान्य पैरामीटर वैल्यू: इनपुट पैरामीटर का नाम सही है, लेकिन इसकी वैल्यू अमान्य है. उदाहरण के लिए, sessionId मौजूद नहीं है, अब चालू नहीं है या उसका डेटा टाइप गलत है. गड़बड़ी के इस कोड को एपीआई लेवल 2 में हटा दिया गया था.
  • disableCommand: फ़िलहाल यह निर्देश बंद है; उदाहरण के लिए, कैमरा वीडियो शूटिंग मोड में है. गड़बड़ी का यह कोड, एपीआई लेवल 2 में जोड़ा गया था.

निर्देश I/O

कमांड इनपुट (एपीआई लेवल 1)
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
कमांड आउटपुट (एपीआई लेवल 1)
{
    "results": {
        "fileUri": "file URI"
    }
}
कमांड आउटपुट (गड़बड़ी) (एपीआई लेवल 1)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
कमांड इनपुट (एपीआई लेवल 2)
none
कमांड आउटपुट (एपीआई लेवल 2)
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
कमांड आउटपुट (गड़बड़ी) (एपीआई लेवल 2)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}