状态

/osc/state API 返回相机的 state 属性。 其与 info API 之间的区别在于 state 包含表示相机状态的可变值（例如，batteryLevel），而 info 仅包含相机的静态属性（例如，manufacturer 或不经常变化的属性，如 firmwareVersion)）。

输入

  • 此命令不需要进行输入。

输出

名称 类型 说明
fingerprint 字符串 当前相机状态的指纹（唯一标识符）。
state 对象 一个 JSON 对象，包含各种相机状态。 参见下一个表。

state 对象

此 JSON 对象提供各种相机状态。 制造商可以提供新的自定义状态，且应该用下划线 ( _ ) 作为前缀以防止命名空间冲突。

名称 类型 说明
sessionId String 当前会话的 ID。 此字段在 API 级别 2 中已弃用。
batteryLevel 数字 以剩余电量的浮点值表示，例如， 0.5
storageChanged 布尔型 如果插入/移除新的存储类型（例如， SD 卡或 USB 驱动器），则为 True。 此字段在 API 级别 2 中已弃用。
storageUri String 用于区分不同存储的唯一标识符。 用于说明存储是否发生更改。 此字段已添加到 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
    }
}