开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
基础 api
基础
应用级事件
界面
跳转
多媒体
图片
旧版接口(停止更新)
视频
音频
录音
lottie 动画
相机
缓存
文件
位置
网络
设备
worker
数据安全
分享
收藏
自定义通用菜单
更新管理
web-view组件控制
升级支付宝最新版本
隐私信息授权
小程序广告
开放能力 api
开发 > api > 基础 api > 多媒体 > 图片 > my.saveimagetophotosalbum
评论 (3)
收藏
我的文档
设置

my.saveimagetophotosalbum(object object)

基础库  或更高版本; 若版本较低,建议采取 兼容处理

支小宝客户端 支持

安诊儿客户端 支持

小程序开发者工具: 不支持。请以真机的调试结果为准。

主体: 企业支付宝小程序个人支付宝小程序

保存图片到系统相册

object object

查看示例

属性 类型 默认值 必填 兼容性 描述
filepath string - -

图片文件路径,支持网络地址、本地临时文件本地缓存文件本地用户文件代码包文件、图片 base64 数据的
注意:

  • 安卓、ios 从 10.5.20 开始支持代码包路径文件,ios 从 10.2.70 开始支持本地缓存文件、本地用户文件
  • 客户端 10.1.60 开始支持 data url(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(object object)
提示用户开启相册权限
success 回调参数
fail 回调参数
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": "没有开启相册权限"
}
  • bug
    ios:10.5.50 以下的版本,入参 filepath 为 .gif 文件,且为本地用户文件时会报错,错误码为 17。
  • tip
    入参 filepath 使用网络图片时,请带上图片的真实后缀,否则在部分安卓系统中会出现图片后缀名错误的情况。
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图