جلسه ای را شروع می کند که پس از یک فاصله زمانی ثابت به پایان می رسد. دوربین را روی مشتری درخواست کننده قفل می کند و مطمئن می شود دوربین بیدار می ماند. لطفاً توجه داشته باشید، شروع یک جلسه جدید همیشه باید مجاز باشد. اگر جلسه موجود وجود داشته باشد، قبل از شروع جلسه جدید باید به طور خودکار توسط دوربین بسته شود. این دستور در سطح 2 API منسوخ شد.
پارامترها
- تایم اوت: (اختیاری) درخواست توقف جلسه در چند ثانیه. در صورت حذف (درخواست 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."
}
} |