Возвращает текущие настройки для запрошенных свойств. Эта команда была изменена на уровне 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."
}
} |