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

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

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

पैरामीटर

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

नतीजे

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

गड़बड़ियां

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