目录
兼容性:企业微信 iOS、Android
预览文件
ww.previewFile({
url: 'http://open.work.weixin.qq.com/wwopen/downloadfile/wwapi.zip',
name: 'Android开发工具包集合',
size: 22189
})
属性 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
url | string | 是 | 需要预览文件的地址 可以使用相对路径 | |
size | number | 是 | 需要预览文件的字节大小 | |
name | string | 否 | 需要预览文件的文件名 默认为 URL 的最后部分 | |
success | Function | 否 | 成功回调 | |
fail | Function | 否 | 失败回调 | |
cancel | Function | 否 | 取消回调 | |
complete | Function | 否 | 完成回调 |
Promise<Object>
属性 | 类型 | 必填 | 说明 | |
---|---|---|---|---|
errMsg | string | 是 | 通用错误信息 | |
errCode | number | 是 | 通用错误码 |
本接口将 URL 对应的文件下载后,在内置浏览器中预览。目前支持图片、音频、视频、文档等格式的文件。 从 2.4.6 版本开始,iOS 版企业微信浏览器升级为 WkWebView,企业微信原生层面的网络请求读取不到WKWebview中设置的cookie,即使域名是相同的。 问题说明: 如果页面的资源或图片存储的服务器依赖校验Cookie来返回数据的情况,在切换到WKWebview后,在企业微信内长按保存,或者点击预览文件时,原生层面发起的网络请求将不会完整地带上所设置的Cookie,会导致图片保存失败或预览失败。 适配建议: 建议静态资源cookie free。如果确实有信息需要传递,可通过业务后台存储需要传递的信息,然后给页面一个存储信息相对应的access_token加密码,再通过Url中加入自己业务的access_token进行页面间信息传递。
wx.previewFile({
url: '', // 需要预览文件的地址(必填,可以使用相对路径)
name: '', // 需要预览文件的文件名,必须有带文件格式的后缀,例如.doc(不填的话取url的最后部分,最后部分是个包含格式后缀的文件名)
size: 1048576 // 需要预览文件的字节大小(必填,而且大小必须正确,否则会打开失败)
});