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

推荐答案

-- -------------------- ---- -------
---------------------------
  --------- ------- -- -------
  ------------ -
    --------------------- -----
  --
  --------- -
    ----------------------- -----
  -
---

本题详细解读

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. 示例代码

-- -------------------- ---- -------
---------------
  ------------ -
    -- -------------------------------------------- -
      --------------
        ------ -------------------------
        --------- -
          -- ------
          ---------------------------
            --------- -------
            ------------ -
              --------------------- -----
            --
            --------- -
              ----------------------- -----
            -
          ---
        --
        ------ -
          ------------------------
        -
      ---
    - ---- -
      -- ------
      ---------------------------
        --------- -------
        ------------ -
          --------------------- -----
        --
        --------- -
          ----------------------- -----
        -
      ---
    -
  -
---

5. 注意事项

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