राज्य

/osc/state एपीआई, कैमरे के state एट्रिब्यूट दिखाता है. इसके और info एपीआई में यह फ़र्क़ है कि state में बदली जा सकने वाली वैल्यू होती हैं. उदाहरण के लिए, कैमरे की स्थिति के बारे में बताने वाली (उदाहरण के लिए, batteryLevel), जबकि info में कैमरे के सिर्फ़ स्टैटिक एट्रिब्यूट (उदाहरण के लिए, manufacturer या ऐसे एट्रिब्यूट जो अक्सर बदलते नहीं हैं) होते हैं, जैसे कि firmwareVersion).

इनपुट

  • इस निर्देश के लिए कोई इनपुट नहीं चाहिए.

आउटपुट

नाम स्ट्रीम किस तरह की है Description
fingerprint String कैमरे की मौजूदा स्थिति का फ़िंगरप्रिंट (यूनीक आइडेंटिफ़ायर).
state ऑब्जेक्ट एक JSON ऑब्जेक्ट, जिसमें कैमरे की अलग-अलग स्थितियों की जानकारी होती है. अगली टेबल देखें.

state ऑब्जेक्ट

यह JSON ऑब्जेक्ट, कैमरे की अलग-अलग स्थितियों की स्थिति के बारे में बताता है. मैन्युफ़ैक्चरर, नए और कस्टम स्टेटस उपलब्ध करा सकते हैं. इन स्टेटस के आगे अंडरस्कोर ( _ ) लगा होना चाहिए, ताकि नेमस्पेस के बीच होने वाले टकराव को रोका जा सके.

नाम स्ट्रीम किस तरह की है Description
sessionId String मौजूदा सेशन का आईडी. यह फ़ील्ड, एपीआई लेवल 2 में बंद कर दिया गया था.
batteryLevel नंबर इसे बची हुई बैटरी के फ़्लोटिंग पॉइंट वैल्यू के तौर पर दिखाया जाता है, जैसे कि 0.5
storageChanged बूलियन अगर नए तरह का स्टोरेज (जैसे, एसडी कार्ड या यूएसबी ड्राइव) डाला या हटाया जाता है, तो वैल्यू 'सही' होगी. यह फ़ील्ड, एपीआई लेवल 2 में बंद कर दिया गया था.
storageUri String अलग-अलग स्टोरेज में अंतर करने के लिए, यूनीक आइडेंटिफ़ायर. इसका इस्तेमाल यह बताने के लिए किया जाता है कि स्टोरेज में बदलाव हुआ है या नहीं. इस फ़ील्ड को एपीआई लेवल 2 में जोड़ा गया था.
_vendorSpecific [टाइप](ज़रूरी नहीं) वेंडर से जुड़ी कैमरे के बारे में अतिरिक्त जानकारी. नेमस्पेस के टकराव से बचने के लिए, अंडरस्कोर ( _ ) का इस्तेमाल करें.

गड़बड़ी

  • यह निर्देश कोई गड़बड़ी नहीं दिखाता है.

उदाहरण
अनुरोध करें 
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
    }
}