زمان پایان جلسه را تازه می کند. یک جلسه به طور خودکار در مورد هر گونه تعامل با دوربین به روز می شود. به عنوان مثال، جلسه ای که با وقفه 10 دقیقه ای شروع می شود، باید به 10 دقیقه کامل بازنشانی شود، زمانی که دستور takePicture اجرا می شود. این دستور در سطح 2 API منسوخ شد.
مولفه های
- sessionId: شناسه جلسه منحصر به فرد از نوع رشته.
- تایم اوت: (اختیاری) درخواست توقف جلسه در چند ثانیه. در صورت حذف (درخواست HTTP بدون بدنه)، دوربین باید یک بازه زمانی معقول تعیین کند.
نتایج
- sessionId: رشته شناسه جلسه تایید شده که به دستور ارسال شده است.
- تایم اوت: زمان پایان جلسه در چند ثانیه تایید شد.
خطاها
- missingParameter:
sessionIdاز دست رفته است. برای مثالsessionIdمشخص نشده است. - invalidParameterName: نام یک یا چند پارامتر ورودی شناسایی نشده است.
- invalidParameterValue: نام پارامترهای ورودی شناسایی می شود، اما یک یا چند مقدار ارسال شده نامعتبر است. به عنوان مثال،
sessionIdوجود ندارد، دیگر فعال نیست، نوع داده آن نادرست است، یاtimeout، نوع داده اشتباه است.
دستور I/O | |
|---|---|
| ورودی فرمان | {
"parameters": {
"sessionId": "12ABC3",
"timeout": 50
}
} | خروجی فرمان | {
"results": {
"sessionId": "12ABC3",
"timeout": 50
}
} |
| خروجی فرمان (خطا) | {
"error": {
"code": "missingParameter",
"message": "Parameter sessionId is missing."
}
} |