camera.delete

根据文件的 URI 删除文件。此命令在 API 级别 2 中进行了修改。

参数

  • API 级别 1
    • fileUri：要删除的文件的 URI。制造商决定是使用绝对 URI 还是相对 URI。客户端可以将其视为不透明标识符。
  • 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."
    }
}