状态

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

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