camera.delete

Menghapus file yang diberikan URI-nya. Perintah ini diubah di API level 2.

Parameter

  • Level API 1
    • fileUri: URI file yang akan dihapus. Produsen memutuskan apakah akan menggunakan URI absolut atau relatif. Klien mungkin menganggap ini sebagai buram yang sesuai.
  • Level API 2
    • fileUrls: Daftar URL mutlak untuk file yang akan dihapus dari kamera, yang diperoleh sebelumnya, misalnya dari camera.listFiles atau camera.takePicture. Ada tiga kasus khusus:
      • Daftar hanya berisi string "all": hapus semua file di kamera.
      • Daftar ini hanya berisi string “image”: hapus semua gambar di kamera.
      • Daftar hanya berisi string “video”: hapus semua video di kamera.

Hasil

  • fileUrls: URL file yang tidak berhasil dihapus. Perlu diketahui bahwa hal ini terjadi jika semua URL dalam fileUrl valid, tetapi kamera gagal untuk menghapus beberapa di antaranya. Jika salah satu URL tidak valid, kode error invalidParameterValue akan ditampilkan tanpa menghapus file apa pun. Ini ditambahkan di API level 2.

Error

  • missingParameter: fileUri tidak ditentukan.
  • invalidParameterName: Nama parameter input tidak dikenal.
  • invalidParameterValue: Nama parameter input dikenali, tetapi nilainya tidak valid; misalnya, fileUri tidak ada di API level 1 atau URL apa pun di fileUrl tidak ada di API level 2.

I/O Perintah
Input Perintah (API level 1) 
{
    "parameters": {
        "fileUri": "file URI"
    }
}
Output Perintah (API level 1) 
none
Output Perintah (Error) (API level 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter XYZ is unrecognized."
    }
}
Input Perintah (API level 2) 
{
    "parameters": {
        "fileUrls": [
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Output Perintah (API level 2) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
Output Perintah (Error) (API level 2) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}