מצלמה.startSession

מתחיל סשן שמסתיים לאחר מרווח זמן קבוע. נועלת את המצלמה ללקוח שמבקש ומוודאים שהמצלמה לא במצב שינה. שימו לב, תמיד צריכה להיות אפשרות להתחיל הפעלה חדשה. אם יש סשן קיים, המצלמה אמורה לסגור אותו אוטומטית לפני התחלת הסשן החדש. הפקודה הזו הוצאה משימוש ברמת API 2.

פרמטרים

  • timeout: (אופציונלי) הזמן הקצוב לתפוגה של סשן באתר, בשניות. אם חסר תוכן (לבקשת HTTP אין גוף), המצלמה צריכה לקבוע זמן קצוב לתפוגה סביר.

תוצאות

  • sessionId: מזהה הסשן הייחודי של מחרוזת הסוג.
  • timeout: זמן קצוב לתפוגה של סשן מאושר, בשניות.

שגיאות

  • legalParameterName: השם של פרמטר הקלט לא מזוהה.
  • legalParameterValue: השם של פרמטר הקלט מזוהה, אבל הערך שהועבר לא חוקי. לדוגמה, הערך נמצא מחוץ לטווח או שסוג הנתונים שגוי.

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."
    }
}