功能介绍
使用场景
在既有业务流程中,出现业务方需要用外部浏览器打开外部的 URL的情况,如通过浏览器实现下载文件、打开固定的业务信息界面等。
交互效果
使用此方法时,浏览器打开可信域名的 URL 时,将会向用户弹框来获取用户的许可,界面如下:
管理后台配置页面


用户弹框页面


实现方案
步骤一:配置 H5 可信域名
在应用管理后台 > 安全配置 > H5 可信域名,添加应用需要访问的 URL 的可信域名。
步骤二:调用相关 JSAPI 进行网页开启
接口:ui.openExternalPage
描述:跳转外部浏览器打开设置的 URL。
支持的客户端:iOS、Android、Windows、Mac。
支持版本:3.13.0及以上版本。
是否需要鉴权:需要鉴权
代码示例
wemeet.ui.openExternalPage({url: 'https://xxxxxxxx',success: () => {console.log('openExternalPage success');},fail: (err) => {console.log('openExternalPage canceled', err);}}).catch(err => {console.error('openExternalPage error');})
输入参数
OpenUrlParam 参数
参数名称 | 参数类型 | 参数描述 |
url | String | 需要在 WebView 打开的外部网页的URL,只支持 HTTPS 协议。 |
success | - | 打开网页成功回调函数。 |
fail | - | 打开网页失败回调函数。 |
错误码
错误码 | 说明 |
10 | 参数错误。 |
2006、2007 | 应用已下架。 |
2011 | 跳转链接只支持 HTTPS 协议。 |
2009 | 跳转链接不合法,仅支持可信域名内的链接。 |
20 | 服务异常。 |