מצלמה.startSession

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

פרמטרים

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

תוצאות

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

שגיאות

  • INVALIDParameterName: השם של פרמטר הקלט לא מזוהה.
  • 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."
    }
}