camera.getOptions

Gibt die aktuellen Einstellungen für die angeforderten Properties zurück. Dieser Befehl wurde in API-Ebene 2 geändert.

Parameter

  • sessionId::Eindeutige Sitzungs-ID des abgerufenen Strings mit dem Befehl camera.startSession. Dieses Feld wurde in API-Level 2 eingestellt.
  • optionNames:Ein String-Array mit Attributnamen, die zurückgegeben werden sollen.

Ergebnisse

  • options: JSON-<key, value>-Paare der angeforderten Attribute. Folgende Werte sind möglich: String, String Array, Number, Number Array, Boolean, Object und Object Array. Weitere Informationen finden Sie unter Optionen:

Fehler

  • missingParameter:Mindestens ein erforderlicher Parameter fehlt. Beispiel: optionNames ist nicht angegeben.
  • invalidParameterName:Name oder Option eines oder mehrerer Eingabeparameters wird nicht erkannt oder wird nicht unterstützt, z.B. sollte dieser Code zurückgegeben werden, wenn ein Die Option (z.B. captureInterval) von API-Ebene 2 wird verwendet, wenn clientVersion in Options ist 1.
  • invalidParameterValue::Namen von Eingabeparametern werden zwar erkannt, aber Mindestens ein Wert ist ungültig. z. B.: sessionId existiert nicht, ist inaktiv oder der zugehörige Datentyp ist falsch. Dieser Fehlercode wurde in API-Ebene 2: invalidParameterName, wenn ein Optionsname ungültig ist zurückgegeben werden soll.

Befehls-E/A
Befehlseingabe (API-Ebene 1) 
{
  "parameters": {
      "sessionId": "12ABC3",
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
Befehlsausgabe (API-Ebene 1) 
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
Befehlsausgabe (Fehler) (API-Ebene 1) 
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}
Befehlseingabe (API-Ebene 2) 
{
  "parameters": {
      "optionNames": [
          "iso",
          "isoSupport"
      ]
  }
}
Befehlsausgabe (API-Ebene 2) 
{
  "results": {
      "options": {
           "iso": 200,
           "isoSupport": [100, 200, 400, 800, 1600]
      }
  }
}
Befehlsausgabe (Fehler) (API-Level 2) 
{
  "error": {
      "code": "invalidParameterName",
      "message": "Parameter optionNames contains unrecognized option XYZ."
   }
}