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

淩亂°似流年 2022-10-23 08:28 60阅读 0赞

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