Возвращает текущие настройки для запрошенных свойств. Эта команда была изменена на уровне API 2.
Параметры
- sessionId: уникальный идентификатор сеанса строкового типа, полученный с помощью команды
camera.startSession
. Это поле устарело на уровне API 2. - optionNames: строковый массив имен свойств, которые нужно вернуть.
Результаты
- параметры: пары JSON
<key, value>
запрошенных свойств. Значение может быть любого из следующих типов:String
,String Array
,Number
,Number Array
,Boolean
,Object
,Object Array
. См. Опции .
Ошибки
- MissingParameter: отсутствует один или несколько обязательных параметров; например,
optionNames
не указан. - validParameterName: одно или несколько имен входных параметров или имен опций не распознаны или не поддерживаются, например, этот код должен быть возвращен, если опция (например,
captureInterval
) из уровня API 2 используется, когдаclientVersion
вOptions
равен 1. - validParameterValue: имена входных параметров распознаются, но одно или несколько значений недопустимы; например,
sessionId
не существует, неактивен или его тип данных неверен. Этот код ошибки устарел на уровне API 2, поскольку, если какое-либо имя параметра недопустимо, должно быть возвращеноinvalidParameterName
.
Командный ввод/вывод | |
---|---|
Ввод команды (уровень API 1) | { "parameters": { "sessionId": "12ABC3", "optionNames": [ "iso", "isoSupport" ] } } | Вывод команды (уровень API 1) | { "results": { "options": { "iso": 200, "isoSupport": [100, 200, 400, 800, 1600] } } } |
Вывод команды (ошибка) (уровень API 1) | { "error": { "code": "invalidParameterName", "message": "Parameter optionNames contains unrecognized option XYZ." } } |
Ввод команды (уровень API 2) | { "parameters": { "optionNames": [ "iso", "isoSupport" ] } } | Вывод команды (уровень API 2) | { "results": { "options": { "iso": 200, "isoSupport": [100, 200, 400, 800, 1600] } } } |
Вывод команды (ошибка) (уровень API 2) | { "error": { "code": "invalidParameterName", "message": "Parameter optionNames contains unrecognized option XYZ." } } |