State

API /osc/state возвращает атрибуты state камеры. Разница между ним и API info заключается в том, что state содержит часто изменяемые значения состояния камеры (например, batteryLevel), а info содержит только статические атрибуты камеры (например, manufacturer или атрибуты, которые редко меняются, такие как firmwareVersion).

Ввод

  • Данная команда не поддерживает входных параметров.

Вывод

Имя Тип Описание
fingerprint Строка Контрольная сумма (уникальный идентификатор) текущего состояния камеры.
state Объект Объект JSON, содержащий статус о различных состояниях камеры. См. следующую таблицу.

Объект state

Данный объект JSON предоставляет статус различных состояний камеры. Производители могут предоставлять новые, настраиваемые состояния, которые должны начинаться с символа подчеркивания ( _ ) во избежание конфликта имен.

Имя Тип Описание
sessionId Строка Идентификатор текущего сеанса. В API уровня 2 это поле считается устаревшим.
batteryLevel Номер Показывает оставшийся заряд аккумулятора в виде значения с плавающей точкой, например: 0,5
storageChanged Логическое значение True при подключении нового типа хранилища (например, карта памяти SD или USB-диск). В API уровня 2 это поле считается устаревшим.
storageUri Строка Уникальный идентификатор хранилища. Используется, чтобы показать, изменилось ли хранилище. Это поле добавлено в API уровня 2.
_vendorSpecific [тип](optional) Дополнительное состояние камеры от поставщика. Начинается с нижнего подчеркивания ( _ ) во избежание конфликта имен.

Ошибка

  • Эта команда не возвращает ошибок.

Пример

Запрос
POST /osc/state HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Ответ
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
    "fingerprint": "12EGA33",
    "state": {
        "sessionId": "12ABC3",
        "batteryLevel": 0.5,
        "storageChanged": false
    }
}