একটি সেশন শুরু করে যা একটি নির্দিষ্ট ব্যবধানের পরে শেষ হয়ে যায়। অনুরোধকারী ক্লায়েন্টের কাছে ক্যামেরা লক করে এবং নিশ্চিত করে যে ক্যামেরাটি জেগে আছে। অনুগ্রহ করে মনে রাখবেন, একটি নতুন অধিবেশন শুরু করার সর্বদা অনুমতি দেওয়া উচিত। যদি একটি বিদ্যমান অধিবেশন থাকে, নতুন অধিবেশন শুরু করার আগে এটি ক্যামেরা দ্বারা স্বয়ংক্রিয়ভাবে বন্ধ করা উচিত। এপিআই লেভেল 2-এ এই কমান্ডটি বাতিল করা হয়েছে।
পরামিতি
- টাইমআউট: (ঐচ্ছিক) সেকেন্ডের মধ্যে অনুরোধ করা সেশনের সময়সীমা। যদি বাদ দেওয়া হয় (HTTP অনুরোধের কোন বডি নেই), ক্যামেরা একটি যুক্তিসঙ্গত সময়সীমা নির্ধারণ করবে।
ফলাফল
- sessionId: টাইপ স্ট্রিং এর অনন্য সেশন শনাক্তকারী।
- সময় শেষ: সেকেন্ডের মধ্যে সেশনের সময়সীমা নিশ্চিত করা হয়েছে।
ত্রুটি
- invalidParameterName: ইনপুট প্যারামিটার নামটি অচেনা।
- 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."
}
} |