支付宝小程序跳转第三方H5页面
Posted stupid_muscleman
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了支付宝小程序跳转第三方H5页面相关的知识,希望对你有一定的参考价值。
支付宝小程序跳转第三方H5页面
基础API跳转
web-view
支付宝小程序想要跳转H5页面,之前只用过 web-view,内嵌H5,这种方式需要配置域名白名单,并且在外链域名的根目录放置校验文件,H5不是自有页面的话,就不能这样去实现。
<web-view
src="https://render.alipay.com/p/s/web-view/index"
onMessage="onmessage">
</web-view>
my.ap.openURL
相对于 web-view,还有一种跳转H5的方式, my.ap.openURL,不需要配置域名,但是非支付宝官网页面只有部分符合开放类目的小程序可以使用,且需要到开放平台配置 openURL 白名单。已知目标页面的 URL 或 scheme,可以使用 my.ap.openURL。
跳转到支付宝官方 H5 页面是不需要配置白名单的。
- https://render.alipay.com/p/ 开头的 URL。
- https://ds.alipay.com/?scheme= 开头的 URL。
my.ap.openURL(
// 请将 url 替换为后台加白过的跳转地址
url: 'https://please.replace.me/page',
success: (res) => console.log('openURL success'),
fail: (err) => my.alert( title: 'openURL fail: ' + JSON.stringify(err) )
);
web-view 和 my.ap.openURL 两者比较
两者都有不同的权限要求,下面是从文档拷过来的优劣对比表格,可以对照着选用合适的方式。
跳转方式 | 优势 | 劣势 |
---|---|---|
内嵌H5页面,使用 web-view 内嵌H5 | 流量归属于小程序本身。不限行业,无需审批。可以在H5页面上调用部分小程序的接口能力。 | 需要完成 H5域名配置 |
外跳H5页面,使用 my.ap.openURL 外跳H5 | 无需H5域名配置。可以免审跳转支付宝官方H5运营页面。 | 流量不再归属于小程序本身。跳转到非支付宝官方页面只针对部分行业开放,并且需要完成平台侧审批流程(官方H5运营页面无此限制)。 |
my.ap.navigateToAlipayPage
my.ap.navigateToAlipayPage 是用于跳转到支付宝官方业务或运营活动页面的 API。这里利用不需要配置白名单的域名和scheme语法可以实现跳转。
// 支付宝客户端的标准scheme为:alipays://platformapi/startapp?appId=H5App自身的appId
// 但如果是某些运营页之类的单独页面,没有自己的appId,
// 可以使用Nebula容器的通用浏览器模式appId=20000067 来启动,
// 同时将需要打开的H5页面url经过encode编码后设置到url参数内
const url = 'https://www.baidu.com';
// https://render.alipay.com/p/ 不需要配置白名单
// 开了个后门,在不需要配置白名单的链接后面拼上自己的链接
const link = 'https://render.alipay.com/p/s/i/?scheme=' + encodeURIComponent('alipays://platformapi/startapp?appId=20000067&url=' + encodeURIComponent(url));
my.ap.navigateToAlipayPage(
path: link
);
JSAPI跳转
JSAPI 是支付宝钱包提供的丰富的原生API功能,开发者可以使用它们方便调用支付宝提供的各种能力,达到媲美原生应用的体验,如页面跳转,支付功能等。
其中有一个跳转页面的API,pushWindow,用来打开一个新的页面,系统自带转场动画。
注意点
- scheme 跳转请尽量使用 location.href 而不是 pushWindow。用 schema 的方式打开页面已经禁止使用,仅用于向下兼容老业务。
- 与 location.href 的区别,pushWindow 类同于 PC 浏览器的新开标签页,每个 window 都是一个新的标签页,因此原页面仅仅是被压到后台,状态始终保持,JS 也会继续运行。location.href 则是在当前标签页直接跳转。
JSAPI是给H5使用的,而不是支付宝小程序。
现有的功能代码这样使用,应该是因为白名单限制,基础API中的前两种方式都不适合,才被迫使用JSAPI和禁止使用的scheme的。navigateToAlipayPage 是最近新发的文章里才看到可以支持支付宝小程序跳转H5连接(无需添加白名单) 。但是 navigateToAlipayPage 也已经不维护,而是用 openURL 替代。
my.call('pushWindow',
url: `alipays://platformapi/startapp?appId=20000067&url=$encodeURIComponent(
'https://xxxx')`
);
在小程序直接使用https链接会导致页面访问受限,无法打开,用scheme的方式可以跳过限制。但是不应该这么做,只是单纯的记录一下有这种操作。
startApp
需要申请startApp权限,可以跳转任意URL
my.call('startApp',
appId: '20000067',
param:
url: 'https://xxx'
);
总结
综上,跳转方式需具体情况具体分析,选择能力范围内最适合的方式,尽量不要选择禁用和停止维护的方法。这里不讨论支付宝官方页面,对自己人并没有太多限制。
跳转方式 | 适用范围 |
---|---|
web-view | 方便在H5根目录下放置校验文件 |
my.ap.openURL | 在限制类目范围内 |
my.ap.navigateToAlipayPage | 无限制,但是此API已停止维护 |
pushWindow | 无限制,但是pushWindow 禁止使用scheme的方式打开页面 |
startApp | 可以申请到支付宝的startApp权限,很难 |
扩展: 小程序scheme链接介绍
记录一下支付宝小程序的坑
参考技术A我们项目中 由于有个页面链接,没有形成闭环。不能从小程序其他页面跳转过去,只能上线之后通过apli的规格跳过去(卡包中跳转)。
如果前面打开过小程序,触发了onlauch事件,从卡包跳转的时候,只是进入这个页面,不会触发onlaunch事件了。
(其实这个没问题)
主要是开发过程中,我们要去找个页面就 开始通过 扫码 打开。 扫描打开页面都会重启小程序,并打开扫描的页面,都会触发onlaunch事件。
我这里出现的原因是: onlauch事件我会异步获取 userId保存到本地。 在活动页面由于上一期的种种问题,需要onload清空本地数据。
如果打开小程序在 活动页,那么 先触发onlaunch事件,异步获取userId(还没拿到), onload清空本地数据, 这个是拿到了userId. 保存到本地。一切正常。
扫描开发和测试都没发现问题。(扫描活动页,会重新启动小程序)
上线后发现,有保存过小程序的用户,或者直接搜索小程序,进入了首页,触发了onlaunch事件, 异步获取并保存了userId到本地。。。然后从卡包进入活动页,清空本地数据,,,此时之后的流程就有问题了。
解决的办法:
以上是关于支付宝小程序跳转第三方H5页面的主要内容,如果未能解决你的问题,请参考以下文章