Eyalet

/osc/state API, kameranın state özelliklerini döndürür. Fark ile info API arasındaki state değişken değerler içerir kamera durumunu (ör. batteryLevel) temsil ederken info kameranın yalnızca statik özelliklerini içerir (örneğin, manufacturer veya sık değişmeyen firmwareVersion) gibi özellikler içerir.

Giriş

  • Bu komut herhangi bir giriş almaz.

Çıkış

Ad Tür Açıklama
fingerprint Dize Geçerli kamera durumunun parmak izi (benzersiz tanımlayıcı).
state Nesne Çeşitli kamera durumlarının durumunu içeren bir JSON nesnesi. Sonraki tabloyu inceleyin.

state nesne

Bu JSON nesnesi, çeşitli kamera durumlarının durumunu sağlar. Üreticiler Önünde bir alt çizgi ( _ ) bulunması gereken yeni, özel durumlar sağlayın çakışmalarını önlemeye yardımcı olur.

Ad Tür Açıklama
sessionId Dize Geçerli oturumun kimliği. Bu alan, API düzeyi 2'de kullanımdan kaldırılmıştır.
batteryLevel Sayı Kalan pilin kayan noktalı değeri olarak ifade edilir, ör. 0,5
storageChanged Boole Yeni bir depolama türü (ör. SD kart veya USB sürücü) eklenirse/çıkarılırsa doğru değerini döndürür. Bu alan, API düzeyi 2'de kullanımdan kaldırılmıştır.
storageUri Dize Farklı depolama alanlarını ayırt etmeye yarayan benzersiz bir tanımlayıcı. Depolama alanının değişip değişmediğini anlamak için kullanılır. Bu alan, API düzeyi 2'de eklendi.
_vendorSpecific [type](isteğe bağlı) Kamerayla ilgili tedarikçi firmaya özgü ek durum. Ad alanı çakışmalarını önlemek için önek olarak alt çizgi ( _ ) ekleyin.

Hata

  • Bu komut hata döndürmez.

Örnek
İstek 
POST /osc/state HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
Yanıt 
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
    }
}