支付宝小程序框架 事件·小程序场景值
版本需求: 基础库 1.10.0 开始支持,低版本需做兼容处理。
场景值用于描述用户进入小程序的路径。
由于 Android 系统限制,目前还无法获取到按 Home 键退出到桌面,然后从桌面再次进小程序的场景值,对于这种情况,会保留上一次的场景值。
获取场景值
开发者可以在 App 的 onLaunch 和 onShow 方法传入的 options.scene 中获取场景值。
场景值列表
场景值ID | 场景值说明 |
---|---|
1000 | 首页12宫格及更多 |
1002 | 小程序收藏应用入口,包含朋友tab中的入口 |
1005 | 顶部搜索框的搜索结果页 |
1007 | 单人聊天会话中的小程序消息卡片 |
1011 | 扫描二维码 |
1014 | 小程序模版消息(服务提醒) |
1020 | 生活号 profile 页相关小程序列表 |
1023 | 系统桌面图标 |
1037 | 小程序打开小程序 |
1038 | 从另一个小程序返回 |
1090 | 长按小程序右上角菜单唤出最近使用历史 |
1200 | 城市服务频道 |
1201 | 芝麻信用频道 |
1202 | 车主服务频道 |
1203 | 医疗服务频道 |
1204 | 大学生活频道 |
1205 | 中小学频道 |
1206 | 共享单车频道 |
1207 | 保险服务频道 |
1208 | 天天有料频道 |
1209 | 支付宝会员频道 |
1300 | 第三方 APP(如钉钉)打开,在跳转链接中传入访问来源参数:chInfo=ch_orderCenter,跳转链接拼接方法参考文档 小程序跳转 FAQ。 |
0000 | 待确认的场景 |
示例代码
App({
onLaunch(options) {
console.log('App onLaunch Scene:', options.scene);//options.scene 是 String 类型的
},
onShow(options) {
console.log('App onShow Scene:', options.scene);
},
})
场景图示
1. 首页12宫格及更多用户可以调整支付宝 App 首页 12 宫格中的应用,将自己常用的小程序放置在 12 宫格中。例如,蚂蚁森林就是一个受大众喜爱的小程序。
场景值ID:1000
场景值说明:首页12宫格及更多。
2.小程序收藏
对于喜爱的或常用的小程序,用户可以直接把它加入“小程序收藏”,方便下次打开使用。不过小程序收藏并不是首页的固有应用之一,在每次打开“小程序收藏”时,支付宝都会引导用户将“小程序收藏”添加到首页 12 宫格。
此外,支付宝 App 中的“朋友”tab 顶部,也有一个小程序入口,与“生活号”、“生活圈”并列。
场景值ID:1002
场景值说明:小程序收藏应用入口,包含朋友 tab 中的入口。
3. 顶部搜索框的搜索结果页
用户可以在支付宝 App 顶部的搜索框检索小程序,在搜索结果页,即可进入小程序。
场景值ID:1005
场景值说明:顶部搜索框的搜索结果页。
4. 单人聊天会话中的小程序消息卡片
支付宝的单人聊天会话中可以直接分享支付宝小程序,点击小程序消息卡片即可打开对应支付宝小程序。
场景值ID:1007
场景值说明:单人聊天会话中的小程序消息卡片。
5. 扫描二维码
“扫一扫”可以说是所有小程序的核心入口。
场景值ID:1011
场景值说明:扫描二维码。
5. 小程序模板消息
开发者可通过消息高效触达用户,通知用户当前行为的结果及状态等;同时可在消息中配置跳转小程序指定页面地址,当用户查看消息时,在消息中点击“进入小程序查看”返回小程序,进入开发者配置的小程序指定页面。
场景值ID:1014
场景值说明:小程序模版消息(服务提醒)。
7. 生活号
生活号底部菜单栏、自定义菜单栏都会把用户导向小程序。
场景值ID:1020
场景值说明:生活号 profile 页相关小程序列表。
8.桌面图标
用户可以把支付宝小程序添加到手机桌面。即使用户没有打开支付宝 App,也能直接点击桌面图标打开支付宝小程序。
场景值ID:1023
场景值说明:系统桌面图标。
9 . 小程序跳转小程序
用户也可以在一个小程序中打开另外一个小程序。以“城市服务”小程序为例,点击“医疗”可进入“医疗健康”小程序。
同样地,也可以从一个小程序返回另一个小程序。
场景值ID:1037 场景值说明:小程序打开小程序。 场景值ID:1038 场景值说明:从另一个小程序返回。
10.长按小程序右上角关闭按钮
长按任意支付宝小程序右上角的关闭按钮,即可唤起最近的小程序使用历史,点击即可跳转接入。
场景值ID:1090
场景值说明:长按小程序右上角菜单唤出最近使用历史。
11. 第三方 App 打开
用户也可以从第三方 App(例如:钉钉)打开支付宝小程序。
场景值ID:1300
场景值说明:第三方 App(例如:钉钉)打开。
12.支付宝服务频道打开
用户还可以从以下 10 个支付宝服务频道进入小程序:
场景值 | 场景值说明 |
---|---|
1200 | 城市服务频道 |
1201 | 芝麻信用频道 |
1202 | 车主服务频道 |
1203 | 医疗服务频道 |
1204 | 大学生活频道 |
1205 | 中小学频道 |
1206 | 共享单车频道 |
1207 | 保险服务频道 |
1208 | 天天有料频道 |
1209 | 支付宝会员频道 |
以“医疗服务频道”和“大学生活频道”为例:
常见问题
Q:怎么获取跳转小程序链接?
A:需要开发者自己拼接,详情参考文档 小程序跳转 FAQ。