State

/osc/state API menampilkan atribut state kamera. Perbedaan antara ini dan info API adalah state berisi nilai yang dapat diubah yang merepresentasikan status kamera (misalnya, batteryLevel), sedangkan info hanya berisi atribut statis kamera (misalnya, manufacturer atau atribut yang tidak sering berubah seperti firmwareVersion).

Input

  • Perintah ini tidak mengambil input.

Output

Nama Jenis Deskripsi
fingerprint String Sidik jari (ID unik) status kamera saat ini.
state Objek Objek JSON yang berisi status berbagai status kamera. Lihat tabel berikutnya.

Objek state

Objek JSON ini menyediakan berbagai status kamera. Produsen dapat menyediakan status khusus baru, yang harus diawali dengan garis bawah ( _ ) untuk mencegah konflik namespace.

Nama Jenis Deskripsi
sessionId String ID sesi saat ini. Kolom ini tidak digunakan lagi di API level 2.
batteryLevel Angka Dinyatakan sebagai nilai floating point baterai yang tersisa, mis. 0,5
storageChanged Boolean True jika jenis penyimpanan baru (mis., kartu SD atau drive USB) dipasang/dilepas. Kolom ini tidak digunakan lagi di API level 2.
storageUri String ID unik untuk membedakan penyimpanan yang berbeda. Itu digunakan untuk mengetahui apakah storage telah berubah atau tidak. Kolom ini ditambahkan di API level 2.
_vendorSpecific [jenis](opsional) Status tambahan khusus vendor tentang kamera. Awali dengan garis bawah ( _ ) untuk mencegah konflik namespace.

Error

  • Perintah ini tidak menampilkan error.

Contoh
Permintaan 
POST /osc/state HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Respons 
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
    }
}