mt.onShow(function listener)

监听小程序切到前台事件。

支持情况

项	说明
兼容性	部分兼容

参数

function listener

事件触发时执行的回调函数。

参数	类型	说明
scene	number	启动场景值（见下表）
query	Object	启动参数（已解析为 key-value 对象）
referrerInfo	Object	来源信息，从其他小程序跳转时有值
referrerInfo.appId	string	来源小程序的 appId
isRestored	boolean	是否为从后台恢复（而非全新启动）

scene 常用取值

值	说明
1000	默认场景（直接启动）
10034	支付成功后拉起
10035	支付失败后拉起

说明

• 可多次调用，每次注册一个独立回调（多播）。
• 取消监听须调用 mt.offShow 并传入注册时使用的同一函数引用；不传参时不会取消任何监听。

示例代码

mt.onShow((res) => {
  console.log('场景值：', res.scene)
  console.log('启动参数：', res.query)
  console.log('是否后台恢复：', res.isRestored)
  if (res.referrerInfo) {
    console.log('来源 appId：', res.referrerInfo.appId)
  }
})

与微信差异

• 回调参数缺少微信的 shareTicket 字段（美团小游戏不支持分享票据）。
• 回调参数缺少微信的顶层 chatType 字段（微信文档 chatType 是顶层字段，非 referrerInfo 子字段）。
• 回调参数缺少微信 referrerInfo.extraData 子字段。
• 新增 isRestored 字段（微信无此字段），用于区分全新启动与从后台恢复。