Информация

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

Вход

  • Эта команда не требует ввода.

Выход

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

объект endpoints

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

Примечание. Конечные точки HTTPS являются необязательными.

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

Ошибка

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

Пример

Запрос 
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"
        ]
}