ऐसा सेशन शुरू करता है जो तय इंटरवल के बाद खत्म हो जाता है. कैमरे को साथ ही, यह पक्का करती है कि कैमरा चालू रहे. कृपया ध्यान दें, शुरू होने पर नए सत्र की हमेशा अनुमति दी जानी चाहिए. अगर कोई मौजूदा सेशन है, तो नया सेशन शुरू करने से पहले, कैमरे से अपने-आप बंद हो जाना चाहिए. इस निर्देश को एपीआई लेवल 2 में बंद कर दिया गया था.
पैरामीटर
- समय खत्म: (ज़रूरी नहीं) अनुरोध किए गए सेशन का टाइम आउट सेकंड में. अगर इसे हटाया जाता है (एचटीटीपी अनुरोध के लिए कोई मुख्य हिस्सा नहीं है), तो कैमरे को टाइम आउट हो गया.
नतीजे
- sessionId: टाइप स्ट्रिंग का यूनीक सेशन आइडेंटिफ़ायर.
- समय खत्म: सेशन के टाइम आउट की पुष्टि सेकंड में हो जाती है.
गड़बड़ियां
- अमान्य पैरामीटर का नाम: इनपुट पैरामीटर के नाम की पहचान नहीं की जा सकी.
- invalidParameterValue: इनपुट पैरामीटर का नाम पहचाना जा चुका है, लेकिन पास की गई वैल्यू अमान्य है; उदाहरण के लिए, मान सीमा से बाहर है या उसका डेटा प्रकार गलत है.
कमांड 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." } } |