camera.listImages

يسرد جميع الصور في الكاميرا. تم إيقاف هذا الأمر نهائيًا في المستوى 2 من واجهة برمجة التطبيقات. يُرجى استخدام camera.listFiles بدلاً منها.

إذا كانت الكاميرا لا تتوافق مع المعلَمات المطلوبة، يجب أن تعرض الكاميرا أقصى إمكانات متاحة للأجهزة. على سبيل المثال، قد تكون هناك حالة نادرة الطلب: {entryCount: 500, maxSize: 2000}. وبدلاً من طرح خطأ، يجب أن يستند الرد إلى أقصى حد تدعمه الكاميرا، مثل: {entryCount: 100, maxSize: 200}. يُرجى طرح أخطاء لكل العناصر الأخرى الحالات على سبيل المثال، عندما يكون الطلب، {entryCount: 500, maxSize: -500}، من المفترض أن يعرض الخطأ invalidParameterValue لأن maxSize قيمة سالبة.

المعلمات

  • entryCount: عدد الإدخالات المطلوب عرضها.
  • maxSize: الحد الأقصى لحجم الصور المصغّرة max(الصورة المصغّرة: العرض المصغرة، الصورة المصغرة: الارتفاع). مطلوبة فقط عندما تكون السياسة 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: سلسلة Base64 مرمّزة للصورة المصغّرة (عند includeThumb == true).
  • totalEntries: إجمالي عدد الإدخالات في مساحة التخزين.
  • continuationToken: (اختياري) يتم ضبطه فقط في حال كانت النتيجة غير مكتملة. (تعني كلمة غير مكتملة أي بطاقة بيانات لا تتضمن الصورة الأخيرة). لجلب العناصر المتبقية على العميل، يستدعي العميل الأمر listImages مرة أخرى بالرمز المميز.

الأخطاء

  • مَعلمة مفقودة: لم يتم تحديد أي مَعلمة مطلوبة. على سبيل المثال، لم يتم تحديد entryCount.
  • spamPARAMName: اسم مَعلمة الإدخال هو. لم يتم التعرّف عليها.
  • invalidParameterValue: اسم معلَمة الإدخال هو ولكن تم التعرف عليها، ولكن قيمتها غير صالحة؛ على سبيل المثال، continuationToken غير موجود، وخارج النطاق، وبياناته النوع غير صحيح، أو نوع البيانات includeThumb غير صحيح، أو يحتوي maxSize على نوع بيانات خاطئ عندما تكون includeThumb صواب.

مفتاح Command 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."
    }
}