基础库 3.27.0 开始支持本方法，这是一个同步方法。

监听复访营销活动状态变更

前提条件	请确认已通过开发者平台控制台中或通过 OpenAPI 创建小程序券模板和小程序营销活动，接入方式详见：侧边栏复访营销
业务背景	无
使用限制	暂不支持抖音开发者工具调试，真机调试请参考小程序线上调试彩蛋
注意事项	该能力需要开发者前置在控制台或通过 openapi 创建复访营销活动，具体申请流程可参考>>小程序券创建流程、小程序营销活动创建流程。在小程序基础库版本 >= 3.32.0 （兼容处理），SceneActivityContext.on 支持回调开发者所有类型复访 “福利” 领取事件以及 “去使用”点击事件
支持沙盒	否
相关教程	无

语法

SceneActivityContext.on(cb)

参数说明

cb

类型	默认值	必填	说明	最低支持版本
function		是	回调函数	3.27.0

cb 是一个回调函数，接收 object 类型的参数，属性如下：

属性名	类型	说明	最低支持版本
eventType	enum	事件类型	3.27.0
data	object	属性	3.27.0

eventType 的合法值

值	说明	最低支持版本
bind	绑定福利	3.27.0
receive	领取福利	3.27.0
autoReceive	复访自动领取	3.32.0
toUse	复访去使用点击	3.32.0

data 类型说明

object 类型，属性如下：

属性名	类型	说明	最低支持版本
welfareId	string	福利id	3.27.0

返回值

无

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

App({
  onLaunch: function () {
    if (tt.canIUse('createSceneActivityContext')) {
      tt.createSceneActivityContext().on((...args) => {
        console.log(...args);
      })
    }
  }
});