uni.saveImageToPhotosAlbum的使用-优快云博客

本文介绍uniApp中uni.saveImageToPhotosAlbum函数的使用，详细解析该方法的参数说明和平台差异，同时提供用户授权及H5平台的注意事项，并给出示例代码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

uni.saveImageToPhotosAlbum(OBJECT)

保存图片到系统相册。

平台差异说明

App	H5	微信小程序	支付宝小程序	百度小程序	字节跳动小程序	QQ小程序
√	x	√	√	√	√	√

OBJECT 参数说明

参数名	类型	必填	说明
filePath	String	是	图片文件路径，可以是临时文件路径也可以是永久文件路径，不支持网络图片路径
success	Function	否	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明

参数名	类型	说明
path	String	保存到相册的图片路径，仅 App 3.0.5+ 支持
errMsg	String	调用结果

注意

可以通过用户授权API来判断用户是否给应用授予相册的访问权限https://uniapp.dcloud.io/api/other/authorize
H5没有API可触发保存到相册行为，下载图片时浏览器会询问图片存放地址。

示例代码：

uni.chooseImage({
    count: 1,
    sourceType: ['camera'],
    success: function (res) {
        uni.saveImageToPhotosAlbum({
            filePath: res.tempFilePaths[0],
            success: function () {
                console.log('save success');
            }
        });
    }
});

实例：

uni.downloadFile({
        url: 'https://www.abc123.png',
        success: (res) =>{
            if (res.statusCode === 200){
                uni.saveImageToPhotosAlbum({
                    filePath: res.tempFilePath,
                    success: function() {
                        uni.showToast({
                            title: "保存成功",
                            icon: "none"
                        });
                    },
                    fail: function() {
                        uni.showToast({
                            title: "保存失败",
                            icon: "none"
                        });
                    }
                });
            }
        }
    })