Info

API-интерфейс /osc/info возвращает базовую информацию о камере и поддерживаемых ею функциях.

Ввод

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

Вывод

Имя Тип Описание
manufacturer Строка Производитель камеры.
model Строка Модель камеры.
serialNumber Строка Серийный номер.
firmwareVersion Строка Версия микропрограммного обеспечения.
supportUrl Строка URL-адрес веб-страницы поддержки камеры.
gps Логическое значение True, если камера поддерживает GPS.
gyro Логическое значение True, если камера оснащена гироскопом.
uptime Целое число Количество секунд после загрузки камеры.
api Массив строк Список поддерживаемых API.
endpoints Объект Объект JSON, содержащий информацию о конечных точках камеры. См. следующую таблицу.
apiLevel Целочисленный массив Когда это поле отсутствует, по умолчанию равен [1]. Значение [1, 2] означает, что поддерживаются оба уровня API, 1 и 2, а [2] означает, что поддерживается только API 2. Разработчик должен получить эту информацию и использовать в своих целях на основе этого значения. Это поле добавлено в API уровня 2.
_vendorSpecific [type] (дополнительно) Дополнительная информация от поставщика камеры. Ключи поставщика должны начинаться с нижнего подчеркивания ( _ ) во избежание конфликта имен.

Объект endpoints

Данный объект JSON предоставляет информацию о портах, которые камера использует для конечных точек.

Имя Тип Описание
httpPort Целое число Порт для сервера HTTP. (По умолчанию 80)
httpUpdatesPort Целое число Порт для получения обновления по HTTP
httpsPort Целое число (Дополнительно) Порт для сервера HTTP. (По умолчанию 443)
httpsUpdatesPort Целое число (Дополнительно) Порт для получения обновлений по HTTPS.

Ошибка

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

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

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ],
        "apiLevel": [1, 2]
}
Ответ (API 1) 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ]
}