Camera.getOptions

अनुरोध की गई प्रॉपर्टी के लिए मौजूदा सेटिंग दिखाता है. इस निर्देश को एपीआई लेवल 2 में बदला गया था.

पैरामीटर

  • sessionId: camera.startSession कमांड का इस्तेमाल करके मिला टाइप स्ट्रिंग का यूनीक सेशन आइडेंटिफ़ायर. यह फ़ील्ड, एपीआई लेवल 2 में बंद कर दिया गया था.
  • optionNames: रिटर्न के लिए प्रॉपर्टी के नामों की स्ट्रिंग.

नतीजे

  • options: अनुरोध की गई प्रॉपर्टी के JSON <key, value> पेयर. वैल्यू इनमें से कोई भी हो सकती है: String, String Array, Number, Number Array, Boolean, Object, Object Array. विकल्प देखें.

गड़बड़ियां

  • गुम पैरामीटर: एक या उससे ज़्यादा ज़रूरी पैरामीटर मौजूद नहीं हैं; उदाहरण के लिए, optionNames के बारे में नहीं बताया गया है.
  • अमान्य parameterName: एक या उससे ज़्यादा इनपुट पैरामीटर के नाम या विकल्प का नाम, पहचाना नहीं जा सकता या इस्तेमाल नहीं किया जा सकता. उदाहरण के लिए, अगर Options में clientVersion के 1 होने पर, एपीआई लेवल 2 में मौजूद किसी विकल्प (जैसे कि captureInterval) का इस्तेमाल किया जाता है, तो यह कोड दिखाया जाना चाहिए.
  • अमान्य पैरामीटर वैल्यू: इनपुट पैरामीटर के नामों की पहचान की गई है, लेकिन एक या इससे ज़्यादा वैल्यू अमान्य हैं. उदाहरण के लिए, sessionId मौजूद नहीं है, बंद है या उसका डेटा टाइप गलत है. एपीआई लेवल 2 में इस गड़बड़ी कोड के इस्तेमाल पर रोक लगा दी गई थी, क्योंकि किसी भी विकल्प का नाम अमान्य होने पर, invalidParameterName दिखाया जाना चाहिए.

निर्देश I/O
कमांड इनपुट (एपीआई लेवल 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."
   }
}
कमांड इनपुट (एपीआई लेवल 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."
   }
}