מצלמה.setOptions

מגדיר ערכים למאפיינים שצוינו; לדוגמה, הפעלה/כיבוי של GPS, תאריך זמן, ISO, איזון לבן, מהירות התריס, עיכוב בשינה/כיבוי וכו'. הפקודה הזו שונתה ברמת API 2.

פרמטרים

  • sessionId: מזהה סשן ייחודי של מחרוזת סוג, שהושג באמצעות הפקודה camera.startSession. השדה הזה הוצא משימוש ברמת API 2.
  • אפשרויות: זוגות <key, value> של JSON של המאפיינים שרוצים להגדיר. הערך יכול להיות כל אחד מהסוגים הבאים: String, String Array, Number, Number Array, Boolean, Object, Object Array. צפייה אפשרויות.

תוצאות

  • הפקודה הזו לא מחזירה תוצאה.

שגיאות

  • missingParameter: חסר פרמטר נדרש אחד או יותר; עבור לדוגמה, options לא צוין.
  • falseParameterName: אפשרות אחת או יותר של פרמטר קלט הוא לא מזוהה או לא נתמך, למשל: צריך להחזיר את הקוד הזה אם האפשרות (למשל captureInterval) מרמת API 2 נמצאת בשימוש כאשר clientVersion בOptions הוא 1.
  • invalidParameterValue: פרמטר קלט אחד או שם אפשרות אחד או יותר מזוהה, אבל הערך שלו לא חוקי. לדוגמה, סוג הנתונים שגוי.

Command 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
        }
    }
}
פלט הפקודה (API ברמה 2) 
none
פלט הפקודה (שגיאה) (רמת API 2) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option captureInterval."
    }
}