[JS API]Total Control强大脚本功能之设备控制接口:应用程序

Total Control 有强大的脚本功能，提供了很多应用程序相关的 JS API,之前我们介绍了通过脚本实现手机软件的打开，关闭，安装，卸载功能，下面我们就来介绍TC 提供的其他的跟应用程序相关的接口。
（一）getActivity()：获取当前前台运行的activity
参数：无
返回值：字符串：成功返回activity值，失败返回null。
示例：打开QQ音乐，并在前台运行，然后获取QQ音乐的Activity
代码如下：
//获取当前主控设备对象
var device =Device.getMain();
if(!device) {
print("没有找到设备");
} else {
//获得前台运行的 activity
var ret = device.getActivity();
print("前台运行的 activity是： \n"+ret);
}

运行结果：
//成功获取当前前台运行的activity，则输出：
前台运行的activity是：
com.tencent.qqmusic/com.tencent.qqmusic.activity.LoginActivity
//如果没有获得当前前台运行的 activity，则输出错误信息lastError();
（二）openActivity(activity,administrator)：打开指定的activity
参数：
activity：activity字符串
administrator：是否获取超级权限
返回值：布尔类型:成功返回true，失败返回false。
示例：
//获取当前设备对象
var device =Device.getMain();
//打开activity"com.tencent.qqmusic/com.tencent.qqmusic.activity.AppStarterActivity"，设备打开activity不需要root权限，所以administrator设置false
var ret =device.openActivity("com.tencent.qqmusic/com.tencent.qqmusic.activity.AppStarterActivity",false);
if(ret == true){
print("成功打开指定的activity");
} else {
print("打开指定的activity失败");
}

运行结果：
//成功打开activity则输出:
成功打开指定的activity
//打开activity失败则输出:
打开指定的activity失败
（三）isAppForeground(packageName)：判断指定应用程序是否正在前台运行
参数：packageName：字符串，App 包名称
返回值：整型：如果在前台运行，返回 0，否则返回非 0，此时可通过lastError() 函数获取具体的错误信息。
示例：
//获取当前主控设备对象
var device =Device.getMain();
//判断"com.android.phone"是否正在前台运行
var ret=device.isAppForeground("com.android.phone");
if(ret != 0) {
print(lastError());
} else {
print("指定的软件正在前台运行");
}

运行结果：
//指定app正在前台运行则输出以下内容，否则输出错误信息
指定的软件正在前台运行
（四）getInstalledAPKList()：获取当前设备上已经安装的所有apk名
参数：无。
返回值：字符串数组: 成功返回当前手机上安装的所有APK名，以数组形式表示，失败则返回空集合，此时可通过 lastError() 函数获取具体的错误信息。
示例：
//获取当前主控设备对象
var device =Device.getMain();
print("当前手机安装的所有APK有: \n");
//获得当前手机安装的所有APK名
var ret=device.getInstalledAPKList();
//用for循环遍历数组中的APK名，并输出APK名
for(vari=0;i<ret.length;i++){
print(ret[i]);
}

运行结果：
当前手机安装的所有APK有:
com.qualcomm.wfd.service
com.android.stk
com.skyworth.skyclientcenter
com.android.backupconfirm
org.codeaurora.ims
com.huawei.android.internal.app
com.huawei.gamebox
com.ludashi.benchmark
com.android.location.fused
com.wukongtv.wkremote.client
com.huawei.bd
com.vlife.huawei.wallpaper