מצלמה.updateSession

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

פרמטרים

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

תוצאות

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

שגיאות

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

Command I/O
קלט פקודה 
{
    "parameters": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
פלט הפקודה 
{
    "results": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
פלט הפקודה (שגיאה) 
{
    "error": {
        "code": "missingParameter",
        "message": "Parameter sessionId is missing."
    }
}