`uni.chooseImage` 是一个 uni-app 的 API,用于从本地相册选择图片或使用相机拍照。

1,166 阅读1分钟

uni.chooseImage 是一个 uni-app 的 API,用于从本地相册选择图片或使用相机拍照。

使用说明

调用此函数会打开手机的相册或照相机界面,用户可以选择图片或拍照后返回应用。

API 结构

uni.chooseImage({
    count: 1, // 默认为9,设置选择图片的数量
    sizeType: ['original', 'compressed'], // 可以指定是原图还是压缩图,默认二者都有
    sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机,默认二者都有
    success: function (res) {
        // 返回选定照片的本地文件路径列表 tempFilePaths
        console.log(res.tempFilePaths);
    }
});

参数说明

  • count:最多可以选择的图片张数,默认为9。
  • sizeType:图片的质量,原图或压缩图,默认为原图与压缩图都有。
  • sourceType:选择图片的来源,相册或相机,默认为相册与相机都可以。
  • success:接口调用成功的回调函数,返回图片的本地临时文件路径列表 tempFilePaths
  • fail:接口调用失败的回调函数。
  • complete:接口调用结束的回调函数(调用成功、失败都会执行)。

示例代码

uni.chooseImage({
    count: 3, // 选择3张图片
    sizeType: ['original'], // 只选择原图
    sourceType: ['album', 'camera'], // 从相册和相机选择
    success: function (res) {
        // tempFilePath可以作为img标签的src属性显示图片
        const tempFilePaths = res.tempFilePaths;
        tempFilePaths.forEach((path) => {
            console.log(path);
        });
    }
});

在使用时,需要注意用户的隐私权限设置,确保应用已获取到访问相册的权限。

有关详细信息,请查阅 uni-app 官方文档