chooseImage

Cập nhật lần cuối: 23/5/2025

Bắt đầu hỗ trợ ở phiên bản:
SDK: 2.23.4

import { chooseImage } from "zmp-sdk/apis";

API chọn hình ảnh từ album hoặc camera.

Ví dụ

Chụp hình ảnh từ camera trước:

const { filePaths } = await chooseImage({
  sourceType: ["camera"],
  cameraType: "front",
});

Chụp hình ảnh từ camera sau:

const { filePaths } = await chooseImage({
  sourceType: ["camera"],
  cameraType: "back",
});

Chọn nhiều hình ảnh để viết đánh giá sản phẩm:

const { filePaths } = await chooseImage({
  sourceType: ["album", "camera"],
  count: 5,
});

Xem hướng dẫn xử lý lỗi và bảng mô tả chi tiết mã lỗi tại đây.

Truyền tham số vào API dưới dạng object chứa các thuộc tính:

Name	Type	Description
cameraType	`"back" \| "front"`	Xác định camera cần mở là camera trước hay sau.
count	`number`	Số lượng hình ảnh tối đa có thể chọn.
sourceType	`("album" \| "camera")[]`	Nguồn chọn hình ảnh. Có thể chọn từ album/tệp (`album`), chụp ảnh mới từ camera (`camera`), hoặc cả hai.

API trả về Promise<ChooseImageReturns> chứa chứa đường dẫn tới hình ảnh đã chọn.

Name	Type	Default	Description
filePaths	`string[]`		Đường dẫn các file đã chọn.
tempFiles	`TempFile[]`		Thông tin các temp files.

Name	Type	Default	Description
path	`string`		Đường dẫn các temp file đã chọn.
size	`number`		Kích thước các temp file đã chọn.