downloadFile
Bắt đầu hỗ trợ ở phiên bản:
- SDK: 2.44.0
Lưu ý
Cần xin cấp quyền tại trang Quản lý ứng dụng
Dùng để tải file về thiết bị. Hỗ trợ giao thức tải file https:// với các định dạng được hỗ trợ được liệt kê ở bảng bên dưới.
Support File Type
Category | Extension |
---|---|
Text | pdf, doc, docx, odt, xls, xlsx, ppt, pptx, txt, rtf, csv |
Image | jpg, jpeg, png, gif, bmp |
Video | mp4, avi, mkv, mov, wmv |
Parameters
Object object
Property | Type | Default | Required | Description | Minimum Version |
---|---|---|---|---|---|
url | string | true | Đường dẫn của file muốn download | ||
onProgress | function | Callback function tiến độ tải file. Với progress là number từ 0 đến 100% | |||
success | function | Callback function khi gọi api thành công | |||
fail | function | Callback function khi gọi api thất bại |
Sample Code
import { downloadFile } from "zmp-sdk/apis";
downloadFile({
url: "https://filesamples.com/samples/image/jpg/sample_640%C3%97426.jpg",
onProgress: (progress) => {
console.log(progress);
},
success: () => {
// xử lý khi gọi api thành công
},
fail: (error) => {
// xử lý khi gọi api thất bại
console.log(error);
},
});
// hoặc
import { downloadFile } from "zmp-sdk/apis";
const downloadFileToDevice = async () => {
try {
await downloadFile({
url: "https://filesamples.com/samples/image/jpg/sample_640%C3%97426.jpg",
onProgress: (progress) => {
console.log(progress);
},
});
} catch (error) {
// xử lý khi gọi api thất bại
console.log(error);
}
};
Errors
Code | Message | Note |
---|---|---|
-301 | Your device run out of storage | |
-302 | File cannot be found. Please check your param again. | Không tìm được file. Có 2 trường hợp dẫn đến lỗi
|
-303 | Please wait... We're still download the file. | |
-304 | No Internet connection. Please check your network settings. | |
-305 | Download failed. Please check your network or file path again. | |
-306 | File type unsupported | Tham khảo danh sách file hỗ trợ |