mpx.onAppShow(function listener)

监听小程序切前台事件。该事件与 App.onShow 的回调参数一致。

支持情况： 微信、支付宝、RN、web

参考文档

参数

function listener

小程序切前台事件的监听函数

参数

Object options
启动参数

属性	类型	说明	最低版本	支付宝	RN	web
path	string	启动小程序的路径 (代码包路径)	-	✓	✓	✓
scene	number	启动小程序的场景值	-	✓	✓	✓
query	Record.<string, string>	启动小程序的 query 参数	-	✓	✓	✓
shareTicket	string	shareTicket，详见获取更多转发信息	-	✗	✓	✓
referrerInfo	Object	来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 {}。(参见后文注意)	-	✓	✓
结构属性 类型 说明 支付宝 RN web appId string 来源小程序、公众号或 App 的 appId ✓ ✗ ✗ extraData Object 来源小程序传过来的数据，scene=1037或1038时支持 ✓ ✗ ✗
forwardMaterials	Array.<Object>	打开的文件信息数组，只有从聊天素材场景打开（scene为1173）才会携带该参数	-	✗	✗	✗
结构属性 类型 说明 type string 文件的mimetype类型 name string 文件名 path string 文件路径（如果是webview则是url） size number 文件大小
chatType	number	从微信群聊/单聊打开小程序时，chatType 表示具体微信群聊/单聊类型	-	✗	✗	✗
合法值 说明 1 微信联系人单聊 2 企业微信联系人单聊 3 普通微信群聊 4 企业微信互通群聊
hostExtraData	Object	宿主传递的数据，第三方 app 中运行小游戏时返回	-	✗	✗	✗
结构属性 类型 说明 host_scene string 宿主app对应的场景值
apiCategory	string	API 类别	2.20.0	✓	✗	✗
合法值 说明 支付宝 default 默认类别 ✓ nativeFunctionalized 原生功能化，视频号直播商品、商品橱窗等场景打开的小程序 ✗ browseOnly 仅浏览，朋友圈快照页等场景打开的小程序 ✗ embedded 内嵌，通过打开半屏小程序能力打开的小程序 ✓ chatTool 聊天工具，通过打开聊天工具能力打开的小程序 ✗

示例代码

const onAppShowHandler = (res) => {
  console.log('onAppShow:', res)
};

mpx.onAppShow(onAppShowHandler)