camera.startSession

啟動一個在固定的時間間隔後逾時的工作階段。將攝影機鎖定在提出要求的用戶端，並確保攝影機保持喚醒狀態。請注意，您應一律允許啟動新的工作階段。如果有現有的工作階段，攝影機在啟動新的工作階段前應會自動關閉。這個指令已在 API 級別 2 中淘汰。

參數

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

成果

  • sessionId:類型字串的專屬工作階段 ID。
  • timeout：已確認工作階段逾時 (以秒為單位)。

錯誤

  • invalidParameterName：輸入參數名稱無法辨識。
  • invalidParameterValue：系統辨識出輸入參數名稱，但傳遞的值無效；例如值超出範圍或資料類型不正確。

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