信息

/osc/info API 会返回有关相机和功能的基本信息 支持的存储类型

输入

  • 此命令不接受输入。

输出

名称 类型 说明
manufacturer 字符串 相机制造商。
model 字符串 相机型号。
serialNumber 字符串 序列号。
firmwareVersion 字符串 当前固件版本。
supportUrl 字符串 摄像头的支持网页的网址。
gps 布尔值 如果相机具有 GPS，则为 True。
gyro 布尔值 如果相机具有陀螺仪，则为 True。
uptime 整数 相机启动后经过的秒数。
api 字符串数组 受支持的 API 列表。
endpoints 对象 包含相机端点相关信息的 JSON 对象。请参阅下表。
apiLevel 整数数组 如果此字段缺失，默认值为 [1]。[1, 2] 表示同时支持 API 1 和 2，而 [2] 表示仅支持 API 2。开发者应负责检索此信息，并根据此信息的值采用不同的实现方式。此字段是 API 级别 2 中的新增字段。如果您支持 API 2.1，也请使用 2。
cameraId 字符串 表示相机的唯一 ID。此字段是在 API 级别 2.1 中添加的，与直接上传相关。
_vendorSpecific type 有关相机的供应商特定额外信息。请在供应商专用密钥前加上下划线 ( _ ) 作为前缀，以避免命名空间冲突。

endpoints 对象

此 JSON 对象提供有关相机端点使用的端口的信息。

注意：HTTPS 端点是可选的。

名称 类型 说明
httpPort 整数 HTTP 服务器的端口。（默认值 80）
httpUpdatesPort 整数 通过 HTTP 接收更新的端口
httpsPort 整数 （可选）HTTPS 服务器的端口。（默认值 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"
        ]
}