uni.saveImageToPhotosAlbum(options)
保存图片到系统相册
saveImageToPhotosAlbum 兼容性
Web | 微信小程序 | Android | iOS |
x | 4.41 | 3.9 | 4.11 |
参数
名称 | 类型 | 必填 | 默认值 | 兼容性 | 描述 |
options | SaveImageToPhotosAlbumOptions | 是 | - | - | - |
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 | filePath | string.ImageURIString | 是 | - |
Web
|
微信小程序
|
Android
|
iOS
| - | 4.41 | - | - |
| 图片文件路径,可以是临时文件路径也可以是永久文件路径,不支持网络图片路径 | success | (callback: SaveImageToPhotosAlbumSuccess) => void | 否 | - |
Web
|
微信小程序
|
Android
|
iOS
| - | 4.41 | - | - |
| 接口调用成功的回调函数 | fail | (callback: IMediaError) => void | 否 | - |
Web
|
微信小程序
|
Android
|
iOS
| - | 4.41 | - | - |
| 接口调用失败的回调函数 | complete | (callback: any) => void | 否 | - |
Web
|
微信小程序
|
Android
|
iOS
| - | 4.41 | - | - |
| 接口调用结束的回调函数(调用成功、失败都会执行) |
|
SaveImageToPhotosAlbumSuccess 的属性值
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
path | string | 是 | - |
Web
|
微信小程序
|
Android
|
iOS
| - | 4.41 | - | - |
| 保存到相册的图片路径 |
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
errCode | number | 是 | - | - | 错误码 |
合法值 | 兼容性 | 描述 | 1101001 | - | 用户取消 | 1101002 | - | urls至少包含一张图片地址 | 1101003 | - | 文件不存在 | 1101004 | - | 图片加载失败 | 1101005 | - | 未获取权限 | 1101006 | - | 图片或视频保存失败 | 1101007 | - | 图片裁剪失败 | 1101008 | - | 拍照或录像失败 | 1101009 | - | 图片压缩失败 | 1101010 | - | 其他错误 |
|
errSubject | string | 是 | - | - | 统一错误主题(模块)名称 |
data | any | 否 | - | - | 错误信息中包含的数据 |
cause | Error | 否 | - | - | 源错误信息,可以包含多个错误,详见SourceError |
errMsg | string | 是 | - | - | - |
示例
hello uni-app x
该 API 不支持 Web,请运行 hello uni-app x 到 App 平台体验
参见
通用类型
GeneralCallbackResult
名称 | 类型 | 必备 | 默认值 | 兼容性 | 描述 |
errMsg | string | 是 | - |
Web
|
微信小程序
|
Android
|
iOS
| - | 4.41 | - | - |
| 错误信息 |