अनुरोध की गई प्रॉपर्टी के लिए मौजूदा सेटिंग दिखाता है. इस निर्देश में, एपीआई लेवल 2 में बदलाव किया गया था.
पैरामीटर
- sessionId: मिली स्ट्रिंग का यूनीक सेशन आइडेंटिफ़ायर
ऐसा करने के लिए,
camera.startSession
निर्देश का इस्तेमाल करें. इस फ़ील्ड को एपीआई लेवल 2 में बंद कर दिया गया था. - optionNames: प्रॉपर्टी के नामों की एक स्ट्रिंग स्ट्रिंग.
नतीजे
- विकल्प: अनुरोध की गई प्रॉपर्टी के JSON
<key, value>
पेयर. वैल्यू इनमें से किसी भी तरह की हो सकती है:String
,String Array
,Number
,Number Array
,Boolean
,Object
,Object Array
. यहां जाएं: विकल्प.
गड़बड़ियां
- वैल्यू मौजूद नहीं है: एक या उससे ज़्यादा ज़रूरी पैरामीटर मौजूद नहीं हैं;
उदाहरण के लिए,
optionNames
बताया नहीं गया है. - अमान्य पैरामीटर का नाम: एक या उससे ज़्यादा इनपुट पैरामीटर का नाम या विकल्प
नाम पहचाना नहीं जा सका या इस्तेमाल नहीं किया जा सकता, उदाहरण के लिए यह कोड वापस आना चाहिए अगर
एपीआई लेवल 2 से मिले विकल्प (जैसे कि
captureInterval
) का इस्तेमाल तब किया जाता है, जबclientVersion
Options
में 1 है. - invalidParameterValue: इनपुट पैरामीटर के नाम पहचाने जाते हैं, लेकिन
एक या उससे ज़्यादा वैल्यू अमान्य हैं; उदाहरण के लिए,
sessionId
मौजूद नहीं है, बंद है या इसका डेटा टाइप गलत है. इस गड़बड़ी कोड को इतनी देर में काम करना बंद कर दिया गया एपीआई लेवल 2, जब किसी विकल्प का नाम अमान्य होता है,invalidParameterName
लौटाया जाना चाहिए.
कमांड I/O | |
---|---|
Command इनपुट (एपीआई लेवल 1) | { "parameters": { "sessionId": "12ABC3", "optionNames": [ "iso", "isoSupport" ] } } |
कमांड आउटपुट (एपीआई लेवल 1) | { "results": { "options": { "iso": 200, "isoSupport": [100, 200, 400, 800, 1600] } } } |
कमांड आउटपुट (गड़बड़ी) (एपीआई लेवल 1) | { "error": { "code": "invalidParameterName", "message": "Parameter optionNames contains unrecognized option XYZ." } } |
Command इनपुट (एपीआई लेवल 2) | { "parameters": { "optionNames": [ "iso", "isoSupport" ] } } |
कमांड आउटपुट (एपीआई लेवल 2) | { "results": { "options": { "iso": 200, "isoSupport": [100, 200, 400, 800, 1600] } } } |
कमांड आउटपुट (गड़बड़ी) (एपीआई लेवल 2) | { "error": { "code": "invalidParameterName", "message": "Parameter optionNames contains unrecognized option XYZ." } } |