全部产品
Search
文档中心

SuperApp:IMiniAppEventObserver

更新时间:Aug 26, 2025

本文主要介绍IMiniAppEventObserver接口作用、使用方法及注意事项

一、接口介绍

IMiniAppEventObserver接口用于监听小程序的生命周期事件

public interface IMiniAppEventObserver {

    void onMiniAppStart(Map<String, Object> params);

    void onMiniAppClose(Map<String, Object> params);

    void onMiniAppShow(Map<String, Object> params);

    void onMiniAppHide(Map<String, Object> params);
}

1.1 onMiniAppStart

  1. 由小程序Activity onCreate(...)方法触发,在主线程执行

  2. params参数包含以下内容:

关键字 "app_code":用户在开放平台创建App时获得的"App Code"

关键字 "mini_app_id":小程序ID

关键字 "mini_app_version":小程序版本

关键字 "timestamp":时间戳

1.2 onMiniAppShow

  1. 由小程序Activity onResume()方法触发,在主线程执行

  2. params参数包含以下内容:

关键字 "app_code":用户在开放平台创建App时获得的"App Code"

关键字 "mini_app_id":小程序ID

关键字 "mini_app_version":小程序版本

关键字 "timestamp":时间戳

1.3 onMiniAppHide

  1. 由小程序Activity onPause()方法触发,在主线程执行

  2. params参数包含以下内容:

关键字 "app_code":用户在开放平台创建App时获得的"App Code"

关键字 "mini_app_id":小程序ID

关键字 "mini_app_version":小程序版本

关键字 "timestamp":时间戳

1.4 onMiniAppClose

  1. 由小程序Activity onDestroy()方法触发,在主线程执行

  2. params参数包含以下内容:

关键字 "app_code":用户在开放平台创建App时获得的"App Code"

关键字 "mini_app_id":小程序ID

关键字 "mini_app_version":小程序版本

关键字 "timestamp":时间戳

二、注册&注销

2.1 创建观察者

private IMiniAppEventObserver mObserver = new IMiniAppEventObserver() {

    @Override
    public void onMiniAppStart(Map<String, Object> params) {

    }

    @Override
    public void onMiniAppClose(Map<String, Object> params) {

    }

    @Override
    public void onMiniAppShow(Map<String, Object> params) {

    }

    @Override
    public void onMiniAppHide(Map<String, Object> params) {

    }
};

2.2 注册

private void registerObserver() {
    PluginEnv.getInstance().getContainerContext().getLifeCycleService()
        .registerMiniAppObserver(mObserver);

}

2.3 注销

private void unregisterObserver() {
    PluginEnv.getInstance().getContainerContext().getLifeCycleService()
        .unregisterMiniAppObserver(mObserver);

}

三、使用案例(数据上报)

【插件开发】小程序数据上报插件开发