camera.setOptions

تضبط قيمًا للسمات المحدّدة. على سبيل المثال، نظام تشغيل/إيقاف 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."
   
}
}