Cam.listImages

कैमरे की सभी इमेज की सूची बनाता है. इस निर्देश को एपीआई लेवल 2 में बंद कर दिया गया था. इसके बजाय, कृपया camera.listFiles का इस्तेमाल करें.

अगर कैमरा, अनुरोध किए गए पैरामीटर के साथ काम नहीं करता है, तो कैमरे को हार्डवेयर के लिए उपलब्ध अधिकतम क्षमता. उदाहरण के लिए, बहुत कम मामलों में अनुरोध: {entryCount: 500, maxSize: 2000}. गड़बड़ी दिखाने के बजाय, तो जवाब, कैमरे के साथ काम करने वाली ज़्यादा से ज़्यादा क्षमता के हिसाब से होना चाहिए, जैसे: {entryCount: 100, maxSize: 200}. कृपया अन्य सभी गड़बड़ियों की जानकारी दें मामले; उदाहरण के लिए, अगर अनुरोध {entryCount: 500, maxSize: -500} है, तो गड़बड़ी invalidParameterValue डालनी चाहिए, क्योंकि maxSize नेगेटिव है.

पैरामीटर

  • entryCount: रिटर्न के लिए मंज़ूर की गई एंट्री की संख्या.
  • maxSize: थंबनेल इमेज का ज़्यादा से ज़्यादा साइज़; ज़्यादा से ज़्यादा(thumbnail_width, थंबनेल_height) सिर्फ़ तब ज़रूरी है, जब includeThumb सही हो (नीचे).
  • continuationToken: (ज़रूरी नहीं) टाइप स्ट्रिंग का ओपेक कंटिन्यूएशन टोकन, जो पिछले listImages कॉल से मिलता है. इसका इस्तेमाल, अगली इमेज वापस पाने के लिए किया जाता है. पहले listImages कॉल के लिए इस पैरामीटर को हटा दें. ध्यान दें: कैमरा, टोकन जनरेट करने वाले एल्गोरिदम के लिए ज़िम्मेदार है.
  • includeThumb: (ज़रूरी नहीं) डिफ़ॉल्ट रूप से true पर सेट होता है. नतीजे में से थंबनेल इमेज को हटाने के लिए, false का इस्तेमाल करें.

नतीजे

  • एंट्री: इमेज प्रॉपर्टी की सूची. हर एंट्री में ये फ़ील्ड होने चाहिए अक्षांश और देशांतर को छोड़कर, जो ज़रूरी नहीं हैं:
    • name: नाम
    • uri: यूआरआई
    • size: बाइट में साइज़
    • dateTimeZone: इमेज के लिए तारीख, समय, और टाइम ज़ोन, इस फ़ॉर्मैट में: YYYY:MM:DD HH:MM:SS+(-)HH:MM. समय के लिए, 24-घंटे वाले फ़ॉर्मैट का इस्तेमाल करें. तारीख और समय को एक खाली जगह से अलग किया गया हो वर्ण. टाइम ज़ोन, यूटीसी समय से ऑफ़सेट है.
    • lat: (ज़रूरी नहीं) इमेज कैप्चर करने की जगह का अक्षांश.
    • lng: (ज़रूरी नहीं) इमेज लेने की जगह का देशांतर.
    • width: इमेज की चौड़ाई
    • height: इमेज की ऊंचाई
    • thumbnail: थंबनेल इमेज के लिए Base64 कोड में बदली गई स्ट्रिंग (जब includeThumb == true).
  • totalEntries: स्टोरेज में एंट्री की कुल संख्या.
  • continuationToken: (ज़रूरी नहीं) सिर्फ़ तब सेट करें, जब नतीजा अधूरा हो (अधूरा का मतलब है, ऐसी लिस्टिंग जिसमें आखिरी इमेज शामिल न हो). बचे हुए डेटा को फ़ेच करने के लिए एंट्री के लिए, क्लाइंट को टोकन के साथ listImages कमांड को फिर से कॉल करना होगा.

गड़बड़ियां

  • missingपैरामीटर: कोई भी ज़रूरी पैरामीटर नहीं दिया गया है; उदाहरण के लिए, entryCount बताया नहीं गया है.
  • अमान्य पैरामीटर का नाम: इनपुट पैरामीटर का नाम यह है पहचान नहीं की जा सकी.
  • invalidParameterValue: इनपुट पैरामीटर का नाम यह है पहचाना गया, लेकिन इसका मान अमान्य है; उदाहरण के लिए, continuationToken मौजूद नहीं है, रेंज से बाहर है, इसका डेटा टाइप गलत है, includeThumb का डेटा टाइप गलत है या जब includeThumb होता है, तो maxSize का डेटा टाइप गलत होता है सही है.

कमांड I/O
कमांड इनपुट 
{
    "parameters": {
        "entryCount": 50,
        "maxSize": 100,
        "includeThumb": true
    }
}
कमांड आउटपुट 
{
    "results": {
        "entries": [
            {
                "name": "abc",
                "uri": "image URI",
                "size": image size in bytes,
                "dateTimeZone": "2014:12:27 08:00:00+08:00"
                "lat": 50.5324
                "lng": -120.2332
                "width": 2000
                "height": 1000
                "thumbnail": "ENCODEDSTRING"
            }
            ...
            {
                ...
            }
        ],
        "totalEntries": 250,
        "continuationToken": "50"
    }
}
कमांड आउटपुट (गड़बड़ी) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter continuationToken is out of range."
    }
}