camera.setOptions

Legt Werte für bestimmte Eigenschaften fest, z. B. GPS ein/aus, Datum und Uhrzeit, ISO, Weißabgleich, Belichtungszeit, Ruhezustand/Abschaltverzögerung usw. 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.
  • options: JSON-<key, value>-Paare der festzulegenden Attribute. Der Wert kann einen der folgenden Typen haben: String, String Array, Number, Number Array, Boolean, Object, Object Array. Weitere Informationen finden Sie unter Optionen.

Ergebnisse

  • Dieser Befehl gibt kein Ergebnis zurück.

Fehler

  • missingParameter:Mindestens ein erforderlicher Parameter fehlt. Beispielsweise ist options nicht angegeben.
  • invalidParameterName:Mindestens eine Eingabeparameter-Option oder ein Optionsname wurde nicht erkannt oder wird nicht unterstützt. Dieser Code sollte beispielsweise zurückgegeben werden, wenn eine Option (z. B. captureInterval) aus API-Level 2 verwendet wird, wenn clientVersion in Options den Wert 1 hat.
  • invalidParameterValue:Mindestens ein Eingabeparameter oder Optionsname wird erkannt, aber sein Wert ist ungültig. Es kann beispielsweise sein, dass ein Datentyp falsch ist.

Befehls-E/A
Befehlseingabe (API-Level 1) 
{
    "parameters": {
        "sessionId": "12ABC3",
        "options": {
            "isoBalance": 200
        }
    }
}
Befehlsausgabe (API-Level 1) 
none
Befehlsausgabe (Fehler) (API-Ebene 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option isoBalance."
    }
}
Befehlseingabe (API-Level 2) 
{
    "parameters": {
        "options": {
            "iso": 200,
            "captureInterval": 20
        }
    }
}
Befehlsausgabe (API-Level 2) 
none
Befehlsausgabe (Fehler) (API-Ebene 2) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option captureInterval."
    }
}