Eyalet

/osc/state API, kameranın state özelliklerini döndürür. Bu API ile info API arasındaki fark, state öğesinin kamera durumunu temsil eden değişken değerler (ör. batteryLevel) içermesi, info değerinin ise yalnızca kameranın statik özelliklerini (ör. manufacturer veya firmwareVersion) gibi sık değişmeyen özellikleri) içermesidir.

Giriş

  • Bu komuta herhangi bir giriş yapılmaz.

Çı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 tabloya bakın.

state nesne

Bu JSON nesnesi, çeşitli kamera durumlarının durumunu gösterir. Üreticiler, ad alanı çakışmalarını önlemek için ön ekine alt çizgi ( _ ) eklenmesi gereken yeni özel durumlar sağlayabilir.

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 nokta değeri olarak ifade edilir, ör. 0,5
storageChanged Boole Yeni bir depolama türü (ör. SD kart veya USB sürücüsü) eklenir/çıkarılırsa doğru değerini alır. Bu alan, API düzeyi 2'de kullanımdan kaldırılmıştır.
storageUri Dize Farklı depolama alanlarını ayırt etmek için kullanılan 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 eklenmiştir.
_vendorSpecific [tür](isteğe bağlı) Kamera hakkında tedarikçiye özel ek durum. Ad alanı çakışmalarını önlemek için ön eke 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
    }
}