camera.setOptions

مقادیر را برای خواص مشخص شده تنظیم می کند. به عنوان مثال، GPS روشن/خاموش، تاریخ و زمان، ISO، تعادل رنگ سفید، سرعت شاتر، تاخیر خواب/خاموش کردن، و غیره. این دستور در سطح 2 API اصلاح شد.

پارامترها

  • sessionId: شناسه جلسه منحصر به فرد از نوع رشته که با استفاده از دستور camera.startSession به دست می آید. این فیلد در سطح 2 API منسوخ شده است.
  • گزینه ها: JSON <key, value> جفت خصوصیات برای تنظیم. مقدار می تواند یکی از انواع زیر باشد: String ، String Array ، Number ، Number Array ، Boolean ، Object ، Object Array . به گزینه ها مراجعه کنید.

نتایج

  • این دستور هیچ نتیجه ای را بر نمی گرداند.

خطاها

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

دستور I/O

ورودی فرمان (سطح API 1)
{
    "parameters": {
        "sessionId": "12ABC3",
        "options": {
            "isoBalance": 200
        }
    }
}
خروجی فرمان (سطح API 1)
none
خروجی فرمان (خطا) (سطح API 1)
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option isoBalance."
    }
}
ورودی فرمان (سطح API 2)
{
    "parameters": {
        "options": {
            "iso": 200,
            "captureInterval": 20
        }
    }
}
خروجی فرمان (سطح 2 API)
none
خروجی فرمان (خطا) (سطح API 2)
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option captureInterval."
    }
}