州

/osc/state API はカメラの state 属性を返します。違い info API の違いは、state に可変値が含まれていることです。 カメラのステータス（batteryLevel など）を表すのに対し、info は カメラの静的属性（manufacturer や firmwareVersion) など、頻繁に変更されない属性。

入力

  • このコマンドは入力を受け取りません。

出力

名前 型 説明
fingerprint 文字列 現在のカメラの状態のフィンガープリント（一意の識別子）。
state オブジェクト さまざまなカメラ状態のステータスを含む JSON オブジェクト。次の表をご覧ください。

state オブジェクト

この JSON オブジェクトは、さまざまなカメラの状態のステータスを提供します。メーカーは 新しいカスタム状態を提供します。先頭にアンダースコア（_）を付ける必要があります 名前空間の競合を防止できます。

名前 型 説明
sessionId 文字列 現在のセッションの ID。このフィールドは API レベル 2 で非推奨になりました。
batteryLevel 数値 バッテリー残量の浮動小数点値として表される。例:0.5
storageChanged ブール値 新しいタイプのストレージ（SD カード、USB ドライブなど）が挿入または取り外された場合は true。 このフィールドは API レベル 2 で非推奨になりました。
storageUri 文字列 さまざまなストレージを区別するための一意の識別子。ストレージが変更されたかどうかの判断に使用されます。 このフィールドは API レベル 2 で追加されました。
_vendorSpecific [type](省略可) カメラに関するベンダー固有の追加状態。名前空間の競合を防ぐために、先頭にアンダースコア（_）を付けます。

エラー

  • このコマンドはエラーを返しません。

例
リクエスト 
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
    }
}