camera.delete

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

Các tham số

  • API cấp 1
    • fileUri: URI của tệp cần xoá. Các nhà sản xuất sẽ quyết định nên sử dụng URI tuyệt đối hay tương đối. Ứng dụng có thể coi đây là giá trị nhận dạng mờ.
  • API cấp 2
    • fileUrls: Danh sách các URL tuyệt đối của các tệp cần xoá khỏi máy ảnh, đã được lấy trước đó, chẳng hạn như từ các lệnh camera.listFiles hoặc camera.takePicture. Có ba trường hợp đặc biệt:
      • Danh sách chỉ chứa chuỗi "all": xoá tất cả tệp trong máy ảnh.
      • Danh sách này chỉ chứa chuỗi "image" (hình ảnh): xoá tất cả hình ảnh trong máy ảnh.
      • Danh sách này chỉ chứa chuỗi “video”: xoá tất cả video trong máy ảnh.

Kết quả

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

Lỗi

  • missingParameter: fileUri không được chỉ định.
  • invalidParameterName: Không nhận dạng được tên của thông số đầu vào.
  • invalidParameterValue: Tên tham số đầu vào được nhận dạng nhưng giá trị của tham số đó 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.

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