如何使用 wx.saveImageToPhotosAlbum 保存图片到系统相册？

推荐答案

// www.javascriptcn.com code example
wx.saveImageToPhotosAlbum({
  filePath: '图片路径', // 图片的本地路径
  success(res) {
    console.log('图片保存成功', res);
  },
  fail(err) {
    console.error('图片保存失败', err);
  }
});

本题详细解读

1. wx.saveImageToPhotosAlbum 的作用

wx.saveImageToPhotosAlbum 是微信小程序提供的一个 API，用于将图片保存到用户的系统相册中。这个 API 需要用户授权才能使用，因此在调用之前，通常需要先检查用户是否授权了相册访问权限。

2. 参数说明

• filePath: 必填参数，表示要保存的图片的本地路径。这个路径通常是通过 wx.chooseImage 或 wx.getImageInfo 等 API 获取的。
• success: 可选参数，保存成功后的回调函数。回调函数会接收到一个 res 对象，包含保存操作的结果信息。
• fail: 可选参数，保存失败后的回调函数。回调函数会接收到一个 err 对象，包含失败的原因。

3. 使用步骤

1. 获取图片路径: 首先需要通过 wx.chooseImage 或 wx.getImageInfo 等 API 获取图片的本地路径。
2. 检查权限: 在调用 wx.saveImageToPhotosAlbum 之前，建议先检查用户是否授权了相册访问权限。可以使用 wx.getSetting 来检查权限。
3. 保存图片: 调用 wx.saveImageToPhotosAlbum，传入图片路径，并在 success 和 fail 回调中处理保存结果。

4. 示例代码

// www.javascriptcn.com code example
wx.getSetting({
  success(res) {
    if (!res.authSetting['scope.writePhotosAlbum']) {
      wx.authorize({
        scope: 'scope.writePhotosAlbum',
        success() {
          // 用户已经授权
          wx.saveImageToPhotosAlbum({
            filePath: '图片路径',
            success(res) {
              console.log('图片保存成功', res);
            },
            fail(err) {
              console.error('图片保存失败', err);
            }
          });
        },
        fail() {
          console.error('用户拒绝授权');
        }
      });
    } else {
      // 用户已经授权
      wx.saveImageToPhotosAlbum({
        filePath: '图片路径',
        success(res) {
          console.log('图片保存成功', res);
        },
        fail(err) {
          console.error('图片保存失败', err);
        }
      });
    }
  }
});

5. 注意事项

• 用户授权: 在调用 wx.saveImageToPhotosAlbum 之前，必须确保用户已经授权了相册访问权限。如果用户未授权，需要先调用 wx.authorize 请求授权。
• 图片路径: 图片路径必须是本地路径，不能是网络路径。如果需要保存网络图片，可以先使用 wx.downloadFile 将图片下载到本地。
• 兼容性: wx.saveImageToPhotosAlbum 在微信小程序基础库 1.2.0 及以上版本中支持。