camera.delete

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

Parâmetros

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

Resultados

  • fileUrls::URLs de arquivos que não são excluídos. Isso acontece quando todos os URLs em fileUrls são válidos, mas a câmera falha para excluir algumas delas. Se algum dos URLs for inválido, o código do erro invalidParameterValue precisa ser retornado sem excluir nenhum arquivo. Isso 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 seu valor é inválido. Por exemplo, o fileUri não existe no nível 1 da API ou nenhum URL em fileUrls não existe no nível 2 da API.

E/S de comando
Entrada de comando (nível 1 da API) 
{
    "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 (nível 2 da API) 
{
    "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."
    }
}