支付宝小程序框架 事件·小程序场景值

2020-09-18 10:30 更新

版本需求: 基础库 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 宫格中。例如,蚂蚁森林就是一个受大众喜爱的小程序。

2.png

场景值ID:1000

场景值说明:首页12宫格及更多。

2.小程序收藏

对于喜爱的或常用的小程序,用户可以直接把它加入“小程序收藏”,方便下次打开使用。不过小程序收藏并不是首页的固有应用之一,在每次打开“小程序收藏”时,支付宝都会引导用户将“小程序收藏”添加到首页 12 宫格。

此外,支付宝 App 中的“朋友”tab 顶部,也有一个小程序入口,与“生活号”、“生活圈”并列。

3.png

场景值ID:1002

场景值说明:小程序收藏应用入口,包含朋友 tab 中的入口。

3. 顶部搜索框的搜索结果页

用户可以在支付宝 App 顶部的搜索框检索小程序,在搜索结果页,即可进入小程序。

img

场景值ID:1005

场景值说明:顶部搜索框的搜索结果页。

4. 单人聊天会话中的小程序消息卡片

支付宝的单人聊天会话中可以直接分享支付宝小程序,点击小程序消息卡片即可打开对应支付宝小程序。

img

场景值ID:1007

场景值说明:单人聊天会话中的小程序消息卡片。

5. 扫描二维码

“扫一扫”可以说是所有小程序的核心入口。

1.gif

场景值ID:1011

场景值说明:扫描二维码。

5. 小程序模板消息

开发者可通过消息高效触达用户,通知用户当前行为的结果及状态等;同时可在消息中配置跳转小程序指定页面地址,当用户查看消息时,在消息中点击“进入小程序查看”返回小程序,进入开发者配置的小程序指定页面。img

场景值ID:1014

场景值说明:小程序模版消息(服务提醒)。

7. 生活号

生活号底部菜单栏、自定义菜单栏都会把用户导向小程序。

4.png

场景值ID:1020

场景值说明:生活号 profile 页相关小程序列表。

8.桌面图标

用户可以把支付宝小程序添加到手机桌面。即使用户没有打开支付宝 App,也能直接点击桌面图标打开支付宝小程序。

img

场景值ID:1023

场景值说明:系统桌面图标。

9 . 小程序跳转小程序

用户也可以在一个小程序中打开另外一个小程序。以“城市服务”小程序为例,点击“医疗”可进入“医疗健康”小程序。

同样地,也可以从一个小程序返回另一个小程序。

img

场景值ID:1037 场景值说明:小程序打开小程序。 场景值ID:1038 场景值说明:从另一个小程序返回。

10.长按小程序右上角关闭按钮

长按任意支付宝小程序右上角的关闭按钮,即可唤起最近的小程序使用历史,点击即可跳转接入。

img

场景值ID:1090

场景值说明:长按小程序右上角菜单唤出最近使用历史。

11. 第三方 App 打开

用户也可以从第三方 App(例如:钉钉)打开支付宝小程序。

img

场景值ID:1300

场景值说明:第三方 App(例如:钉钉)打开。

12.支付宝服务频道打开

用户还可以从以下 10 个支付宝服务频道进入小程序:

场景值 场景值说明
1200 城市服务频道
1201 芝麻信用频道
1202 车主服务频道
1203 医疗服务频道
1204 大学生活频道
1205 中小学频道
1206 共享单车频道
1207 保险服务频道
1208 天天有料频道
1209 支付宝会员频道

以“医疗服务频道”和“大学生活频道”为例: img

常见问题

Q:怎么获取跳转小程序链接?

A:需要开发者自己拼接,详情参考文档 小程序跳转 FAQ

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号