camera.getOptions

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

Parameter

  • sessionId: Eindeutige Sitzungs-ID vom Typ String, die mit dem Befehl camera.startSession abgerufen wurde. Dieses Feld wurde in API-Level 2 eingestellt.
  • optionNames:Ein String-Array der zurückzugebenden Attributnamen

Ergebnisse

  • options: JSON-<key, value>-Paare der angeforderten Attribute. Der Wert kann einen der folgenden Typen haben: String, String Array, Number, Number Array, Boolean, Object, Object Array. Siehe Optionen.

Fehler

  • missingParameter: Mindestens ein erforderlicher Parameter fehlt, z. B. ist optionNames nicht angegeben.
  • invalidParameterName:Mindestens ein Eingabeparametername oder Optionsname wird nicht erkannt oder nicht unterstützt. Dieser Code sollte beispielsweise zurückgegeben werden, wenn eine Option (z. B. captureInterval) aus API-Ebene 2 verwendet wird, wenn clientVersion in Options den Wert 1 hat.
  • invalidParameterValue: Die Namen von Eingabeparametern werden erkannt, aber mindestens einer der Werte ist ungültig. Beispiel: sessionId existiert nicht, ist inaktiv oder der Datentyp ist falsch. Dieser Fehlercode wurde in API-Level 2 eingestellt, da invalidParameterName zurückgegeben werden sollte, wenn ein Optionsname ungültig ist.

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