camera.listImages

ক্যামেরায় থাকা সমস্ত ছবি তালিকাভুক্ত করে। এপিআই লেভেল 2-এ এই কমান্ডটি বাতিল করা হয়েছে। পরিবর্তে camera.listFiles ব্যবহার করুন।

যদি একটি ক্যামেরা অনুরোধ করা পরামিতিগুলিকে সমর্থন না করে, তাহলে ক্যামেরাটিকে হার্ডওয়্যারের জন্য উপলব্ধ সর্বোচ্চ ক্ষমতা ফিরিয়ে দিতে হবে। উদাহরণস্বরূপ, একটি বিরল ক্ষেত্রে অনুরোধ হতে পারে: {entryCount: 500, maxSize: 2000} । একটি ত্রুটি নিক্ষেপ করার পরিবর্তে, প্রতিক্রিয়াটি ক্যামেরা দ্বারা সমর্থিত সর্বাধিক ক্ষমতার উপর ভিত্তি করে হওয়া উচিত, যেমন: {entryCount: 100, maxSize: 200} । অন্য সব ক্ষেত্রে ত্রুটি নিক্ষেপ করুন; উদাহরণস্বরূপ, যখন অনুরোধটি হয়, {entryCount: 500, maxSize: -500} , তখন এটি ত্রুটিটি invalidParameterValue ফেলতে হবে যেহেতু maxSize নেতিবাচক।

পরামিতি

  • entryCount: প্রত্যাবর্তনের জন্য পছন্দসই সংখ্যা।
  • maxSize: থাম্বনেইল ছবির সর্বাধিক আকার; সর্বোচ্চ (থাম্বনেল_প্রস্থ, থাম্বনেইল_উচ্চতা)। শুধুমাত্র includeThumb সত্য হলেই প্রয়োজন (নীচে)।
  • continuationToken: (ঐচ্ছিক) টাইপ স্ট্রিং এর একটি অস্বচ্ছ ধারাবাহিকতা টোকেন, পূর্ববর্তী listImages কল দ্বারা ফিরে, পরবর্তী চিত্রগুলি পুনরুদ্ধার করতে ব্যবহৃত হয়। প্রথম listImages কলের জন্য এই প্যারামিটারটি বাদ দিন। দ্রষ্টব্য: টোকেন তৈরি করে এমন অ্যালগরিদমের জন্য ক্যামেরা দায়ী।
  • includeThumb: (ঐচ্ছিক) ডিফল্ট থেকে true । ফলাফল থেকে থাম্বনেইল ছবি বাদ দিতে false ব্যবহার করুন।

ফলাফল

  • এন্ট্রি: ছবির বৈশিষ্ট্যের একটি তালিকা। প্রতিটি এন্ট্রিতে অক্ষাংশ এবং দ্রাঘিমাংশ ছাড়া নিম্নলিখিত ক্ষেত্রগুলি থাকা উচিত, যা ঐচ্ছিক:
    • name : নাম
    • uri : URI
    • size : বাইটে আকার
    • dateTimeZone : ছবির জন্য তারিখ, সময় এবং সময় অঞ্চল, বিন্যাসে: YYYY:MM:DD HH:MM:SS+(-)HH:MM । সময়ের জন্য 24-ঘন্টা বিন্যাস ব্যবহার করুন। তারিখ এবং সময় একটি ফাঁকা অক্ষর দ্বারা পৃথক করা হয়. সময় অঞ্চল UTC সময় থেকে অফসেট করা হয়।
    • lat : (ঐচ্ছিক) চিত্র ক্যাপচার অবস্থানের অক্ষাংশ।
    • lng : (ঐচ্ছিক) ছবির ক্যাপচার অবস্থানের দ্রাঘিমাংশ।
    • width : চিত্রের প্রস্থ
    • height : ছবির উচ্চতা
    • thumbnail : থাম্বনেইল ছবির জন্য বেস64 এনকোড করা স্ট্রিং (যখন includeThumb == true )।
  • totalEntry: স্টোরেজে মোট এন্ট্রির সংখ্যা।
  • continuationToken: (ঐচ্ছিক) ফলাফল অসম্পূর্ণ হলেই সেট করুন ( অসম্পূর্ণ মানে শেষ ছবি অন্তর্ভুক্ত নয় এমন কোনো তালিকা)। অবশিষ্ট এন্ট্রি আনতে, ক্লায়েন্টকে টোকেন সহ আবার listImages কমান্ড কল করা উচিত।

ত্রুটি

  • missingParameter: কোনো প্রয়োজনীয় প্যারামিটার নির্দিষ্ট করা নেই; উদাহরণস্বরূপ, entryCount নির্দিষ্ট করা নেই।
  • invalidParameterName: ইনপুট প্যারামিটার নামটি অচেনা।
  • 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."
    }
}