camera.updateSession

重新整理工作階段逾時。每當與攝影機互動時，工作階段都會自動更新；舉例來說，執行 takePicture 指令時，逾時時間須介於 10 分鐘的工作階段應重設為完全 10 分鐘。這個指令已在 API 級別 2 中淘汰。

參數

  • sessionId:類型字串的專屬工作階段 ID。
  • timeout： (選用) 要求的工作階段逾時時間 (以秒為單位)。 如果省略 (HTTP 要求沒有主體)，相機應判斷合理的逾時時間。

成果

  • sessionId:已確認傳送至指令的工作階段 ID 字串。
  • timeout：已確認工作階段逾時 (以秒為單位)。

錯誤

  • missingParameter：缺少 sessionId；例如，未指定 sessionId。
  • invalidParameterName：有一或多個輸入參數名稱無法辨識。
  • invalidParameterValue：系統可辨識輸入參數名稱，但一或多個傳遞的值無效；例如 sessionId 不存在、已失效、其資料類型不正確，或是 timeout 是錯誤的資料類型。

指令 I/O
指令輸入 
{
    "parameters": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
指令輸出 
{
    "results": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
指令輸出 (錯誤) 
{
    "error": {
        "code": "missingParameter",
        "message": "Parameter sessionId is missing."
    }
}