更新时间:2024-01-22 10:13:20收藏我的文档设置返回文档1、用户路径展示2、插件集成说明2.1)订阅“本地生活商品插件”开放后台订购●登入进入对应小程序详情页,点击对应小程序,进入【插件服务】菜单:●点击订购其他插件后跳转到订购插件页面,搜索【本地生活商品插件】并完成订阅。服务市场订购●通过后台,进入【服务市场】-【开发者资源】;●搜索并选择【本地生活商品插件】;●进行【本地生活商品插件】订购。2.2)集成“本地生活商品插件”支持“静态加载”、“懒加载模式加载”和“动态加载”三种模式集成,更多内容可参考支付宝插件接入文档。●静态加载模式下仅支持一个小程序最多关联 10 个插件;当小程序少于10个静态插件时,推荐使用懒加载模式加载;●动态加载无插件个数限制。2.2.1)普通静态加载兼容规则插件的运行要求小程序基础库为 1.22.4 及以上版本,支付宝客户端 10.1.85 及以上的版本。若不满足请将以下代码放到小程序app.js文件中;// app.jsif (!my.caniuse('plugin') && !my.iside) { my.ap && my.ap.updatealipayclient && my.ap.updatealipayclient(); // 如果动态加载不可用则打开支付宝客户端升级界面}app({ onlaunch() {}, onshow() {},});app.json配置{ "plugins": { "grouppurchaseoucherplugin": { "version": "*", // 目前只支持设置 * ,自动选择版本 "provider": "插件id" }, }}页面配置通过 relaunchapi 进行跳转,这样才会有凯发k8官方网娱乐官方首页的icon的显示。(若使用 navigatetoapi只会有返回箭头icon)my.relaunch({ url: `plugin://grouppurchaseoucherplugin/index?outitemid=${outitemid}` // outitemid为外部商品id});2.2.2)懒加载模式加载兼容规则使用懒加载模式的小程序项目支持 ide 3.0.0 及以上版本编译构建。懒加载模式插件的运行小程序支持基础库 2.7.18 及以上版本,如不符合建议请 。appjson配置// 使用静态懒加载{ "plugins": { "grouppurchaseoucherplugin": { "lazy": true, // 开启懒加载模式 "version": "*", // 目前只支持设置 * ,自动选择版本 "provider": "2021003190661263" } }, // 配置懒加载插件预加载 "preloadrule": { "pages/index/index": { // 这里路径为需要加载插件的本地小程序页面路径 "network": "all", "plugins": ["grouppurchaseoucherplugin"] } }}页面配置通过 relaunchapi 进行跳转,这样才会有凯发k8官方网娱乐官方首页的icon的显示。(若使用 navigatetoapi只会有返回箭头icon)my.relaunch({ url: `plugin://grouppurchaseoucherplugin/index?outitemid=${outitemid}` // outitemid为外部商品id});2.2.3)动态加载appjson配置{ "usedynamicplugins": true}页面配置通过 relaunchapi 进行跳转,这样才会有凯发k8官方网娱乐官方首页的icon的显示。(若使用 navigatetoapi只会有返回箭头icon)page({ data: { }, onload() { }, navtopluginpage() { // 跳转到插件页面,index为插件plugin.json中对外暴露的页面 my.relaunch({ url: `dynamic-plugin://插件id/index?outitemid=${outitemid}` // outitemid为外部商品id }); },});2.3) 公域到小程序插件地址●outitemid:外部商品id●orderid:订单号id●encodeuricomponent为jsapi,链接中page后的内容需要url编码●链接暂不支持拼接商家埋点规则:alipays://platformapi/startapp?appid=宿主a&page=${encodeuricomponent(plugin-private://插件a/页面?outitemid=${outitemid})}商品详情页:alipays://platformapi/startapp?appid=宿主小程序appid&page=${encodeuricomponent(plugin-private://插件id/pages/index/index?outitemid=${outitemid})}订单详情页:alipays://platformapi/startapp?appid=宿主小程序appid&page=${encodeuricomponent(plugin-private://插件id/pages/orderdetail/orderdetail?orderid=${orderid})}2.4)开发环境联调说明(非必须流程)1)第一步:需提供appid给支付宝插件技术小二,进行添加开发环境配置2)第二步:在支付宝开放平台小程序插件服务的插件联调中确认授权,实现在开发环境进行联调2.5)首次进入插件处理登入逻辑若宿主小程序在首次进入插件的时候需要强验证登入逻辑,可以在在宿主小程序的onlaunch钩子里提供方法const plugin = requireplugin('myplugin')const login = () => { // ...处理登入验证逻辑 验证后才可转到插件}plugin.setappnavigater(() => { login()})若要支持从支付宝公域到插件也支持登入逻辑则在宿主小程序onshow钩子里也需要提供方法。app({ onlaunch() { // 第一次打开 // options.query == {number:1} // console.log(options); // console.info('app onlaunch'); // 处理登入逻辑 }, onshow() { // 从后台被 scheme 重新打开 // options.query == {number:1} // console.log(options); // 处理登入逻辑 },});2.6)“去小程序使用”链接规则链接是在创建本地生活商品时写入,需根据以下url规则配置:url格式alipays://platformapi/startapp?appid=[appid]&page=[page]&query=[query]跳非宿主/跳宿主非宿主跳转:支持最小传appid,page、query可不传,默认跳凯发k8官方网娱乐官方首页;跳宿主:支持最小传appid和page, query可不传,跳指定页面;query的获取getlaunchoptionssync参考文档