camera.updateSession
يُعيد تحميل مهلة الجلسة. يتم تحديث الجلسة تلقائيًا في أي
التفاعل مع الكاميرا؛ على سبيل المثال، يمكن أن تبدأ الجلسة
ينبغي إعادة تعيين مهلة 10 دقائق إلى الدقائق العشر الكاملة عندما
يتم تنفيذ الأمر takePicture
. تم إيقاف هذا الأمر نهائيًا
في المستوى 2 من واجهة برمجة التطبيقات
المعلمات
- sessionId: معرّف فريد للجلسة من نوع السلسلة.
- المهلة: (اختيارية) مهلة الجلسة المطلوبة بالثواني.
في حال الحذف (لا يحتوي طلب HTTP على نص)، يجب أن تحدد الكاميرا قيمة
المهلة.
النتائج
- sessionId: تم تأكيد سلسلة معرّف الجلسة التي تم تمريرها
إلى الأمر.
- المهلة: تم تأكيد مهلة الجلسة بالثواني.
الأخطاء
- مَعلمة غير متوفّرة:السمة
sessionId
غير متوفّرة. على سبيل المثال،
لم يتم تحديد sessionId
.
- spamparamName: هناك اسم واحد أو أكثر من أسماء معلَمات الإدخال
لم يتم التعرّف عليها.
- invalidParameterValue: يتم التعرف على أسماء معلَمات الإدخال،
ولكن هناك قيمة واحدة أو أكثر تم تمريرها غير صالحة؛ على سبيل المثال، السمة
sessionId
غير موجود أو لم تعد نشطة أو نوع بياناتها غير صحيح أو
timeout
هو نوع البيانات الخاطئ.
مفتاح Command 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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["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"]]