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