camera.takePicture

擷取等矩長方形圖片，儲存經緯度座標 至 EXIF (您的相機有其專屬 GPS 或在連線時啟用 GPS) 行動電話)。致電「camera.setOptions」 再進行這項作業這個指令是在 API 級別 2 中修改。

參數

結果

  • API 級別 1
    • fileUri:已拍攝圖片的 URI。製造商 決定是否要使用絕對 URI 或相對 URI例如 "http://android.com/robots.txt"是 「robots.txt」時的絕對 URI為相對 URI客戶可以考慮 作為不透明 ID
  • API 級別 2
    • fileUrl:擷取資料的絕對網址， 直接從相機的 HTTP 伺服器下載。請 請注意，這個指令不會立即傳回 fileUrl，因為 拍攝 (包括使用相機內拼接) 通常需要一點時間 (視 秒到幾分鐘) 才能完成。指令的執行進度會由 利用 /osc/commands/status API 定期輪詢相機，並 fileUrl 是指令執行完畢後傳回的結果。時間 delayProcessing 為 true，這是預覽的絕對網址 圖片，並可做為 processP 的輸入內容處理圖片 否則，就會是最終處理後圖片的絕對網址。

錯誤

  • missingParameter：缺少 sessionId。 這個錯誤代碼已在 API 級別 2 中淘汰。
  • INVALIDParameterName：無法辨識參數名稱，例如無法在 API 級別 2 中識別 sessionId。
  • invalidParameterValue:：系統會識別輸入參數名稱， 但值無效；例如，sessionId 不存在。 已失效，或是資料類型不正確。這個錯誤代碼已在 API 級別 2 中淘汰。
  • disabledCommand：指令目前已停用。例如 相機處於錄影模式這個錯誤代碼已在 API 級別 2 中新增。

指令 I/O
指令輸入 (API 級別 1) 
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
指令輸出 (API 級別 1) 
{
    "results": {
        "fileUri": "file URI"
    }
}
指令輸出 (錯誤) (API 級別 1) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
指令輸入 (API 級別 2) 
none
指令輸出 (API 級別 2) 
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
指令輸出 (錯誤) (API 級別 2) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}