camera.getOptions

تعرض الإعدادات الحالية للمواقع المطلوبة. تم تعديل هذا الأمر في المستوى 2 من واجهة برمجة التطبيقات.

المعلمات

  • sessionId: معرّف الجلسة الفريد لنوع السلسلة التي تم الحصول عليها باستخدام الأمر camera.startSession. تم إيقاف هذا الحقل في المستوى 2 من واجهة برمجة التطبيقات.
  • optionNames: مصفوفة سلسلة لأسماء السمات المطلوب عرضها.

النتائج

  • options: أزواج JSON <key, value> من السمات المطلوبة. يمكن أن تكون القيمة أيًا من الأنواع التالية: String أو String Array أو Number أو Number Array، Boolean، Object، Object Array. عرض الخيارات.

الأخطاء

  • مَعلمة مفقودة: يجب توفُّر مَعلمة واحدة أو أكثر من المَعلمات المطلوبة. على سبيل المثال، لم يتم تحديد optionNames.
  • spamPARAMName: اسم أو خيار واحد أو أكثر لمَعلمة الإدخال الاسم غير معروف أو غير متوافق، على سبيل المثال يجب أن يُرجع هذا الرمز إذا الخيار (مثل captureInterval) من المستوى 2 لواجهة برمجة التطبيقات عند استخدام clientVersion في Options يساوي 1.
  • invalidParameterValue: يتم التعرف على أسماء معلَمات الإدخال، ولكن قيمة واحدة أو أكثر غير صالحة؛ على سبيل المثال، sessionId غير موجودة، أو غير نشطة، أو أن نوع بياناتها غير صحيح. تم إيقاف رمز الخطأ هذا في المستوى 2 من واجهة برمجة التطبيقات بما أنّه عندما يكون أي اسم خيار غير صالح، يتم استخدام invalidParameterName .

مفتاح Command I/O
إدخال الأوامر (مستوى واجهة برمجة التطبيقات 1) 
{
  "parameters": {
      "sessionId": "12ABC3",
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
مخرجات الأوامر (مستوى واجهة برمجة التطبيقات 1) 
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
مخرجات الأمر (خطأ) (مستوى واجهة برمجة التطبيقات 1) 
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}
إدخال الأوامر (مستوى واجهة برمجة التطبيقات 2) 
{
  "parameters": {
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
مخرجات الأوامر (مستوى واجهة برمجة التطبيقات 2) 
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
مخرجات الأمر (خطأ) (مستوى واجهة برمجة التطبيقات 2) 
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}