كاميرا.getImage

لعرض صورة كاملة الحجم أو تم تغيير حجمها وفقًا لعنوان URI الخاص بها. تشمل معلَمات الإدخال الحل. هذا هو الأمر الوحيد الذي يجب عرضه، وهو Content-Type: image/jpeg. تعرض جميع الأوامر الأخرى Content-Type: application/json;charset=utf-8. تم إيقاف هذا الأمر نهائيًا في المستوى 2 من واجهة برمجة التطبيقات.

المعلمات

  • fileUri: معرّف الموارد المنتظم (URI) للملف المستهدف. تقرر الشركات المصنِّعة ما إذا كانت ستستخدم معرفات الموارد المنتظمة (URI) المطلقة أو النسبية. وقد يتعامل العملاء مع هذا المعرّف على أنّه معرّف مبهم.
  • maxSize: (اختيارية) أقصى حجم للصورة المطلوبة max(scaledimage_width, scaledimage_height). في حال إسقاط maxSize أو تكبيره عن الصورة بالحجم الكامل، يتم عرض الصورة بالحجم الكامل.

النتائج

  • content: البيانات الثنائية للصور، بما في ذلك البيانات المقابلة (على سبيل المثال، البيانات المعدّلة) البيانات الوصفية في رأس الصورة.

الأخطاء

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

مفتاح Command I/O

إدخال الطلب
{
    "parameters": {
        "fileUri": "file URI",
        "maxSize": 400
    }
}
مخرجات الأوامر
Image binary data
مخرجات الأوامر (خطأ)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter fileUri doesn't exist."
    }
}