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, gdyclientVersion
wOptions
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." } } |