camera.updateSession

يُعيد تحميل مهلة الجلسة. ويتم تعديل أي جلسة تلقائيًا عند أي تفاعل مع الكاميرا. على سبيل المثال، يجب إعادة ضبط أي جلسة تبدأ بمهلة 10 دقائق إلى 10 دقائق كاملة عند تنفيذ أمر takePicture. تم إيقاف هذا الأمر نهائيًا في المستوى 2 من واجهة برمجة التطبيقات.

المَعلمات

  • sessionId: معرّف الجلسة الفريد لنوع سلسلة.
  • timeout: (اختياري) مهلة الجلسة المطلوبة بالثواني. في حال إسقاطها (بدون نص طلب HTTP)، يجب أن تحدد الكاميرا مهلة معقولة.

النتائج

  • sessionId: تم تأكيد سلسلة معرّف الجلسة التي تم تمريرها إلى الأمر.
  • timeout:تم تأكيد مهلة الجلسة بالثواني.

الأخطاء

  • missingParameter: السمة sessionId غير متوفّرة، على سبيل المثال، لم يتم تحديد sessionId.
  • unusedParameterName: لم يتم التعرّف على اسم واحد أو أكثر من أسماء مَعلمات الإدخال.
  • unusedParameterValue: يتم التعرّف على أسماء مَعلمات الإدخال، ولكن قيمة واحدة أو أكثر من القيم التي تم تمريرها غير صالحة. على سبيل المثال، قيمة sessionId غير موجودة، أو لم تعُد نشطة، أو نوع بياناتها غير صحيح، أو timeout من نوع البيانات الخطأ.

Command I/O (إدخال وإخراج)

إدخال الأوامر
{
    "parameters": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
مخرجات الأوامر
{
    "results": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
مخرجات الأمر (خطأ)
{
    "error": {
        "code": "missingParameter",
        "message": "Parameter sessionId is missing."
    }
}