कैमरा.सूची फ़ाइलें

इसमें कैमरे की सभी इमेज/सभी वीडियो/सभी इमेज और वीडियो की सूची होती है. इसमें लगने वाला समय सभी फ़ाइलों की सूची बनाने के लिए कई अनुरोध करते हैं. यह निर्देश, एपीआई लेवल 2 में जोड़ा गया था.

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

पैरामीटर

  • fileType: सूची में शामिल की जाने वाली फ़ाइलों का टाइप, इनमें से कोई भी होना चाहिए ये तीन हैं: “इमेज”, ”वीडियो”, ”सभी”.
  • startPosition: (ज़रूरी नहीं) को सूची में वापस शामिल करना चाहिए. अगर जानकारी को शामिल नहीं किया जाता है, तो शुरुआत की जगह 0 होती है. इससे पता चलता है कि फ़ाइल दिखाई देती है. अगर यह आखिरी फ़ाइल की जगह से बड़ी है, तो ऐसा सामान्य रिस्पॉन्स जिसमें गड़बड़ी के रिस्पॉन्स के बजाय नतीजों में खाली एंट्री हों.
  • entryCount: रिटर्न के लिए मंज़ूर की गई एंट्री की संख्या. अगर ऐसा है की संख्या से ज़्यादा रहने दें, तो गड़बड़ी के जवाब के बजाय बची हुई असल फ़ाइलें.
  • maxThumbSize: थंबनेल इमेज का ज़्यादा से ज़्यादा साइज़; ज़्यादा से ज़्यादा(thumbnail_width, थंबनेल_height) जब क्लाइंट इसे null पर सेट करता है नतीजे में से थंबनेल इमेज को हटाना चाहता है.

नतीजे

  • एंट्री: इमेज प्रॉपर्टी की सूची. हर एंट्री में ये फ़ील्ड होने चाहिए अक्षांश और देशांतर को छोड़कर, जो ज़रूरी नहीं हैं:
    • name: फ़ाइल का नाम.
    • fileUrl: फ़ाइल का ऐब्सलूट यूआरएल, जिसका इस्तेमाल सीधे कैमरे से डाउनलोड करने के लिए किया जा सकता है.
    • size: फ़ाइल का साइज़, बाइट में.
    • dateTimeZone: फ़ाइल के लिए तारीख, समय, और टाइम ज़ोन का फ़ॉर्मैट: YYYY:MM:DD HH:MM:SS+(-)HH:MM. समय के लिए, 24-घंटे वाले फ़ॉर्मैट का इस्तेमाल करें. तारीख और समय को एक खाली वर्ण से अलग किया गया है. टाइम ज़ोन, यूटीसी समय से ऑफ़सेट है. कृपया ध्यान दें इससे पता चलता है कि वीडियो कैप्चर कब खत्म होता है.
    • lat: (ज़रूरी नहीं) फ़ाइल कैप्चर करते समय जगह का अक्षांश.
    • lng: (ज़रूरी नहीं) फ़ाइल कैप्चर करते समय जगह का देशांतर.
    • चौड़ाई: इमेज या हर वीडियो फ़्रेम की चौड़ाई.
    • ऊंचाई: इमेज या हर वीडियो फ़्रेम की ऊंचाई.
    • थंबनेल: Base64 से कोड में बदली गई स्ट्रिंग, फ़ाइल की थंबनेल इमेज के लिए (maxThumbSize != null होने पर).
    • isप्रोसेस किया गया: यह एक बूलियन वैल्यू होती है जिससे पता चलता है कि फ़ाइल प्रोसेस की गई हो (जैसे कि स्टिच की गई हो) या यह सिर्फ़ झलक के तौर पर हो. यह इस तारीख तक सही होना चाहिए डिफ़ॉल्ट तौर पर, अगर delayProcessing को 'सही है' पर सेट नहीं किया जाता है. अगर प्रोसेस की गई कोई इमेज मौजूद है, संबंधित झलक इमेज मौजूद नहीं होनी चाहिए, भले ही वह मौजूद हो, अगर ऐसा नहीं है, तो झलक वाली इमेज शामिल करें.
    • previewUrl: अगर delayProcessing है, तो खाली स्ट्रिंग पर डिफ़ॉल्ट रूप से सेट हो जाता है समर्थित नहीं है या जब isProcessed गलत के बराबर हो या जब पूर्वावलोकन चित्र मध्यवर्ती परिणाम के रूप में कभी जनरेट नहीं किया गया था, अन्यथा, यह फ़ाइनल इमेज से जुड़ी झलक वाली इमेज. इसका इस्तेमाल करके, झलक इमेज और फ़ाइनल इमेज के बीच संबंध.
  • totalEntries: यहां fileType की एंट्री की कुल संख्या स्टोरेज, जैसे कि अगर fileType "image" है, तो यह स्टोरेज.

गड़बड़ियां

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

कमांड I/O
कमांड इनपुट 
{
    "parameters": {
        "entryCount": 50,
        "maxThumbSize": 100
    }
}
कमांड आउटपुट 
{
    "results": {
        "entries": [
            {
                "name": "abc",
                "fileUrl": "file URL",
                "size":  file size, # of bytes,
                "dateTimeZone": "2014:12:27 08:00:00+08:00",
                "lat": 50.5324,
                "lng": -120.2332,
                "width": 2000,
                "height": 1000,
                "thumbnail": "ENCODEDSTRING",
                "isProcessed": true,
                "previewUrl": ""
            }
            ...
            {
                ...
            }
        ],
        "totalEntries": 250
    }
}
कमांड आउटपुट (गड़बड़ी) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter entryCount is negative."
    }
}