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

अक्षांश/देशांतर निर्देशांक सेव करके, इक्वीरेक्टेंगुलर इमेज कैप्चर करता है से 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 सही है, यह झलक का पूरा यूआरएल है इसका इस्तेमाल किया जा सकता है. इसका इस्तेमाल इमेज को प्रोसेस करने के लिए, पैसे भेजने के तरीके के तौर पर किया जा सकता है. नहीं तो, यह प्रोसेस की गई फ़ाइनल इमेज का पूरा यूआरएल होता है.

गड़बड़ियां

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

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