מצלמה.getOptions

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

פרמטרים

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

תוצאות

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

שגיאות

  • missingParameter: פרמטר נדרש אחד או יותר חסר. לדוגמה, optionNames לא צוין.
  • legalParameterName: לפחות שם אחד של פרמטר קלט או שם של אפשרות לא מזוהים או לא נתמכים, למשל, צריך להחזיר את הקוד הזה אם נעשה שימוש באפשרות (למשל captureInterval) מרמת API 2 כאשר clientVersion ב-Options הוא 1.
  • לא חוקיParameterValue: השמות של הפרמטרים שהוזנו מזוהים, אבל אחד או יותר מהערכים אינם חוקיים; לדוגמה, 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."
   }
}