session.startSession

يبدأ جلسة تنتهي مهلتها بعد فاصل زمني ثابت. قفل الكاميرا على يطلب العميل وتتأكد من بقاء الكاميرا في الوضع النشط. يرجى ملاحظة أنه بدءًا من ينبغي السماح دائمًا بجلسة جديدة. إذا كانت هناك جلسة حالية، يجب أن يتم إغلاقه تلقائيًا بواسطة الكاميرا قبل بدء الجلسة الجديدة. تم إيقاف هذا الأمر نهائيًا في المستوى 2 من واجهة برمجة التطبيقات.

المعلمات

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

النتائج

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

الأخطاء

  • spamparamName: لم يتم التعرُّف على اسم معلَمة الإدخال.
  • invalidParameterValue: يتم التعرف على اسم معلَمة الإدخال، ولكن القيمة التي تم تمريرها غير صالحة؛ على سبيل المثال، القيمة خارج النطاق أو بياناتها النوع غير صحيح.

مفتاح Command 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."
    }
}