toBackground

来自于：开发者立即使用

runBackground

概述

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

模块接口

runBackground

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

runBackground(callback(ret))

callback(ret)

ret:

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

示例代码

  1. //使用范例
  2. var isAndroid = (/android/gi).test(navigator.appVersion);//是否是Android系统
  3. if (isAndroid) {
  4.     toBackground = api.require("toBackground");
  5.     toBackground.runBackground(function(ret, err){
  6.         alert(JSON.stringify(ret));
  7.     });
  8. }
  9. //此接口可用于这样的功能：监听Android自带的Back物理按键事件 两秒内连续点击Back键两次 APP进入后台运行，代码如下
  10. var curTime = 0;
  11. api.addEventListener({
  12.     name: 'keyback'
  13. }, function(ret, err) {
  14.     var curSecond = new Date().getSeconds();
  15.     if (Math.abs(curSecond - curTime) > 2) {
  16.         curTime = curSecond;
  17.         api.toast({
  18.             msg: '再按一次返回键进入后台运行',
  19.             duration: 2000,
  20.             location: 'bottom'
  21.         });
  22.     } else {
  23.         var toBackground = api.require('toBackground');
  24.         toBackground.runBackground(function(ret, err){
  25.             alert(JSON.stringify(ret));
  26.         });
  27.     }
  28. });

补充说明

此接口仅支持Android平台

可用性

Android系统

可提供的1.0.0及更高版本