aparat.setOptions

Ustawia wartości określonych właściwości, np. włączanie/wyłączanie GPS, datę i godzinę, ISO, balans bieli, szybkość migawki, opóźnienie uśpienia/wyłączenia itd. To polecenie zostało zmodyfikowane na poziomie API 2.

Parametry

  • sessionId: unikalny identyfikator sesji w postaci ciągu znaków uzyskany za pomocą polecenia camera.startSession. To pole zostało wycofane w interfejsie API poziomu 2.
  • options: pary właściwości JSON <key, value> do ustawienia. Możliwe typy wartości: String, String Array, Number, Number Array, Boolean, Object, Object Array. Zobacz Opcje.

Wyniki

  • To polecenie nie zwraca żadnych wyników.

Błędy

  • missingParameter: brakuje co najmniej jednego wymaganego parametru, np. options.
  • NieprawidłowyParametrName: co najmniej 1 opcja parametru wejściowego lub nazwa opcji jest nierozpoznana lub nieobsługiwana. Np. ten kod powinien zostać zwrócony, jeśli zostanie użyta opcja (np. captureInterval) z poziomu interfejsu API 2, gdy clientVersion w Options ma wartość 1.
  • NieprawidłowaParameterValue: co najmniej 1 parametr wejściowy lub nazwa opcji została rozpoznana, ale jej wartość jest nieprawidłowa, np. nieprawidłowy typ danych.

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