Cam.listImages

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

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

पैरामीटर

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

नतीजे

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

गड़बड़ियां

  • गुम पैरामीटर: कोई भी ज़रूरी पैरामीटर तय नहीं किया गया है; उदाहरण के लिए, entryCount तय नहीं किया गया है.
  • अमान्य parameterName: इनपुट पैरामीटर के नाम की पहचान नहीं की जा सकी.
  • अमान्य पैरामीटर वैल्यू: इनपुट पैरामीटर का नाम अमान्य है, लेकिन इसकी वैल्यू अमान्य है. उदाहरण के लिए, 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."
    }
}