camera.setOptions

Legt Werte für bestimmte Eigenschaften fest. z. B. GPS ein/aus, Datum & Zeit, ISO, Weißabgleich, Belichtungszeit, Verzögerung für Ruhemodus/Ausschalten usw. Dieser Befehl wurde in API-Ebene 2 geändert.

Parameter

  • sessionId::Eindeutige Sitzungs-ID des Typs String, abgerufen mit dem Befehl camera.startSession. Dieses Feld wurde in API-Level 2 eingestellt.
  • options: JSON-<key, value>-Paare der festzulegenden Attribute. Die Für den Wert kann es sich um einen der folgenden Typen handeln: String, String Array, Number, Number Array, Boolean, Object und Object Array. Weitere Informationen finden Sie unter Optionen:

Ergebnisse

  • Dieser Befehl gibt kein Ergebnis zurück.

Fehler

  • missingParameter:Mindestens ein erforderlicher Parameter fehlt. für Beispiel: options ist nicht angegeben.
  • invalidParameterName:mindestens eine Option oder Option für den Eingabeparameter 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::Mindestens ein Eingabeparameter oder Optionsname wird erkannt, sein Wert ist jedoch ungültig; wenn ein Datentyp falsch ist.

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