מחזירה את ההגדרות הנוכחיות של המאפיינים המבוקשים. הפקודה הזו שונתה ב-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." } } |