لعرض صورة بالحجم الكامل أو تم تغيير حجمها وفقًا لعنوان URI الخاص بها. تتضمن معلمات الإدخال درجة الدقة. هذا هو الأمر الوحيد الذي يجب عرضه، وهو Content-Type: image/jpeg.
وتعرض جميع الأوامر الأخرى Content-Type: application/json;charset=utf-8.
تم إيقاف هذا الأمر نهائيًا في المستوى 2 من واجهة برمجة التطبيقات.
المَعلمات
- fileUri: معرّف الموارد المنتظم للملف الهدف. تقرر الشركات المصنّعة ما إذا كان ينبغي استخدام معرفات الموارد المنتظمة (URI) المطلقة أو النسبية. قد يتعامل العملاء مع هذا المعرّف كمعرّف مبهم.
- maxSize: (اختيارية) الحد الأقصى لحجم الصورة المطلوبة،
max(scaledimage_width, scaledimage_height). إذا تم إسقاط
maxSizeأو كان أكبر من الصورة ذات الحجم الكامل، يتم عرض الصورة بالحجم الكامل.
النتائج
- content: البيانات الثنائية للصور، بما في ذلك البيانات الوصفية المقابلة (على سبيل المثال، البيانات المُعدَّلة) في عنوان الصورة.
الأخطاء
- missingParameter: لم يتم تحديد
fileUriالمطلوب. - invalidParameterName: لم يتم التعرّف على اسم مَعلمة إدخال.
- INVALIDParameterValue: يتم التعرّف على اسم معلَمة الإدخال، إلا أنّ قيمته غير صالحة. على سبيل المثال، القيمة
fileUriغير موجودة أو نوع بياناتها غير صحيح أوmaxSizeنوع بيانات غير صحيح.
Command I/O (إدخال وإخراج) | |
|---|---|
| إدخال الأوامر | {
"parameters": {
"fileUri": "file URI",
"maxSize": 400
}
} |
| مخرجات الأوامر | Image binary data |
| مخرجات الأمر (خطأ) | {
"error": {
"code": "invalidParameterValue",
"message": "Parameter fileUri doesn't exist."
}
} |