my.saveimagetophotosalbum(object object)
基础库 或更高版本; 若版本较低,建议采取 兼容处理 。
支小宝客户端 支持
安诊儿客户端 支持
小程序开发者工具: 不支持。请以真机的调试结果为准。
主体: 企业支付宝小程序 、 个人支付宝小程序
保存图片到系统相册
object object
查看示例
属性 | 类型 | 默认值 | 必填 | 兼容性 | 描述 |
---|---|---|---|---|---|
filepath | string | - | 是 | - | 图片文件路径,支持网络地址、本地临时文件、本地缓存文件、本地用户文件、代码包文件、图片 base64 数据的
|
hidetoast | boolean | false | 否 | ios 支付宝: 10.3.70 android 支付宝: 10.2.18 |
保存成功时不展示 toast 提示 |
success | function | - | 否 | - | 调用成功的回调函数 |
fail | function | - | 否 | - | 调用失败的回调函数 |
complete | function | - | 否 | - | 调用结束的回调函数(调用成功、失败都会执行) |
fail 回调的参数为 object,error
属性为错误码,errormessage
属性为错误消息。
错误码 | 错误消息 | 凯发app官方网站的解决方案 |
---|---|---|
15 | 没有开启相册权限。 | 可使用 my.showauthguide 传入 authtype: 'photo' 引导用户开启相册权限。 |
no storage write permission. | 引导用户在系统设置中为支付宝开启存储写入权限。 |
|
16(ios only) | 手机相册存储空间不足。 |
可在交互中考虑这种情况,提示用户存储空间不足。 |
2 | 接口参数无效。 |
请检查 filepath 参数是否有效。 |
17 | 保存图片失败。 |
一般情况下由于 filepath 的值不符合要求导致,请检查 filepath 值是否正确合理。 |
2001 | 用户不允许授权。 |
用户拒绝为当前小程序授权。 请在交互中考虑此情况。如有需要,请向用户强调该授权的必要性。 |
2002 | 用户拒绝为当前小程序授权,并勾选了“总是保持以上选择”后,再次调用授权接口产生的报错。 |
如有需要,提醒或引导用户手动授权:小程序右上角胶囊按钮->设置->打开权限开关;或者通过调用 my.opensetting 帮助用户打开设置页面。 |
2003 | 用户勾选了不允许授权选项。 |
如有需要,提醒或引导用户手动授权:小程序右上角胶囊按钮->设置->打开权限开关;或者通过调用 my.opensetting 帮助用户打开设置页面。 |
my.saveimagetophotosalbum ({
filepath: 'https://gw.alipayobjects.com/zos/skylark-tools/public/files/66539db61b570eb2b7cf2df4241ea56c.png',
success (res) {
console.log (res);
},
fail (err) {
console.log (err);
},
});
// 网络地址图片
my.saveimagetophotosalbum ({
filepath: 'https://gw.alipayobjects.com/zos/skylark-tools/public/files/66539db61b570eb2b7cf2df4241ea56c.png',
success (res) {
console.log ('saveimagetophotosalbum 调用成功', res);
},
fail (err) {
console.log ('saveimagetophotosalbum 调用失败', err);
const platform = my.env.platform;
if (err.error === 15) {
// 提示用户开启相册权限
if (platform === 'ios') {
my.showauthguide ({
authtype: 'photo',
complete (res) {
if (res.shown) {
console.log ('已展示权限引导');
} else {
console.error('保存图片失败: ', '请在系统设置中为支付宝并开启相册权限', json.stringify(err));
}
},
});
} else if (platform === 'android') {
console.error('保存图片失败: ', '请在系统设置找到支付宝应用并开启文件和多媒体写入权限', json.stringify(err));
}
}
},
});
{
"success": true
}
{
"error": 15,
"errormessage": "没有开启相册权限"
}
-
bugios:10.5.50 以下的版本,入参 filepath 为 .gif 文件,且为本地用户文件时会报错,错误码为 17。
-
tip入参 filepath 使用网络图片时,请带上图片的真实后缀,否则在部分安卓系统中会出现图片后缀名错误的情况。