tencent cloud

腾讯云超级应用服务

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

Download
聚焦模式
字号
最后更新时间: 2026-08-26 10:42:18

功能概述

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

接口说明

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

返回当前处于前台、正在展示的那一个小程序/小游戏实例。若 superapp 此时没有正在展示的小程序,该接口返回 nil
// 获取当前正在运行的小程序对象
// @return TMFMiniAppInfo 小程序信息 - mini program information
- (TMFMiniAppInfo *)currentApplet;
可以根据返回的小程序对象,与指定小程序的 appid 比对,判断指定小程序是否在运行,示例:
TMFMiniAppInfo *currentApplet =
[[TMFMiniAppSDKManager sharedInstance] currentApplet];

// appId变量 为业务侧待判断的小程序 appid
BOOL isCurrentRunning = [currentApplet.appId isEqualToString:appId];

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

runningAppletList 返回当前所有尚未销毁的小程序和小游戏,包括正在运行和处于保活状态的实例。
// 获取目前未销毁的小程序列表(包括正在运行以及保活中的小程序/小游戏)
// @return 小程序数组<TMFMiniAppInfo> - Mini program array<TMFMiniAppInfo>
- (NSArray<TMFMiniAppInfo *> *)runningAppletList;
可通过 TMFMiniAppInfo 的 appType 属性区分小程序和小游戏:

NSArray<TMFMiniAppInfo *> *runningList =
[[TMFMiniAppSDKManager sharedInstance] runningAppletList];

NSMutableArray<TMFMiniAppInfo *> *miniAppList = [NSMutableArray array];
NSMutableArray<TMFMiniAppInfo *> *miniGameList = [NSMutableArray array];

// 根据 appType 筛选正在运行或保活的小程序
for (TMFMiniAppInfo *appInfo in runningList) {
if (appInfo.appType == TMAAppTypeApp) {
[miniAppList addObject:appInfo];
}
}

// 根据 appType 筛选正在运行或保活的小游戏
for (TMFMiniAppInfo *appInfo in runningList) {
if (appInfo.appType == TMAAppTypeGame) {
[miniGameList addObject:appInfo];
}
}


帮助和支持

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

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

文档反馈