my.savefile(object object)
此 api 已停止维护,推荐使用 filesystemmanager.savefile,历史接入此 api 的小程序不受影响。
基础库 或更高版本; 且 支付宝客户端 10.1.32 或更高版本; 若版本较低,建议采取 兼容处理 。
主体: 企业支付宝小程序 、 个人支付宝小程序
相关文档: filesystemmanager.savefile 、 本地临时文件 、 本地缓存文件
将临时文件保存为本地缓存文件。
临时文件一般会在退出小程序后删除,而本地缓存文件则不会被删,除非用户从“我的小程序”删除当前小程序,或者开发者调用 my.removesavedfile 等 api 主动删除。
object object
查看示例
属性 | 类型 | 默认值 | 必填 | 描述 |
---|---|---|---|---|
apfilepath | string | - | 是 | 要保存的 本地临时文件 路径 |
success | function | - | 否 | 调用成功的回调函数 |
fail | function | - | 否 | 调用失败的回调函数 |
complete | function | - | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
success 回调函数
参数
object res
查看示例
属性 | 类型 | 描述 |
---|---|---|
apfilepath | string | 保存后的 本地缓存文件 |
fail 回调的参数为 object,error
属性为错误码,errormessage
属性为错误消息。
错误码 | 错误消息 | 凯发app官方网站的解决方案 |
---|---|---|
2 | apfilepath 参数为空。 |
请传入非空的 apfilepath。 |
12 | 文件不存在。 |
请确保传入的 apfilepath 是有效的本地临时文件路径。 |
13 | 文件保存失败。 |
发生未知错误,请重试或放弃操作。 |
19 | 文件存储大小限制为 10m。 |
请传入 10m 以下的临时文件。支付宝客户端 10.3.80 以下版本会报此错,建议提示用户更新支付宝客户端。 |
10028 | 文件夹超过 200m |
my.savefile({
apfilepath: 'xxx', // 本地临时文件路径
success: function (res) {
console.log(res);
},
fail: function (err) {
console.log(err);
}
});
q:通过 my.savefile 保存的文件能否在系统中找到?
my.savefile 保存的本地缓存文件为虚拟路径,只能通过小程序 api 访问。如果是图片文件,可以使用 my.saveimagetophotosalbum 保存然后在系统相册中找到。