camera.delete

Xoá một tệp dựa trên URI của tệp đó. Lệnh này đã được sửa đổi trong API cấp 2.

Tham số

  • API cấp 1
    • fileUri: URI của một tệp cần xoá. Nhà sản xuất quyết định cho dù là sử dụng URI tuyệt đối hay tương đối. Khách hàng có thể coi đây là dữ liệu không rõ ràng giá trị nhận dạng.
  • API cấp 2
    • fileUrls: Danh sách URL tuyệt đối cho các tệp cần xoá thông qua máy ảnh được lấy trước đó, ví dụ: từ camera.listFiles hoặc camera.takePicture. Có ba trường hợp đặc biệt:
      • Danh sách này chỉ chứa chuỗi "all": hãy xoá tất cả các tệp trong camera.
      • Danh sách này chỉ chứa chuỗi "image" (hình ảnh): hãy xóa tất cả hình ảnh trong máy ảnh.
      • Danh sách này chỉ chứa chuỗi "video": hãy xoá tất cả video trong máy ảnh.

Kết quả

  • fileUrls: URL của những tệp không xoá được. Xin lưu ý rằng điều này xảy ra khi tất cả URL trong fileUrls đều hợp lệ nhưng máy ảnh bị lỗi để xoá một vài báo cáo trong số đó. Nếu có bất kỳ URL nào không hợp lệ thì mã lỗi Phải trả về invalidParameterValue mà không xoá bất kỳ tệp nào. Nội dung này đã được thêm vào API cấp 2.

Lỗi

  • missingTham số: fileUri chưa được chỉ định.
  • không hợp lệTham số: Tên tham số đầu vào không nhận dạng được.
  • invalidParameterValue: Tên thông số đầu vào được công nhận, nhưng giá trị của thuộc tính này không hợp lệ; ví dụ: fileUri không tồn tại trong API cấp 1 hoặc bất kỳ URL nào trong fileUrls không tồn tại trong API cấp 2.

Lệnh I/O
Đầu vào lệnh (API cấp 1) 
{
    "parameters": {
        "fileUri": "file URI"
    }
}
Đầu ra lệnh (API cấp 1) 
none
Kết quả lệnh (Lỗi) (API cấp 1) 
{
    "error": {
        "code": "invalidParameterName",
        "message": "Parameter XYZ is unrecognized."
    }
}
Đầu vào lệnh (API cấp 2) 
{
    "parameters": {
        "fileUrls": [
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Đầu ra lệnh (API cấp 2) 
{
    "results": {
        "fileUrls": [
            "urln"
        ]
    }
}
Kết quả lệnh (Lỗi) (API cấp 2) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter url3 doesn't exist."
    }
}