/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" ] } |