一文详解|支付宝小程序跳转(超详细版) |
您所在的位置:网站首页 › 支付宝跳转淘宝失败 › 一文详解|支付宝小程序跳转(超详细版) |
开发过程中经常遇到支付宝小程序跳转的问题,这里总结一下支付宝小程序跳转的常见场景和方式,希望可以对大家有所帮助。 话不多说,上干货! 支付宝小程序跳转可以拆分为三种行为,即: 外部跳转支付宝小程序支付宝小程序内部页面之间跳转支付宝小程序内部跳转到外部一、外部跳转小程序外部跳转小程序场景有很多种,接下来将对其逐一剖析。 1. 二维码跳转小程序二维码跳转小程序分为「小程序码」与「关联普通链接二维码」。 小程序码:商家通过 小程序码(原小程序二维码)可生成跳转自身小程序指定页面二维码,可用于线上线下贴码推广,便捷推广小程序。app.js 中 onLaunch/onShow 启动函数:options.query.key 获取(经验:注意做 热启动和冷启动 兼容处理)。 冷启动:当用户打开未启动过,或者是已经销毁的小程序时,称为冷启动。此时小程序会执行初始化,初始化完成后,会触发 onLaunch 回调函数。热启动:当用户打开已经关闭但仍处于后台运行的小程序时,称为热启动。在这种情况下,小程序并不会被销毁后重启,而仅是从后台切换到前台,此时,onShow 函数会触发,onLaunch 回调函数不会被触发。示例代码App({ onLaunch(options) { my.alert({ content: '启动参数:'+JSON.stringify(options.query.key), }); console.log('query', options.query); console.log('App Launch', options); }, onShow() { console.log('App Show') }})1.2. 关联普通链接二维码适用场景只能通过支付宝首页扫一扫跳转小程序。 参数获取app.js 中 onLaunch/onShow 启动函数:options.query.qrCode 获取(注意做热启动和冷启动兼容处理)。 示例代码onLaunch(options){ my.alert({ title: 'app onLaunch', content: JSON.stringify(options), success: (res) => { //成功处理代码段 }, }); //获取关联普通二维码的码值,放到全局变量qrCode中 if (options.query && options.query.qrCode) { this.qrCode = options.query.qrCode; } }注意:普通关联二维码测试需要先发布配置规则,使用规则自行生成二维码来测试跳转(不要使用配置时的第二步测试二维码测试)。 2. 支付宝 URL Scheme 跳转小程序具体拼接和参数入参/获取可查看 如何跳转小程序(启动参数获取和二维码一致,注意做热启动和冷启动兼容处理)。 H5 页面跳转小程序生活号场景如何跳转小程序支付宝卡包跳转小程序其它 APP/浏览器跳转小程序(适用于钉钉、高德、淘宝、其它三方可跳转 APP、浏览器等)商家会员卡跳转小程序获取参数示例(与小程序码相同)App({ onLaunch(options) { my.alert({content: '启动参数:'+JSON.stringify(options.query.key),}); console.log('query', options.query); console.log('App Launch', options); }, onShow() { console.log('App Show') }})3. 小程序跳转小程序小程序跳转小程序可使用 my.navigateToMiniProgram 接口。 适用场景同主体其它小程序跳转小程序:同主体小程序可直接互跳,无需任何设置。支付宝客户端 10.1.10 及以上版本支持。其它主体小程序跳转小程序:需对方登录支付宝开放平台在 小程序详情页 > 开发服务 > 开发设置 > 基础设置 > 小程序相互跳转 中设置为 允许所有小程序跳转 或 指定小程序跳转。支付宝客户端 10.1.25 及以上版本支持。参数获取在目标小程序的 App.onLaunch()/App.onShow() 启动参数 extraData 中获取数据(注意做热启动和冷启动兼容处理)。 获取示例App({ onLaunch(options) { my.alert({content: '启动参数:'+JSON.stringify(options.extraData.key),}); console.log('query', options.extraData); console.log('App Launch', options); }, onShow() { console.log('App Show') }})4. 其它场景跳转小程序4.1. 模板消息跳转小程序带参详情可查看 模板消息跳转小程序带参。 获取参数由于模板消息的参数是拼接在 path 后面传入,获取参数和小程序页面之间跳转带参一致,在对应页面 Page.onLoad(query) 启动函数 query 中获取。 获取示例代码onLoad(query) { if (query) { my.alert({ content: '启动参数:' + JSON.stringify(query.x) }); }}4.2. 分享链接跳转小程序具体接入使用可查看 小程序自定义分享,这里只说明带参和获取参数。 注意:如果分享的页面依赖上一页跳转时传递的参数做逻辑运算展示,通过分享链接进入该页面需要自行在自定义分享入参中去拼接该参数,否则分享链接不会带上该参数。 带参可以在 onShareAppMessage 的 path 路径参数后拼接自定义参数(参数传递遵循 http get 的传参规则),如:pages/index/index?key1=value1 获取参数path 中的自定义参数可在小程序生命周期的 Page.onLoad(query) 方法中获取,path 路径里不能带根目录 /。 获取示例代码onLoad(query) { if (query) { my.alert({ content: '启动参数:' + JSON.stringify(query.x) }); }}二、小程序内部页面之间跳转小程序内页面之间跳转,小程序提供了路由 API 供开发者根据自己的场景选择对应的路由 API,路由 API 具体使用可查看官网 API 文档,这里只说明带参和获取参数。小程序路由 API 带参和获取参数方式一致。 带参在 URL 入参路径后拼接参数,如:url:"page/index/index?key1=value1&key2=value2"。 获取参数在对应跳转页面的 Page.onLoad(query) 启动函数中 query 获取。 获取示例代码onLoad(query) { if (query) { my.alert({ content: '启动参数:' + JSON.stringify(query.x) }); }}小程序页面路由 API 支持带参跳转情况路由 API 是否支持带参 my.switchTab 不支持 my.reLaunch 支持 my.redirectTo 支持 my.navigateTo 支持 my.navigateBack 不支持 常用场景中可用路由API普通页面之间跳转:my.navigateTo、my.redirectTo、my.reLaunch、my.navigateBack。tab 页面跳转普通页面:my.navigateTo、my.redirectTo、my.reLaunch、my.navigateBack。tab 页面跳转 tab 页面:my.switchTab。普通页面跳转 tab 页面:my.switchTab。小程序页面跳转 web-view 内嵌页面(根据具体跳转的小程序页面选择):my.navigateTo、my.redirectTo、my.reLaunch、my.navigateBack、my.switchTab。web-view 内嵌页面跳转小程序页面(内嵌页面跳转小程序页面也是用的小程序路由 API,根据具体跳转的小程序页面选择):my.navigateTo、my.redirectTo、my.reLaunch、my.navigateBack、my.switchTab。注意:my.navigateTo最多不能超过 10 层页面栈,建议通过 getCurrentPages 方法判断页面栈峰值,超过后用重定向跳转页面。 三、小程序内部跳转小程序外部小程序对外跳有限制条件,以下为具体条件说明。 接口名称 接口描述 my.openCardList 打开支付宝卡包中的“卡”列表 my.openMerchantCardList 打开当前用户领取某个商家的“卡”列表 my.openCardDetail 打开当前用户领取某张卡的详情页 my.openVoucherList 打开支付宝卡包中的“券”列表 my.openMerchantVoucherList 打开当前用户领取某个商户的“券”列表 my.openVoucherDetail 打开当前用户领取某张券的详情页(非口碑券) my.openKBVoucherDetail 打开当前用户领取某张券的详情页(口碑券) my.openTicketList 打开支付宝卡包中的“票”列表 my.openMerchantTicketList 打开当前用户领取某个商家的“票”列表 my.openTicketDetail 打开当前用户领取某张票的详情页 外跳其它小程序。可查看上文 外部跳转小程序-小程序跳转小程序。不支持外跳小程序不支持外跳其它 APP。小程序不支持跳转 AppStore。以上就是关于小程序跳转的所有内容啦,有遗漏的地方大家可以提出来一起探讨~(◕ᴗ◕✿),一起交流进步~ |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |