appUtils

Method

概述

页面管理插件，可实现应用在后台运行时打开应用页面。

插件接口

bringAppToFront

调取页面到前台

bringAppToFront({params}, callback(ret))

parameter

packageName

类型：字符串类型
描述：（可选）需要打开的应用包名
默认：自己应用包名

pageName

类型：字符串类型
描述：（可选）需要打开的页面，需要是全路径。设置此参数时必须设置packageName，此页面名称为andriod原生页面名称，例：com.api.test.TestActivity
默认：打开应用首页

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true                //布尔类型；true/状态良好，false/参考err查看错误信息
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.bringAppToFront({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

stopPageManager

关闭页面管理者。

stopPageManager({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true                //布尔类型；true/状态良好，false/参考err查看错误信息
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.stopPageManager({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

openStart

开机启动,设置为开机自动启动需要手机授权开机自动启动权限。

openStart({params}, callback(ret))

parameter

bootOpenStart：

类型：布尔类型
描述：是否开机启动

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true                //布尔类型；true/状态良好，false/参考err查看错误信息
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.openStart({
bootOpenStart:true,
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

getApps

获取手机应用

getApps({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true                //布尔类型；true/状态良好，false/参考err查看错误信息
    appS:[                        //JSON数组类型；获取到的手机所有应用
    {
       packageName:'',             //字符串类型；应用包名
       mainActivityName:'',      //字符串类型；应用主页面
       isSystemApp:,                   //布尔类型；是否为系统应用
    },
    
    ]
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.getApps({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

moveAppToBack

应用退到后台

moveAppToBack({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true                //布尔类型；true/状态良好，false/参考err查看错误信息

}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.moveAppToBack({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

getStateViewHeight

获取状态栏高度

getStateViewHeight({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true                //布尔类型；true/状态良好，false/参考err查看错误信息
    height:,                     //数字类型；状态栏高度，获取不到返回-1

}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.getStateViewHeight({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

getBottomViewHeight

获取底部虚拟按键高度

getBottomViewHeight({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true                //布尔类型；true/状态良好，false/参考err查看错误信息
    height:,                     //数字类型；状态栏高度，没有虚拟按键返回-1

}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.getBottomViewHeight({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

toEvaluate

跳转应用市场评价

toEvaluate({params}, callback(ret))

parameter

packageName

类型：字符串类型
描述：（可选项）应用市场包名，如果不填写则自动搜索手机应用市场，含有多个应用市场则调用系统选择框

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true                //布尔类型；true/状态良好，false/参考err查看错误信息
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.toEvaluate({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

getInstallAppStores

获取已安装的应用市场

getInstallAppStores({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/状态良好，false/参考err查看错误信息
    stores:[                       //JSON数组；返回已安装应用市场信息
    { packageName:'',        //字符串类型；应用市场包名
      appName:''.               //字符串类型；应用名称
      versionCode:,            //数字类型；应用版本号
      versionName:'',        //字符串类型；应用版本
    },
    ]
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.getInstallAppStores({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

addShortcut

创建快捷方式

addShortcut({params}, callback(ret))

parameter

shortName

类型：字符串类型
描述：快捷方式名称

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/状态良好，false/参考err查看错误信息
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.addShortcut({
shortName:'',
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

addFloadWindow

添加悬浮框

addFloadWindow({params}, callback(ret))

parameter

rect：

类型：JSON对象
描述：（可选项）显示控件位置
内部字段：

{
   x:,       //数字类型；控件左上角x坐标；默认值：0
   y:,      //数字类型；控件左上角y坐标；默认值：0
   w:,     //数字类型；控件宽；默认值：50
   h:,     //数字类型；控件高；默认值：50
}

text：

类型：JSON对象
描述：（可选项）悬浮框内文字设置
内部字段：

{
  content:'',      //字符串类型；文字内容
  size:,               //数字类型；文字大小；默认：14
  color:'',          //字符串类型；文字颜色；默认：‘#000000’
  leftMargin:,  //数字类型；左边距；默认：0
}

background：

类型：JSON对象
描述：（可选项）背景颜色；默认白色
内部字段：

{
  color:'',      //字符串类型；背景颜色，支持rgb，rgba
  image:'',    //字符串类型；背景图片路径，支持widget，fs；此参数有效时color无效
}

move：

类型：布尔类型
描述：（可选项）是否可拖动；
默认值：true

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/状态良好，false/参考err查看错误信息
    action:'',                  //字符串类型；事件；取值范围：‘open’/打开，‘click’/点击，‘move’/移动
    location:{               //JSON对象；左上角当前位置，仅action为move时返回
    x:,                            //数字类型；x坐标
    y:,                           //数字类型；y坐标
    }
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.addFloadWindow({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

removeFloadWindow

移除悬浮框

removeFloadWindow({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/状态良好，false/参考err查看错误信息
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.removeFloadWindow({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

checkFloadPermission

检测悬浮框权限，权限未开启则只能在应用内显示

checkFloadPermission({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/状态良好，false/参考err查看错误信息
    permission:,              //布尔类型；是否已获取悬浮框权限
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.checkFloadPermission({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

setGpsListener

添加gps开关监听

setGpsListener({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/打开，false/关闭
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.setGpsListener({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

getGpsStatus

获取gps状态

getGpsStatus({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/打开，false/关闭
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.getGpsStatus({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

checkNotificationPermission

检查通知权限

checkNotificationPermission({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/打开，false/关闭
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.checkNotificationPermission({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

gotoAppDetail

跳转应用详情页面，可进行权限设置

gotoAppDetail({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/打开，false/关闭
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.gotoAppDetail({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

gotoSysSetPage

跳转系统设置页面

gotoSysSetPage({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/打开，false/关闭
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.gotoSysSetPage({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

getDeviceInfo

获取设备信息

getDeviceInfo({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/成功，false/失败，详情剪err返回msg
    info:{                           //JSON对象类型；设备信息
        device:'',                //字符串类型；设备参数
        model:'',                //字符串类型；版本
        product:'',              //字符串类型；设备厂商
        cpuAbi:'',                //字符串类型；设备cpuabi
         cpuAbi2:'',                //字符串类型；设备cpuabi2
         sdkVersion:'',         //数字类型；设备sdk版本号
    }
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.getDeviceInfo({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

getDeviceDbm

获取设备信号

getDeviceDbm({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/成功，false/失败，详情剪err返回msg
    dbms:[{                           //JSON数组类型；设备信息
        type:'',                       //字符串类型；信号类型
        value:,                        //数字类型；信号强度
    },]
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.getDeviceDbm({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

getScreenSize

获取屏幕宽高

getScreenSize({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/成功，false/失败，详情剪err返回msg
    width:,                        //数字类型；屏幕宽，单位px
    height:,                      //数字类型；屏幕高，单位px
    density :                   //小数类型；屏幕像素密度
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.getScreenSize({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

getSimInfo

获取sim卡信息

getSimInfo({params}, callback(ret))

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/成功，false/失败，详情剪err返回msg
    phoneNumber:'',       //字符串类型；手机号
    operatorName:'',       //字符串类型；网络运营商名字
    networkOperator:'' ,    //字符串类型；跨国网络运营商
    networkCountroy:'',      //字符串类型；网络运营商国家代码
    simCountroy:'',               //字符串类型；sim卡运营商国家代码
    simOperatorName:'',      //字符串类型；sim卡运营商名字
    simNo:'',                           //字符串类型；sim卡序列号
    operator:'',                        //字符串类型；sim卡MNC号
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.getSimInfo({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

isSystemApp

判断是否为系统应用

isSystemApp({params}, callback(ret))

parameter

packageName：

类型：字符串类型
描述：（可选项）需要查询应用包名
默认：本应用包名

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/是系统应用，false/不是系统应用，详情剪err返回msg
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.isSystemApp({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

getSignature

获取应用签名

getSignature({params}, callback(ret))

parameter

packageName：

类型：字符串类型
描述：（可选项）需要查询应用包名
默认：本应用包名

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/成功，false/失败，详情剪err返回msg
    sha1:'',                      //字符串类型；签名SHA1值
    md5:'',                      //字符串类型；签名md5值
    sha256:'',                  //字符串类型；签名sha256值
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.getSignature({
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

setWallpaper

设置壁纸

setWallpaper({params}, callback(ret))

parameter

imgPath：

类型：字符串类型
描述：壁纸图片地址；支持widget以及fs路径

callback(ret)

ret：

类型：JSON 对象
内部字段：

{
    status:true,                //布尔类型；true/成功，false/失败，详情剪err返回msg
}

err：

类型：JSON 对象
内部字段：

{
msg:'',                        //字符串类型；错误信息
}

示例代码

var appUtils = api.require('appUtils');
appUtils.setWallpaper({
imgPath:'',
}, function(ret, err) {
   api.alert({msg: JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

installApk

安装应用包

installApk({params}, callback(ret))

parameter

apkPath：

类型：字符串类型
描述：apk路径；支持fs路径

示例代码

var appUtils = api.require('appUtils');
appUtils.installApk({
apkPath:'',
});

可用性

Android系统

可提供的1.0.0及更高版本

unInstallApk

卸载应用

unInstallApk({params}, callback(ret))

parameter

packageName：

类型：字符串类型
描述：需要卸载的应用包名

示例代码

var appUtils = api.require('appUtils');
appUtils.unInstallApk({
packageName:'',
});

可用性

Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？请保持联络！

最后更新于 2024/11/18