概述:
本文档服务于对接方需要从兔展H5作品内唤起手机App的业务场景,本方案使用微信开放标签中的wx-open-launch-app进行唤起App,详见微信开放标签文档。
提前条件:
- 获取兔展H5作品地址(在工作台作品预览窗口取到作品访问地址),替换域名为renderer.rabbitpre.com,完整地址形如:https://renderer.rabbitpre.com/m2/xxxx。
- 使用前需将「 JS 接口安全域名绑定的服务号」绑定在「移动应用的微信开放平台账号」下,并确保服务号与此开放平台账号同主体且均已认证。
请前往 微信开放平台-管理中心-公众号详情-接口信息 设置域名与所需跳转的移动应用,并放置校验文件(可能需要寻求兔展运维支持)。
需添加的业务域名如下:
注:
绑定域名和移动应用
- 绑定域名的要求:
- 域名须为当前服务号的 JS 安全域名
- 域名只能同时绑定一个移动应用,因此须确保域名未被其他移动应用绑定
- 绑定移动应用的要求
- 只能绑定同一微信开放平台账号下审核通过的移动应用
- 绑定次数
- 每月可修改绑定3次
我需要准备什么?
- 本授权功能需接入方企业先在兔展营销云开通 “数据集成” 模块,并获得 “自建应用” 的使用权限。
- 自建应用内申请开通 编辑器 → H5跳转APP,后续联系管理员审核通过。应用配置界面如下:
添加后,点击“编辑”进入对应设置页: - 配置对应APP名称,APPID,唤起APP失败时IOS和安卓系统的跳转地址。
额外信息:提供给APP进行使用的数据,若需要添加当前作品的地址,则数据格式为 {{当前作品地址}}。 - 编辑器制作作品时,添加带触发功能的组件(按钮、图片、形状、文字等),在设置面板触发选项卡下进行配置,具体配置如下:
- 若APP中需要作品中的动态参数,可以打开对应的开关。
- 作品保存后,当用户点击配置了跳转APP的按钮时,即可发起唤起APP。
跳转按钮唤起APP的流程
extinfo数据:
接入方可以使用微信开放平台提供的方法获取跳转携带的extinfo。 App获取开放标签<wx-open-launch-app>中的extinfo数据
// 兔展H5唤起APP所抛出的extinfo const extinfo = { // 动态参数,需在编辑器中开启 [key]: {}, // 额外信息 在自建应用中自定义的数据 additionalMessage: "{{当前作品地址}},额外信息", // 当前作品地址 address: "https://renderer.rabbitpre.com/m2/xxxx", }