מצלמה.setOptions

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

פרמטרים

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

תוצאות

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

שגיאות

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

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