لبدء جلسة تنتهي صلاحيتها بعد فترة زمنية ثابتة. يقفل الكاميرا أمام العميل المطلوب ويتأكد من بقاء الكاميرا في الوضع النشط. يرجى العلم أنه ينبغي دائمًا السماح ببدء جلسة جديدة. إذا كانت هناك جلسة حالية، يجب إغلاقها تلقائيًا بواسطة الكاميرا قبل بدء الجلسة الجديدة. تم إيقاف هذا الأمر نهائيًا في المستوى 2 من واجهة برمجة التطبيقات.
المَعلمات
- timeout: (اختياري) مهلة الجلسة المطلوبة بالثواني. في حال إسقاطها (بدون نص طلب HTTP)، يجب أن تحدد الكاميرا مهلة معقولة.
النتائج
- sessionId: معرّف الجلسة الفريد لنوع سلسلة.
- timeout:تم تأكيد مهلة الجلسة بالثواني.
الأخطاء
- invalidParameterName: لم يتم التعرّف على اسم مَعلمة الإدخال.
- validParameterValue: يتم التعرّف على اسم معلمة الإدخال، ولكن القيمة التي تم تمريرها غير صالحة؛ على سبيل المثال، القيمة خارج النطاق أو نوع البيانات غير صحيح.
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."
}
} |