מרענן את הזמן הקצוב לתפוגה של סשן. סשן מתעדכן באופן אוטומטי בכל
אינטראקציה עם המצלמה; לדוגמה, סשן מתחיל
הזמן הקצוב לתפוגה של 10 דקות אמור להתאפס ל-10 הדקות המלאות,
הפקודה takePicture מבוצעת. הפקודה הזו הוצאה משימוש
ברמת API 2.
פרמטרים
- sessionId: מזהה סשן ייחודי של מחרוזת סוג.
- timeout: (אופציונלי) הזמן הקצוב לתפוגה של הסשן המבוקש, בשניות. אם היא לא מופיעה (לבקשת HTTP אין גוף), היא צריכה לקבוע ערך סביר של הזמן הקצוב לתפוגה.
תוצאות
- sessionId: מחרוזת של מזהה הסשן המאושר שהועברה לפקודה.
- timeout: אושר הזמן הקצוב לתפוגה של סשן בשניות.
שגיאות
- missingParameter:
sessionIdחסר; לדוגמה,sessionIdלא צוין. - invalidParameterName: אחד או יותר מהשמות של פרמטרים של קלט הם לא מזוהה.
- invalidParameterValue: שמות פרמטרים של קלט מזוהים,
אבל אחד או יותר מהערכים שמועברים לא תקינים. לדוגמה,
sessionIdלא קיים, הוא לא פעיל יותר, סוג הנתונים שלו שגוי, או סוג הנתוניםtimeoutשגוי.
Command I/O | |
|---|---|
| קלט פקודה | {
"parameters": {
"sessionId": "12ABC3",
"timeout": 50
}
} |
| פלט הפקודה | {
"results": {
"sessionId": "12ABC3",
"timeout": 50
}
} |
| פלט הפקודה (שגיאה) | {
"error": {
"code": "missingParameter",
"message": "Parameter sessionId is missing."
}
} |