apiCloud中的API对象

apiready = function () {
        var appId = api.appId;            //比如： A56325632516
        var appName = api.appName;        //比如： AppLoader
        var appVersion = api.appVersion;  // 比如： 1.0.0
        var systemType = api.systemType;  // 比如： ios
        var systemVersion = api.systemVersion;  // 比如： 8.0
        var deviceModel = api.deviceModel;     // 比如： iPhone 5
        var operator = api.operator;  // 比如：中国移动
        var connectionType = api.connectionType;  //比如： wifi
        var fullScreen = api.fullScreen;  // 比如： true
        var screenWidth = api.screenWidth;  // 比如： 640
        var screenHeight = api.screenHeight;  // 比如： 960
        var winName = api.winName;  //比如： root
        var winWidth = api.winWidth;  // 比如： 320 此属性值不同于屏幕的分辨率，比如 iPhone 5 的分辨率为 640*1136，但是其 winWidth 为 320，因此前端需根据 winWidth 和 winHeight 来进行布局
        var winHeight = api.winHeight;  // 比如： 568
        var frameName = api.frameName;  //比如： trans-con
        var frameWidth = api.frameWidth;  // 比如： 320,若当前环境为 window 中，则值和 winWidth 相同
        var frameHeight = api.frameHeight;  // 比如： 504,若当前环境为 window 中，则值和 winHeight 相同
        var pageParam = api.pageParam; //比如： {"name" : "tans-con"} JSON用于获取页面间传递的参数值，为 openWin()、openFrame() 等方法中的 pageParam 参数对应值
        var wgtParam = api.wgtParam;  //比如： {"name": "API Demo"},用于获取 widget 间传递的参数值，为 openWidget() 方法中的 wgtParam 参数对应值
        var appParam = api.appParam; // 比如： appLoader,当应用被第三方应用打开时，传递过来的参数，字符串类型
        var statusBarAppearance = api.statusBarAppearance; // 比如： true,当前应用状态栏是否支持沉浸式效果，布尔类型
        var wgtRootDir = api.wgtRootDir; //widget: //协议对应的真实目录，即 widget 网页包的根目录，字符串类型
        var fsDir = api.fsDir; //fs: //协议对应地真实目录，字符串类型
        var cacheDir = api.cacheDir; //cache://协议对应的真实目录，字符串类型
        var boxDir = api.boxDir; box://协议对应的真实目录，字符串类型
//iOS上面在应用Documents下，安卓上面在系统为app分配的沙箱下，root或者越狱的手机可看到。
       var debug = api.debug;    // 比如： true  获取config.xml配置的debug字段的值。
      var channel = api.channel;   //如：Apple App Store 渠道号，字符串类型
    }

Event

apiready = function() {
     //batterylow 设备电池电量低事件，字符串类型
      api.addEventListener({
      name: 'batterylow'
}, function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});
   //batterystatus 设备电池状态改变事件，如电量变化或正在充电，字符串类型
   api.addEventListener({
    name: 'batterystatus'
}, function(ret, err) {
    if (ret) {
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});
  //keyback  设备 back 键被点击事件，仅 Android 平台有效
   api.addEventListener({
       name: 'keyback'
   }, function(ret, err) {
       alert('按了返回键');
   });
   //keyCode:0                //被点击的按键
   // longPress:false            //是否是长按

 //keymenu 设备 menu 键被点击事件，仅 Android 平台有效
  api.addEventListener({
      name: 'keymenu'
  }, function(ret, err) {
      alert('按了菜单键');
  });
    //keyCode:0                //被点击的按键
    //ongPress:false            //是否是长按

  //volumeup 设备音量加键被点击事件，仅 Android 平台有效
  api.addEventListener({
      name: 'volumeup'
   }, function(ret, err) {
      alert('按了音量加键');
   });
  //volumedown  设备音量减键被点击事件，仅 Android 平台有效
   api.addEventListener({
      name:'volumedown'
  }, function(ret, err){        
      alert('按了音量减键');
  });
 //offline 监听设备断开网络的事件，字符串类型
  api.addEventListener({
      name:'offline'
   }, function(ret, err){        
      alert('断网了');
   });
 //online  监听设备连接到网络的事件，字符串类型
  api.addEventListener({
      name:'online'
  }, function(ret, err){        
      alert('已连接到网络');
   });

//scrolltobottom Window 或者 Frame 页面滑动到底部事件，可用于实现滚动到底部，加载更多功能
  api.addEventListener({
    name:'scrolltobottom',
    extra:{
        threshold:0            //设置距离底部多少距离时触发，默认值为0，数字类型
    }
}, function(ret, err){        
    alert('已滚动到底部');
});

//shake  设备摇动事件，字符串类型。设置该监听后，当前 APP 将立即开启摇动检测功能。可用于实现摇一摇功能

api.addEventListener({
    name:'shake'
}, function(ret, err){        
   alert('触发了摇一摇事件');
});

//takescreenshot 应用在前台运行期间，用户屏幕截图事件（比如同时按下了 home 键和电源键），只支持 iOS。
api.addEventListener({
    name:'takescreenshot'
}, function(ret, err){        
   alert('用户截屏了');
});
//swipedown Window 或者 Frame 的页面全局向下轻扫事件，字符串类型
api.addEventListener({
    name:'swipedown'
}, function(ret, err){        
   alert('向下轻扫');
});

//swipeleft  Window 或者 Frame 的页面全局向左轻扫事件，字符串类型
api.addEventListener({
    name:'swipeleft'
}, function(ret, err){        
   alert('向左轻扫');
});
//swiperight  Window 或者 Frame 的页面全局向右轻扫事件，字符串类型
api.addEventListener({
    name:'swiperight'
}, function(ret, err){        
   alert('向右轻扫');
});

//swipeup Window 或者 Frame 的页面全局向上轻扫事件，字符串类型
api.addEventListener({
    name:'swipeup'
}, function(ret, err){        
   alert('向上轻扫');
});
//tap   Window 或者 Frame 的页面全局单击事件，字符串类型。监听该事件后，点击 window 或者 frame 的任意位置，都将收到 tap 回调。
api.addEventListener({
    name:'tap'
}, function(ret, err){        
   alert('点击了页面');
});
//longpress  Window 或者 Frame 的页面全局长按事件，字符串类型。
  api.addEventListener({
    name:'longpress'
}, function(ret, err){        
   alert('长按了页面');
});
 //viewappear  Window 显示到屏幕的事件，字符串类型。收到 viewappear 事件回调，即标识当前 Window 已经动画结束，并且完全显示到屏幕上。该事件的作用对象为 Window，Frame 的显示不会收到事件

api.addEventListener({
    name:'viewappear'
}, function(ret, err){        
   alert('window显示');
});
//viewdisappear Window 离开屏幕的事件


//noticeclicked 状态栏通知被用户点击后的回调，字符串类型
api.addEventListener({
    name:'noticeclicked'
},function(ret,err){
    alert(ret.value);
});
//smartupdatefinish 云修复使用静默修复时，更新完毕事件。可通过监听此事件来通知用户做是否强制重启应用等操作或者提示，以使更新生效，字符串类型   如果是提示修复，则不会触发该事件
api.addEventListener({
    name:'smartupdatefinish'
}, function(ret, err){        
    alert('云修复完成');
});
//launchviewclicked 启动页被用户点击后的回调，字符串类型
api.addEventListener({
    name:'launchviewclicked'
},function(ret,err){
    api.alert({
        msg:ret.value
    });
});

// 
}