camera.updateSession
زمان پایان جلسه را تازه می کند. یک جلسه به طور خودکار در مورد هر گونه تعامل با دوربین به روز می شود. به عنوان مثال، جلسه ای که با وقفه 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." } } |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-11-08 بهوقت ساعت هماهنگ جهانی."],[[["Refreshes the camera session timeout upon interaction and resets it to the initially specified duration."],["Requires a unique session identifier (`sessionId`) and optionally allows specifying a desired timeout duration in seconds."],["Returns the confirmed session identifier and timeout or reports errors like missing or invalid parameters."],["This command is deprecated and was replaced with newer methods in API level 2."]]],["The core function is to refresh a camera session's timeout. It utilizes a `sessionId` string for identification. An optional `timeout` parameter (in seconds) can be set; otherwise, the camera determines a reasonable duration. Successful execution returns the confirmed `sessionId` and `timeout`. Errors occur with missing or invalid `sessionId`, or invalid parameter names/values. This command has been deprecated from API level 2.\n"]]