swan.saveImageToPhotosAlbum

解释: 保存图片到系统相册,使用该 API 需通过获取用户授权设置申请授权后方可对用户发起授权申请,可在 swan.authorize 中查看相关错误码信息。
Web 态说明:由于 Web 态环境安全策略限制,该功能无法支持,会返回失败回调。

# 方法参数

Object object

# object参数说明

属性名 类型 必填 默认值 说明
filePath String 图片文件路径,可以是临时文件路径也可以是永久文件路径,不支持网络图片路径。
success Function 接口调用成功的回调函数
fail Function 接口调用失败的回调函数
complete Function 接口调用结束的回调函数(调用成功、失败都会执行)

# 示例

扫码体验
重新加载
请使用百度APP扫码

# 图片示例

# 代码示例

    <view class="wrap">
        <view class="card-area">
            <image mode="aspectFill" class="display-area-image" src="https://b.bdstatic.com/miniapp/image/getImageInfo.png"></image>
            <button type="primary" bindtap="saveImageToPhotosAlbum">保存</button>
            <view class="tip-week">此api需要相册授权</view>
        </view>
    </view>
    
    Page({
        data: {
            filePath: ''
        },
        saveImageToPhotosAlbum() {
            swan.authorize({
                scope:'scope.writePhotosAlbum',
                success: res => {
                    console.log('authorize success', res);
                },
                fail: err => {
                    console.log('authorize fail', err);
                    swan.openSetting({});
                    swan.showToast({
                        title: '授权失败',
                        icon: 'none'
                    });
                }
            });
            swan.downloadFile({
                url: 'https://b.bdstatic.com/miniapp/image/getImageInfo.png',
                header: {
                    'content-type': 'application/json'
                },
                success: res => {
                    let filePath = res.tempFilePath;
                    swan.saveImageToPhotosAlbum({
                        filePath, // 暂不支持网络图片/本地图片地址,需与swan.downloadFile一起使用
                        success: res => {
                            swan.showToast({
                                title: '已保存到本地相册',
                                icon: 'none'
                            });
                            console.log('saveImageToPhotosAlbum success', res);
                        },
                        fail: err => {
                            swan.showToast({
                                title: '保存失败',
                                icon: 'none'
                            });
                            console.log('saveImageToPhotosAlbum fail', err);
                        }
                    });
                },
                fail: err => {
                    console.log('错误码:' + err.errCode);
                    console.log('错误信息:' + err.errMsg);
                }
            });
        }
    });