企业内部开发
小程序
基础
连接微信
办公
JS-SDK
基础
连接微信
办公
企业内部开发
客户端API
JS-SDK
文件
预览文件
预览文件
最后更新:2025/03/27

目录

  • ww.previewFile(params)
  • 功能描述
  • 参数说明
  • params: Object
  • 返回说明
  • 使用说明
  • 旧版jweixin调用
  • 示例代码
  • ww.previewFile(params)

    兼容性:企业微信 iOS、Android

    功能描述

    预览文件

    ww.previewFile({
      url: 'http://open.work.weixin.qq.com/wwopen/downloadfile/wwapi.zip',
      name: 'Android开发工具包集合',
      size: 22189
    })

    参数说明

    params: Object

    属性类型必填说明
    urlstring

    需要预览文件的地址

    可以使用相对路径

    sizenumber

    需要预览文件的字节大小

    namestring

    需要预览文件的文件名

    默认为 URL 的最后部分

    successFunction

    成功回调

    failFunction

    失败回调

    cancelFunction

    取消回调

    completeFunction

    完成回调

    返回说明

    Promise<Object>

    属性类型必填说明
    errMsgstring

    通用错误信息

    errCodenumber

    通用错误码

    使用说明

    本接口将 URL 对应的文件下载后,在内置浏览器中预览。目前支持图片、音频、视频、文档等格式的文件。 从 2.4.6 版本开始,iOS 版企业微信浏览器升级为 WkWebView,企业微信原生层面的网络请求读取不到WKWebview中设置的cookie,即使域名是相同的。 问题说明: 如果页面的资源或图片存储的服务器依赖校验Cookie来返回数据的情况,在切换到WKWebview后,在企业微信内长按保存,或者点击预览文件时,原生层面发起的网络请求将不会完整地带上所设置的Cookie,会导致图片保存失败或预览失败。 适配建议: 建议静态资源cookie free。如果确实有信息需要传递,可通过业务后台存储需要传递的信息,然后给页面一个存储信息相对应的access_token加密码,再通过Url中加入自己业务的access_token进行页面间信息传递。

    旧版jweixin调用

    示例代码

    wx.previewFile({
        url: '', // 需要预览文件的地址(必填,可以使用相对路径)
        name: '', // 需要预览文件的文件名,必须有带文件格式的后缀,例如.doc(不填的话取url的最后部分,最后部分是个包含格式后缀的文件名)
        size: 1048576 // 需要预览文件的字节大小(必填,而且大小必须正确,否则会打开失败)
    });
    上一篇语音转文字
    下一篇从会话选择文件
      本节内容
    服务端API
    基础
    连接微信
    办公
    会议
    会议统计管理
    客户端API
    小程序
    基础
    连接微信
    办公
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们