apiCloud中的API對象

1.屬性

appId

apiready = function () {
        var appId = api.appId; //比如： A6980386445546
        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://協議對應的真實目錄，字符串類型

    }

2.常量
參考官方文檔http://docs.apicloud.com/Client-API/api#c1

3.事件

apiready = function() {
        api.addEventListener({
            name: 'batterylow' // 設備電池電量低事件，字符串類型
        }, function(ret, err) {
            if (ret) {
                alert(JSON.stringify(ret));
            } else {
                alert(JSON.stringify(err));
            }
        });

        api.addEventListener({
            name: 'batterystatus' // 設備電池狀態改變事件，如電量變化或正在充電，字符串類型
        }, function(ret, err) {
            if (ret) {
                alert(JSON.stringify(ret));
            } else {
                alert(JSON.stringify(err));
            }
        });

//        api.addEventListener({
//            name: 'keyback' // 設備 back 鍵被點擊事件，僅 Android 平台有效，字符串類型
//        }, function(ret, err) {
//            alert('按了返回鍵');
//        });
//
//        api.addEventListener({
//            name: 'keymenu' // 設備 menu 鍵被點擊事件，僅 Android 平台有效
//        }, function(ret, err) {
//            alert('按了菜單鍵');
//        });
//
//        api.addEventListener({
//            name: 'volumeup' // 設備音量加鍵被點擊事件，僅 Android 平台有效
//        }, function(ret, err) {
//            alert('按了音量加鍵');
//        });


        api.addEventListener({
            name:'offline' // 斷網了
        }, function(ret, err){
            alert('斷網了');
        });

        api.addEventListener({
            name:'online' // 已經連上網絡
        }, function(ret, err){
            alert('已連接到網絡');
        });

        api.addEventListener({
            name:'scrolltobottom', // 滑動到最底事件
            extra:{
                threshold:0            //設置距離底部多少距離時觸發，默認值為0，數字類型
            }
        }, function(ret, err){
            alert('已滾動到底部');
        });

        api.addEventListener({
            name:'shake' // 搖一搖
        }, function(ret, err){
            alert('觸發了搖一搖事件');
        });

//        api.addEventListener({
//            name:'swipedown'
//        }, function(ret, err){
//            alert('向下輕掃');
//        });

        api.addEventListener({
            name:'swipeleft'
        }, function(ret, err){
            alert('向左輕掃');
        });

        api.addEventListener({
            name:'swiperight'
        }, function(ret, err){
            alert('向右輕掃');
        });

//        api.addEventListener({
//            name:'swipeup'
//        }, function(ret, err){
//            alert('向上輕掃');
//        });

        api.addEventListener({
            name:'tap'
        }, function(ret, err){
            alert('點擊了頁面');
        });

        api.addEventListener({
            name:'longpress'
        }, function(ret, err){
            alert('長按了頁面');
        });

//            api.addEventListener({
//                name:'viewappear'
//            }, function(ret, err){
//                alert('window顯示');
//            });

    }

4.方法
參考官方http://docs.apicloud.com/Client-API/api#c1