camera.getOptions

تنظیمات فعلی را برای خواص درخواستی برمی‌گرداند. این دستور در سطح 2 API اصلاح شد.

پارامترها

  • sessionId: شناسه جلسه منحصر به فرد از نوع رشته که با استفاده از دستور camera.startSession به دست می آید. این فیلد در سطح 2 API منسوخ شده است.
  • optionNames: یک آرایه رشته ای از نام های دارایی برای بازگشت.

نتایج

  • گزینه ها: JSON <key, value> جفت ویژگی های درخواستی. مقدار می تواند یکی از انواع زیر باشد: String ، String Array ، Number ، Number Array ، Boolean ، Object ، Object Array . به گزینه ها مراجعه کنید.

خطاها

  • missingParameter: یک یا چند پارامتر مورد نیاز وجود ندارد. برای مثال، optionNames مشخص نشده است.
  • invalidParameterName: یک یا چند نام پارامتر ورودی یا نام گزینه شناسایی نشده یا پشتیبانی نمی شود، به عنوان مثال اگر گزینه ای (مثلا captureInterval ) از سطح 2 API استفاده می شود زمانی که clientVersion در Options 1 است، این کد باید برگردانده شود.
  • invalidParameterValue: نام پارامترهای ورودی شناسایی می شود، اما یک یا چند مقدار نامعتبر است. برای مثال، sessionId وجود ندارد، غیر فعال است، یا نوع داده آن نادرست است. این کد خطا در سطح 2 API منسوخ شده است زیرا وقتی نام هر گزینه نامعتبر است، invalidParameterName باید برگردانده شود.

دستور I/O

ورودی فرمان (سطح API 1)
{
  "parameters": {
      "sessionId": "12ABC3",
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
خروجی فرمان (سطح API 1)
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
خروجی فرمان (خطا) (سطح API 1)
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}
ورودی فرمان (سطح API 2)
{
  "parameters": {
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
خروجی فرمان (سطح 2 API)
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
خروجی فرمان (خطا) (سطح API 2)
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}