toBackground

来自于:开发者立即使用

概述

Android App一键进入后台运行,进入后台后用户可通过任务栏重新进入界面,且保留应用原来的界面。该接口可用于监听Android自带的Back物理按键事件,两秒内连续点击Back键两次,APP进入后台运行。

模块接口

runBackground

Android App一键进入后台运行,进入后台后用户可通过任务栏重新进入界面,且保留应用原来的界面。

runBackground(callback(ret))

callback(ret)

ret:

  • 类型:JSON对象
  • 描述:返回是否进入后台成功
  • 内部字段:
{
        "status": true, //true or false
    }

示例代码

//使用范例
var isAndroid = (/android/gi).test(navigator.appVersion);//是否是Android系统
if (isAndroid) {
    toBackground = api.require("toBackground");
    toBackground.runBackground(function(ret, err){
        alert(JSON.stringify(ret));
    });
}
//此接口可用于这样的功能:监听Android自带的Back物理按键事件 两秒内连续点击Back键两次 APP进入后台运行,代码如下
var curTime = 0;
api.addEventListener({
    name: 'keyback'
}, function(ret, err) {
    var curSecond = new Date().getSeconds();
    if (Math.abs(curSecond - curTime) > 2) {
        curTime = curSecond;
        api.toast({
            msg: '再按一次返回键进入后台运行',
            duration: 2000,
            location: 'bottom'
        });
    } else {
        var toBackground = api.require('toBackground');
        toBackground.runBackground(function(ret, err){
            alert(JSON.stringify(ret));
        });
    }
});

补充说明

此接口仅支持Android平台

可用性

Android系统

可提供的1.0.0及更高版本