camera.delete

Menghapus file berdasarkan 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 dapat memperlakukan ini sebagai ID buram.
  • Level API 2
    • fileUrls: Daftar URL absolut untuk file yang akan dihapus dari kamera, yang diperoleh sebelumnya, misalnya dari perintah camera.listFiles atau camera.takePicture. Ada tiga kasus khusus:
      • Daftar hanya berisi string “semua”: hapus semua file di kamera.
      • Daftar hanya berisi string “image”: hapus semua gambar dalam kamera.
      • Daftar hanya berisi string “video”: hapus semua video di kamera.

Hasil

  • fileUrls: URL file yang tidak berhasil dihapus. Perhatikan bahwa ini terjadi jika semua URL di fileUrls valid, tetapi kamera gagal menghapus beberapa di antaranya. Jika salah satu URL tidak valid, kode error invalidParameterValue harus ditampilkan tanpa menghapus file apa pun. Hal 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.

Perintah I/O
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."
    }
}