מצלמה.getOptions

מחזירה את ההגדרות הנוכחיות של הנכסים המבוקשים. הפקודה הזו שונתה ברמת API 2.

פרמטרים

  • sessionId: מזהה הסשן הייחודי של מחרוזת הסוג שהושגה באמצעות הפקודה camera.startSession. השדה הזה הוצא משימוש ברמת API 2.
  • optionNames: מערך מחרוזות של שמות המאפיינים שרוצים להחזיר.

תוצאות

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

שגיאות

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

Command 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"
      ]
  }
}
פלט הפקודה (API ברמה 2) 
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
פלט הפקודה (שגיאה) (רמת API 2) 
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}