小程序开放平台

文档中心
基础
界面
网络
数据缓存
媒体
图片
chooseImage
previewImage
getImageInfo
saveImageToPhotosAlbum
compressImage
地图
视频
富文本
位置
开放接口
设备
XHSML
性能
文件
数据分析
画布

xhs.saveImageToPhotosAlbum

开发
>
JS API
>
媒体
>
图片
>
saveImageToPhotosAlbum
>
更新时间:2025-04-10 16:08:15

以Promise风格调用: 支持

保存图片到系统相册

参数

Object object

属性
类型
默认值
必填
说明
filePathstring图片文件路径,可以是临时文件路径或永久文件路径 (本地路径) ,不支持网络路径
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

属性
类型
说明
errMsgstring

实例代码

// 调用 saveImageToPhotosAlbum 保存图片到系统相册
xhs.saveImageToPhotosAlbum({
  filePath: '/path/to/local/image.jpg', // 必填,图片文件路径(本地路径)
  success: (res) => {
    console.log('图片保存成功:', res.errMsg);
  },
  fail: (err) => {
    console.error('图片保存失败:', err.errMsg);
  },
  complete: () => {
    console.log('saveImageToPhotosAlbum 调用结束');
  }
});