تضبط قيمًا للسمات المحدّدة. على سبيل المثال، نظام تشغيل/إيقاف GPS، والتاريخ الوقت ISO وتوازن اللون الأبيض وسرعة الغالق وتأخير وضع السكون/إيقاف التشغيل وما إلى ذلك. تم تعديل هذا الأمر في المستوى 2 من واجهة برمجة التطبيقات.
المعلمات
- sessionId: معرّف فريد للجلسة من نوع السلسلة، تم الحصول عليه
باستخدام الأمر
camera.startSession
. تم إيقاف هذا الحقل في المستوى 2 من واجهة برمجة التطبيقات. - options: أزواج JSON
<key, value>
من السمات المطلوب ضبطها. تشير رسالة الأشكال البيانية واحدة من الأنواع التالية:String
أوString Array
أوNumber
أوNumber Array
،Boolean
،Object
،Object Array
. عرض الخيارات:
النتائج
- لا يؤدي هذا الأمر إلى عرض أي نتيجة.
الأخطاء
- مَعلمة مفقودة: يجب توفُّر مَعلمة واحدة أو أكثر من المَعلمات المطلوبة. حيث
مثال، لم يتم تحديد
options
. - spamparamName: خيارًا واحدًا أو أكثر لمَعلمة إدخال أو أكثر
الاسم غير معروف أو غير متوافق، على سبيل المثال يجب أن يُرجع هذا الرمز إذا
الخيار (مثل
captureInterval
) من المستوى 2 لواجهة برمجة التطبيقات عند استخدامclientVersion
فيOptions
يساوي 1. - invalidParameterValue: معلَمة إدخال أو اسم خيار واحدة أو أكثر يتم التعرف عليها، ولكن قيمتها غير صالحة؛ على سبيل المثال، نوع البيانات غير صحيح.
مفتاح Command I/O | |
---|---|
إدخال الأوامر (مستوى واجهة برمجة التطبيقات 1) | { "parameters": { "sessionId": "12ABC3", "options": { "isoBalance": 200 } } } |
مخرجات الأوامر (مستوى واجهة برمجة التطبيقات 1) | none |
مخرجات الأمر (خطأ) (مستوى واجهة برمجة التطبيقات 1) | { "error": { "code": "invalidParameterName", "message": "Parameter options contains unsupported option isoBalance." } } |
إدخال الأوامر (مستوى واجهة برمجة التطبيقات 2) | { "parameters": { "options": { "iso": 200, "captureInterval": 20 } } } |
مخرجات الأوامر (مستوى واجهة برمجة التطبيقات 2) | none |
مخرجات الأمر (خطأ) (مستوى واجهة برمجة التطبيقات 2) | { "error": { "code": "invalidParameterName", "message": "Parameter options contains unsupported option captureInterval." } } |