全部產品
Search
文件中心

SuperApp:IMiniAppEventObserver

更新時間:Aug 27, 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);

}

三、使用案例(資料上報)

【外掛程式開發】小程式資料上報外掛程式開發