تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

camera.listImages

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

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

المَعلمات

entryCount: هو العدد المطلوب من الإدخالات.
maxSize: الحد الأقصى لحجم الصور المصغّرة، وmax(chromium_width, min_height). تكون هذه السمة مطلوبة فقط عند ضبط قيمة السمة includeThumb (أدناه).
coninuationToken: (اختياري) يشير إلى رمز مميز للمتابعة مبهم من نوع السلسلة، ويتم عرضه من خلال استدعاء listImages سابق، ويُستخدم لاسترداد الصور التالية. احذف هذه المَعلمة لاستدعاء listImages الأول. ملاحظة: تكون الكاميرا مسؤولة عن الخوارزمية التي تُنشئ الرمز المميّز.
includeThumb: (اختياري) الإعداد التلقائي على true. استخدِم false لحذف الصور المصغّرة من النتيجة.

النتائج

الإدخالات: قائمة بخصائص الصور يجب أن يحتوي كل إدخال على الحقول التالية باستثناء خطوط الطول والعرض الاختيارية:
- name: الاسم
- uri: معرّف الموارد المنتظم (URI)
- size: الحجم بالبايت
- dateTimeZone: التاريخ والوقت والمنطقة الزمنية للصورة، بالتنسيق: YYYY:MM:DD HH:MM:SS+(-)HH:MM. استخدم تنسيق 24 ساعة للوقت. يتم فصل التاريخ والوقت بحرف واحد فارغ. تتم معادلة المنطقة الزمنية من التوقيت العالمي المنسَّق.
- lat: (اختياري) خط العرض لموقع التقاط الصورة.
- lng: (اختياري) خط الطول لموقع التقاط الصورة.
- width: عرض الصورة
- height: ارتفاع الصورة
- thumbnail: سلسلة Base64 المشفرة للصورة المصغّرة (عندما includeThumb == true)
totalEntries: إجمالي عدد الإدخالات في مساحة التخزين.
continuationToken: (اختيارية) لا يتم ضبطها إلا إذا كانت النتيجة غير مكتملة (تعني incomplete أي بطاقة بيانات لا تتضمن الصورة الأخيرة). لجلب الإدخالات المتبقية، يجب على العميل استدعاء الأمر listImages مرة أخرى باستخدام الرمز المميّز.

الأخطاء

missingParameter: لم يتم تحديد أي معلمة مطلوبة. على سبيل المثال، لم يتم تحديد entryCount.
unusedParameterName: لم يتم التعرّف على اسم معلَمة الإدخال.
validParameterValue: يتم التعرّف على اسم معلمة الإدخال، ولكن قيمته غير صالحة. على سبيل المثال، 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." } }

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."
    }
}