appUtils

来自于:开发者立即使用

概述

页面管理模块,可实现应用在后台运行时打开应用页面。

模块接口

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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(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) {
   alert(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本