camera.delete

刪除指定 URI 的檔案。這個指令已在 API 級別 2 中修改。

參數

  • API 級別 1
    • fileUri：要刪除的檔案 URI。製造商會決定要使用絕對還是相對 URI。用戶端可將其視為不透明 ID。
  • API 級別 2
    • fileUrls：要從相機刪除檔案的絕對網址清單。此清單先前已取得，例如使用 camera.listFiles 或 camera.takePicture 指令。其中有三種特殊情況：
      • 這份清單只包含「all」字串：刪除相機中的所有檔案。
      • 清單中只包含「image」字串：刪除相機中的所有圖片。
      • 這份清單只包含「video」這個字串：刪除相機中的所有影片。

成果

  • fileUrls：無法順利刪除的檔案網址。 請注意，如果 fileUrls 中的所有網址都有效，但相機無法刪除部分網址，就會發生這種情況。如果有任何網址無效，系統應傳回錯誤代碼 invalidParameterValue，而不會刪除任何檔案。已新增至 API 級別 2。

錯誤

  • missingParameter：未指定 fileUri。
  • invalidParameterName：輸入參數名稱無法辨識。
  • invalidParameterValue：系統識別到輸入參數名稱，但其值無效。舉例來說，API 級別 1 中沒有 fileUri，或者 API 級別 2 中不存在任何 fileUrls 網址。

指令 I/O
指令輸入 (API 級別 1) 
{
    "parameters": {
        "fileUri": "file URI"
    }
}
指令輸出 (API 級別 1) 
none
指令輸出 (錯誤) (API 級別 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter XYZ is unrecognized."
    }
}
指令輸入 (API 級別 2) 
{
    "parameters": {
        "fileUrls": [
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
指令輸出 (API 級別 2) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
指令輸出 (錯誤) (API 級別 2) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}