场景值
2021年1月12日
场景值用来描述用户进入小程序的路径。
相关信息
由于 Android 系统限制，目前还无法获取到按 Home 键退出到桌面，然后从桌面再次进小程序的场景值，对于这种情况，会保留上一次的场景值。
获取场景值
开发者可以通过下列方式获取场景值:
- 对于小程序，可以在 App 的
onLaunch和onShow，或wx.getLaunchOptionsSync中获取上述场景值。 - 对于小游戏，可以在
wx.getLaunchOptionsSync和wx.onShow中获取上述场景值
场景值列表
| 场景值 ID | 说明 |
|---|---|
| 1000 | 其他 |
| 1001 | 发现栏小程序主入口，「最近使用」列表(基础库 2.2.4 版本起包含「我的小程序」列表) |
| 1005 | 微信首页顶部搜索框的搜索结果页 |
| 1006 | 发现栏小程序主入口搜索框的搜索结果页 |
| 1007 | 单人聊天会话中的小程序消息卡片 |
| 1008 | 群聊会话中的小程序消息卡片 |
| 1010 | 收藏夹 |
| 1011 | 扫描二维码 |
| 1012 | 长按图片识别二维码 |
| 1013 | 扫描手机相册中选取的二维码 |
| 1014 | 小程序模板消息 |
| 1017 | 前往小程序体验版的入口页 |
| 1019 | 微信钱包(微信客户端 7.0.0 版本改为支付入口) |
| 1020 | 公众号 profile 页相关小程序列表(已废弃) |
| 1022 | 聊天顶部置顶小程序入口(微信客户端 6.6.1 版本起废弃) |
| 1023 | 安卓系统桌面图标 |
| 1024 | 小程序 profile 页 |
| 1025 | 扫描一维码 |
| 1026 | 发现栏小程序主入口，「附近的小程序」列表 |
| 1027 | 微信首页顶部搜索框搜索结果页「使用过的小程序」列表 |
| 1028 | 我的卡包 |
| 1029 | 小程序中的卡券详情页 |
| 1030 | 自动化测试下打开小程序 |
| 1031 | 长按图片识别一维码 |
| 1032 | 扫描手机相册中选取的一维码 |
| 1034 | 微信支付完成页 |
| 1035 | 公众号自定义菜单 |
| 1036 | App 分享消息卡片 |
| 1037 | 小程序打开小程序 |
| 1038 | 从另一个小程序返回 |
| 1039 | 摇电视 |
| 1042 | 添加好友搜索框的搜索结果页 |
| 1043 | 公众号模板消息 |
| 1044 | 带 shareTicket 的小程序消息卡片 详情 |
| 1045 | 朋友圈广告 |
| 1046 | 朋友圈广告详情页 |
| 1047 | 扫描小程序码 |
| 1048 | 长按图片识别小程序码 |
| 1049 | 扫描手机相册中选取的小程序码 |
| 1052 | 卡券的适用门店列表 |
| 1053 | 搜一搜的结果页 |
| 1054 | 顶部搜索框小程序快捷入口(微信客户端版本 6.7.4 起废弃) |
| 1056 | 聊天顶部音乐播放器右上角菜单 |
| 1057 | 钱包中的银行卡详情页 |
| 1058 | 公众号文章 |
| 1059 | 体验版小程序绑定邀请页 |
| 1064 | 微信首页连 Wi-Fi 状态栏 |
| 1067 | 公众号文章广告 |
| 1068 | 附近小程序列表广告(已废弃) |
| 1069 | 移动应用 |
| 1071 | 钱包中的银行卡列表页 |
| 1072 | 二维码收款页面 |
| 1073 | 客服消息列表下发的小程序消息卡片 |
| 1074 | 公众号会话下发的小程序消息卡片 |
| 1077 | 摇周边 |
| 1078 | 微信连 Wi-Fi 成功提示页 |
| 1079 | 微信游戏中心 |
| 1081 | 客服消息下发的文字链 |
| 1082 | 公众号会话下发的文字链 |
| 1084 | 朋友圈广告原生页 |
| 1088 | 会话中查看系统消息，打开小程序 |
| 1089 | 微信聊天主界面下拉，「最近使用」栏(基础库 2.2.4 版本起包含「我的小程序」栏) |
| 1090 | 长按小程序右上角菜单唤出最近使用历史 |
| 1091 | 公众号文章商品卡片 |
| 1092 | 城市服务入口 |
| 1095 | 小程序广告组件 |
| 1096 | 聊天记录，打开小程序 |
| 1097 | 微信支付签约原生页，打开小程序 |
| 1099 | 页面内嵌插件 |
| 1100 | 红包封面详情页打开小程序 |
| 1102 | 公众号 profile 页服务预览 |
| 1103 | 发现栏小程序主入口，「我的小程序」列表(基础库 2.2.4 版本起废弃) |
| 1104 | 微信聊天主界面下拉，「我的小程序」栏(基础库 2.2.4 版本起废弃) |
| 1106 | 聊天主界面下拉，从顶部搜索结果页，打开小程序 |
| 1107 | 订阅消息，打开小程序 |
| 1113 | 安卓手机负一屏，打开小程序(三星) |
| 1114 | 安卓手机侧边栏，打开小程序(三星) |
| 1119 | 【企业微信】工作台内打开小程序 |
| 1120 | 【企业微信】个人资料页内打开小程序 |
| 1121 | 【企业微信】聊天加号附件框内打开小程序 |
| 1124 | 扫“一物一码”打开小程序 |
| 1125 | 长按图片识别“一物一码” |
| 1126 | 扫描手机相册中选取的“一物一码” |
| 1129 | 微信爬虫访问 详情 |
| 1131 | 浮窗打开小程序 |
| 1133 | 硬件设备打开小程序 详情 |
| 1135 | 小程序 profile 页其他小程序列表，打开小程序 |
| 1146 | 地理位置信息打开出行类小程序 |
| 1148 | 卡包-交通卡，打开小程序 |
| 1150 | 扫一扫商品条码结果页打开小程序 |
| 1152 | 订阅号视频打开小程序 |
| 1153 | “识物”结果页打开小程序 |
| 1154 | 朋友圈内打开“单页模式” |
| 1155 | “单页模式”打开小程序 |
| 1157 | 服务号会话页打开小程序 |
| 1158 | 群工具打开小程序 |
| 1167 | H5 通过开放标签打开小程序 详情 |
| 1169 | 发现栏小程序主入口，各个生活服务入口(例如快递服务、出行服务等) |
返回来源信息的场景
部分场景值下还可以获取来源应用、公众号或小程序的 appId。获取方式请参考对应 API 的参考文档。
| 场景值 | 场景 | appId 含义 |
|---|---|---|
| 1020 | 公众号 profile 页相关小程序列表 | 来源公众号 |
| 1035 | 公众号自定义菜单 | 来源公众号 |
| 1036 | App 分享消息卡片 | 来源 App |
| 1037 | 小程序打开小程序 | 来源小程序 |
| 1038 | 从另一个小程序返回 | 来源小程序 |
| 1043 | 公众号模板消息 | 来源公众号 |