camera.delete

Exclui um arquivo com base no URI dele. Esse comando foi modificado no nível 2 da API.

Parâmetros

  • API de nível 1
    • fileUri:URI de um arquivo a ser excluído. Os fabricantes decidem se querem usar URIs absolutos ou relativos. Os clientes podem tratá-lo como um identificador opaco.
  • API de nível 2
    • fileUrls:uma lista de URLs absolutos para que os arquivos sejam excluídos da câmera e que foram recebidos anteriormente, por exemplo, dos comandos camera.listFiles ou camera.takePicture. Há três casos especiais:
      • A lista contém apenas a string "all": exclua todos os arquivos da câmera.
      • A lista contém apenas a string "image": exclua todas as imagens da câmera.
      • A lista contém apenas a string "video": exclua todos os vídeos da câmera.

Resultados

  • fileUrls:URLs de arquivos que não foram excluídos. Isso acontece quando todos os URLs em fileUrls são válidos, mas a câmera não exclui alguns deles. Se algum dos URLs for inválido, o código de erro invalidParameterValue deverá ser retornado sem excluir nenhum arquivo. Foi adicionado no nível 2 da API.

Erros

  • missingParameter: fileUri não especificado.
  • invalidParameterName:o nome do parâmetro de entrada não foi reconhecido.
  • invalidParameterValue:o nome do parâmetro de entrada é reconhecido, mas o valor dele é inválido. Por exemplo, o fileUri não existe na API de nível 1 ou qualquer URL em fileUrls não existe na API de nível 2.

E/S do comando
Entrada de comando (API de nível 1) 
{
    "parameters": {
        "fileUri": "file URI"
    }
}
Resposta ao comando (nível 1 da API) 
none
Resposta ao comando (erro) (nível 1 da API) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter XYZ is unrecognized."
    }
}
Entrada de comando (API de nível 2) 
{
    "parameters": {
        "fileUrls": [
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Resposta ao comando (nível 2 da API) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
Resposta ao comando (erro) (nível 2 da API) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}