tencent cloud

腾讯云超级应用服务

获取当前正在运行的小程序

下载
聚焦模式
字号
最后更新时间: 2026-08-25 17:25:44

功能概述

从2.4.3版本起,SDK 对外提供运行状态查询接口,superapp 可据此判断指定小程序是否正在运行,或获取当前正在运行的小程序/小游戏列表,用于多开管理、任务切换等场景。
注意:
仅支持主进程调用。

接口说明

判断指定小程序是否正在运行

/**
* 判断指定小程序是否正在运行
*
* @param appId 小程序 ID
* @param appVerType 版本类型,需与启动时一致(MiniApp.TYPE_ONLINE 等)
* @return true 表示正在运行
*/
public static boolean isMiniAppRunning(String appId, int appVerType)
示例:
boolean running = TmfMiniSDK.isMiniAppRunning("wx1234567890abcdef", MiniApp.TYPE_ONLINE);

获取当前正在运行的小程序/小游戏列表

/**
* 获取当前正在运行的小程序/小游戏列表
*
* @param engineType 引擎类型,null 表示获取全部
* @return 运行中的 MiniApp 列表,可能为 null
*/
public static List<MiniApp> getRunningAppList(MiniEngineType engineType)

MiniEngineType

枚举值
含义
MiniApp
小程序
MiniGame
小游戏
示例:
// 获取全部(小程序 + 小游戏)
List<MiniApp> all = TmfMiniSDK.getRunningAppList(null);
// 仅获取运行中的小游戏
List<MiniApp> games = TmfMiniSDK.getRunningAppList(MiniEngineType.MiniGame);

注意事项

仅支持主进程调用;
getRunningAppList 返回的列表可能为 null,使用时需判空;
isMiniAppRunningappVerType 需与启动时一致;
返回的 MiniApp 为查询时刻的运行快照,实时性要求高的场景请按需刷新。


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈