aparat.setOptions

Ustawia wartości dla określonych właściwości; np. GPS wł./wył., data czas, ISO, balans bieli, szybkość migawki, opóźnienie uśpienia/wyłączenia itd. To polecenie zostało zmienione na poziomie interfejsu API 2.

Parametry

  • sessionId: unikalny identyfikator sesji typu ciąg znaków, uzyskany za pomocą polecenia camera.startSession. To pole zostało wycofane na poziomie interfejsu API 2.
  • options: pary JSON typu <key, value> właściwości do ustawienia. wartości mogą być dowolnymi z tych typów: String, String Array, Number, Number Array, Boolean, Object, Object Array. Zobacz Opcje.

Wyniki

  • To polecenie nie zwraca żadnych wyników.

Błędy

  • missingparameter (brak parametru): brak co najmniej jednego wymaganego parametru; w przypadku na przykład options nie został określony.
  • invalidparameterName:co najmniej 1 opcja lub opcja parametru wejściowego. nazwa jest nierozpoznana lub nieobsługiwana, np. ten kod powinien być zwracany, jeśli gdy używana jest opcja clientVersion (np. captureInterval) z interfejsu API poziomu 2 w Options wynosi 1.
  • invalidParameterValue::co najmniej jeden parametr do wprowadzania danych lub co najmniej 1 nazwa opcji. jest rozpoznawany, ale jego wartość jest nieprawidłowa; np. typ danych jest nieprawidłowy.

Polecenie I/O
Dane wejściowe polecenia (poziom interfejsu API 1) 
{
    "parameters": {
        "sessionId": "12ABC3",
        "options": {
            "isoBalance": 200
        }
    }
}
Dane wyjściowe polecenia (poziom interfejsu API 1) 
none
Dane wyjściowe polecenia (błąd) (poziom interfejsu API 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option isoBalance."
    }
}
Dane wejściowe polecenia (poziom interfejsu API 2) 
{
    "parameters": {
        "options": {
            "iso": 200,
            "captureInterval": 20
        }
    }
}
Dane wyjściowe polecenia (poziom interfejsu API 2) 
none
Dane wyjściowe polecenia (błąd) (poziom interfejsu API 2) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter options contains unsupported option captureInterval."
    }
}