camera.delete

Borra un archivo a partir de su URI. Este comando se modificó en el nivel de API 2.

Parámetros

  • Nivel de API 1
    • fileUri: El URI de un archivo que se borrará. Los fabricantes deciden si usar URI absolutos o relativos. Los clientes pueden tratar esto como un identificador opaco.
  • Nivel de API 2
    • fileUrls: Es una lista de URL absolutas para los archivos que se borrarán de la cámara, que se obtuvieron antes, p.ej., a partir de los comandos camera.listFiles o camera.takePicture. Existen tres casos especiales:
      • La lista solo contiene la cadena “all”: se borran todos los archivos de la cámara.
      • La lista solo contiene la cadena "image"; es decir, borra todas las imágenes de la cámara.
      • La lista solo contiene la cadena “video”: borra todos los videos de la cámara.

Resultados

  • fileUrls: URLs de archivos que no se borraron correctamente. Ten en cuenta que esto sucede cuando todas las URLs de fileUrls son válidas, pero la cámara no borra algunas de ellas. Si alguna de las URLs no es válida, se debe mostrar el código de error invalidParameterValue sin borrar ningún archivo. Esto se agregó en el nivel de API 2.

Errores

  • missingParameter: No se especifica fileUri.
  • invalidParameterName: No se reconoce el nombre del parámetro de entrada.
  • invalidParameterValue: Se reconoce el nombre del parámetro de entrada, pero su valor no es válido. Por ejemplo, fileUri no existe en el nivel de API 1 o ninguna URL en fileUrls no existe en el nivel de API 2.

E/S de comando
Entrada del comando (nivel de API 1) 
{
    "parameters": {
        "fileUri": "file URI"
    }
}
Resultado del comando (nivel de API 1) 
none
Resultado del comando (error) (nivel de API 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter XYZ is unrecognized."
    }
}
Entrada de comando (nivel de API 2) 
{
    "parameters": {
        "fileUrls": [
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Resultado del comando (nivel de API 2) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
Resultado del comando (error) (nivel de API 2) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}