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

推荐答案

// www.javascriptcn.com code example
uni.downloadFile({
  url: 'https://example.com/image.jpg', // 替换为实际的图片URL
  success: (res) => {
    if (res.statusCode === 200) {
      uni.saveImageToPhotosAlbum({
        filePath: res.tempFilePath,
        success: () => {
          uni.showToast({
            title: '图片保存成功',
            icon: 'none'
          });
        },
        fail: (err) => {
          uni.showToast({
            title: '图片保存失败',
            icon: 'none'
          });
          console.error('保存失败:', err);
        }
      });
    }
  },
  fail: (err) => {
    uni.showToast({
      title: '图片下载失败',
      icon: 'none'
    });
    console.error('下载失败:', err);
  }
});

本题详细解读

1. uni.downloadFile 方法

uni.downloadFile 是 uni-app 提供的一个 API，用于从网络下载文件到本地临时路径。在这个例子中，我们使用它来下载图片文件。

• url: 需要下载的图片的 URL 地址。
• success: 下载成功后的回调函数，返回一个包含临时文件路径的对象 res。
• fail: 下载失败后的回调函数，返回错误信息。

2. uni.saveImageToPhotosAlbum 方法

uni.saveImageToPhotosAlbum 是 uni-app 提供的另一个 API，用于将图片保存到系统相册。

• filePath: 需要保存的图片的本地路径，通常是通过 uni.downloadFile 下载后得到的临时路径。
• success: 保存成功后的回调函数。
• fail: 保存失败后的回调函数，返回错误信息。

3. 错误处理

在下载和保存过程中，可能会遇到各种错误，如网络问题、权限问题等。因此，我们在 fail 回调中进行了错误处理，并通过 uni.showToast 提示用户操作失败。

4. 权限问题

在 iOS 和 Android 平台上，保存图片到相册可能需要用户授权。如果用户拒绝授权，uni.saveImageToPhotosAlbum 会失败。因此，在实际应用中，可能需要先检查并请求相册权限。

5. 临时文件路径

通过 uni.downloadFile 下载的文件会存储在临时路径中，应用重启后可能会被清除。因此，如果需要长期保存，建议将文件移动到持久化存储路径。

6. 兼容性

uni.saveImageToPhotosAlbum 在大多数平台上都支持，但在某些平台上可能会有不同的行为或限制，建议在实际开发中进行充分测试。