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