State

API /osc/state mengembalikan atribut state kamera. Perbedaan antara API ini dengan info adalah state berisi nilai mutable yang menyatakan status kamera (batteryLevel, misalnya), sedangkan info hanya berisi atribut statis kamera (misalnya, manufacturer atau atribut yang jarang berubah seperti firmwareVersion).

Input

  • Perintah ini tidak menerima input.

Output

Nama Tipe Keterangan
fingerprint String Sidik jari (identifier unik) status kamera saat ini.
state Objek Objek JSON yang berisi berbagai status kamera. Lihat tabel berikutnya.

Objek state

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

Nama Tipe Keterangan
sessionId String ID sesi saat ini. Bidang ini tidak digunakan lagi dalam API level 2.
batteryLevel Angka Dinyatakan berupa nilai titik-mengambang sisa baterai, mis. 0,5
storageChanged Boolean True jika tipe storage yang baru (mis. kartu SD atau USB drive) dipasang/dicopot. Bidang ini tidak digunakan lagi dalam API level 2.
storageUri String Sebuah identifier unik untuk membedakan storage yang berbeda. Itu digunakan untuk mengetahui apakah storage telah berubah atau tidak. Bidang ini telah ditambahkan dalam API level 2.
_vendorSpecific [type](optional) Status tambahan vendor-spesifik tentang kamera. Awali dengan setrip bawah ( _ ) untuk mencegah konflik namespace.

Kesalahan

  • Perintah ini tidak mengembalikan kesalahan.

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