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:：系統會識別輸入參數名稱， 但值無效；舉例來說，fileUri 沒有 在 API 級別 1 中，或 fileUrls 中的任何網址不存在於 API 級別 2 中。

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