ऐसा सेशन शुरू करता है जिसका समय तय इंटरवल के बाद खत्म हो जाता है. यह कैमरे को, अनुरोध करने वाले क्लाइंट के लिए लॉक कर देता है. साथ ही, यह पक्का करता है कि कैमरा चालू रहे. कृपया ध्यान दें, नया सेशन शुरू करने की हमेशा अनुमति होनी चाहिए. अगर कोई सेशन पहले से मौजूद है, तो नया सेशन शुरू करने से पहले कैमरे को उसे अपने-आप बंद कर देना चाहिए. यह निर्देश, एपीआई लेवल 2 में बंद कर दिया गया था.
पैरामीटर
- समय खत्म: (ज़रूरी नहीं) अनुरोध किए गए सेशन का टाइम आउट सेकंड में. अगर छोड़ दिया जाता है (एचटीटीपी अनुरोध का कोई मुख्य हिस्सा नहीं होता), तो कैमरे को उचित समय तय करना चाहिए.
नतीजे
- sessionId: स्ट्रिंग के टाइप का यूनीक सेशन आइडेंटिफ़ायर.
- timeout: सेशन के टाइम आउट की पुष्टि सेकंड में.
गड़बड़ियां
- अमान्य parameterName: इनपुट पैरामीटर का नाम, पहचाना नहीं जा सका.
- अमान्य parameterValue: इनपुट पैरामीटर का नाम माना जाता है, लेकिन पास की गई वैल्यू अमान्य है. उदाहरण के लिए, वैल्यू रेंज से बाहर है या इसका डेटा टाइप गलत है.
निर्देश I/O | |
---|---|
कमांड इनपुट | { "parameters": { "timeout": 50 } } |
कमांड आउटपुट | { "results": { "sessionId": "12ABC3", "timeout": 50 } } |
कमांड आउटपुट (गड़बड़ी) | { "error": { "code": "cameraInExclusiveUse", "message": "Camera already in exclusive use, new session can't be started." } } |