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
1 apiready = function() { 2 //batterylow 设备电池电量低事件,字符串类型 3 api.addEventListener({ 4 name: 'batterylow' 5 }, function(ret, err) { 6 if (ret) { 7 alert(JSON.stringify(ret)); 8 } else { 9 alert(JSON.stringify(err)); 10 } 11 }); 12 //batterystatus 设备电池状态改变事件,如电量变化或正在充电,字符串类型 13 api.addEventListener({ 14 name: 'batterystatus' 15 }, function(ret, err) { 16 if (ret) { 17 alert(JSON.stringify(ret)); 18 } else { 19 alert(JSON.stringify(err)); 20 } 21 }); 22 //keyback 设备 back 键被点击事件,仅 Android 平台有效 23 api.addEventListener({ 24 name: 'keyback' 25 }, function(ret, err) { 26 alert('按了返回键'); 27 }); 28 //keyCode:0 //被点击的按键 29 // longPress:false //是否是长按 30 31 //keymenu 设备 menu 键被点击事件,仅 Android 平台有效 32 api.addEventListener({ 33 name: 'keymenu' 34 }, function(ret, err) { 35 alert('按了菜单键'); 36 }); 37 //keyCode:0 //被点击的按键 38 //ongPress:false //是否是长按 39 40 //volumeup 设备音量加键被点击事件,仅 Android 平台有效 41 api.addEventListener({ 42 name: 'volumeup' 43 }, function(ret, err) { 44 alert('按了音量加键'); 45 }); 46 //volumedown 设备音量减键被点击事件,仅 Android 平台有效 47 api.addEventListener({ 48 name:'volumedown' 49 }, function(ret, err){ 50 alert('按了音量减键'); 51 }); 52 //offline 监听设备断开网络的事件,字符串类型 53 api.addEventListener({ 54 name:'offline' 55 }, function(ret, err){ 56 alert('断网了'); 57 }); 58 //online 监听设备连接到网络的事件,字符串类型 59 api.addEventListener({ 60 name:'online' 61 }, function(ret, err){ 62 alert('已连接到网络'); 63 }); 64 65 //scrolltobottom Window 或者 Frame 页面滑动到底部事件,可用于实现滚动到底部,加载更多功能 66 api.addEventListener({ 67 name:'scrolltobottom', 68 extra:{ 69 threshold:0 //设置距离底部多少距离时触发,默认值为0,数字类型 70 } 71 }, function(ret, err){ 72 alert('已滚动到底部'); 73 }); 74 75 //shake 设备摇动事件,字符串类型。设置该监听后,当前 APP 将立即开启摇动检测功能。可用于实现摇一摇功能 76 77 api.addEventListener({ 78 name:'shake' 79 }, function(ret, err){ 80 alert('触发了摇一摇事件'); 81 }); 82 83 //takescreenshot 应用在前台运行期间,用户屏幕截图事件(比如同时按下了 home 键和电源键),只支持 iOS。 84 api.addEventListener({ 85 name:'takescreenshot' 86 }, function(ret, err){ 87 alert('用户截屏了'); 88 }); 89 //swipedown Window 或者 Frame 的页面全局向下轻扫事件,字符串类型 90 api.addEventListener({ 91 name:'swipedown' 92 }, function(ret, err){ 93 alert('向下轻扫'); 94 }); 95 96 //swipeleft Window 或者 Frame 的页面全局向左轻扫事件,字符串类型 97 api.addEventListener({ 98 name:'swipeleft' 99 }, function(ret, err){ 100 alert('向左轻扫'); 101 }); 102 //swiperight Window 或者 Frame 的页面全局向右轻扫事件,字符串类型 103 api.addEventListener({ 104 name:'swiperight' 105 }, function(ret, err){ 106 alert('向右轻扫'); 107 }); 108 109 //swipeup Window 或者 Frame 的页面全局向上轻扫事件,字符串类型 110 api.addEventListener({ 111 name:'swipeup' 112 }, function(ret, err){ 113 alert('向上轻扫'); 114 }); 115 //tap Window 或者 Frame 的页面全局单击事件,字符串类型。监听该事件后,点击 window 或者 frame 的任意位置,都将收到 tap 回调。 116 api.addEventListener({ 117 name:'tap' 118 }, function(ret, err){ 119 alert('点击了页面'); 120 }); 121 //longpress Window 或者 Frame 的页面全局长按事件,字符串类型。 122 api.addEventListener({ 123 name:'longpress' 124 }, function(ret, err){ 125 alert('长按了页面'); 126 }); 127 //viewappear Window 显示到屏幕的事件,字符串类型。收到 viewappear 事件回调,即标识当前 Window 已经动画结束,并且完全显示到屏幕上。该事件的作用对象为 Window,Frame 的显示不会收到事件 128 129 api.addEventListener({ 130 name:'viewappear' 131 }, function(ret, err){ 132 alert('window显示'); 133 }); 134 //viewdisappear Window 离开屏幕的事件 135 136 137 //noticeclicked 状态栏通知被用户点击后的回调,字符串类型 138 api.addEventListener({ 139 name:'noticeclicked' 140 },function(ret,err){ 141 alert(ret.value); 142 }); 143 //smartupdatefinish 云修复使用静默修复时,更新完毕事件。可通过监听此事件来通知用户做是否强制重启应用等操作或者提示,以使更新生效,字符串类型 如果是提示修复,则不会触发该事件 144 api.addEventListener({ 145 name:'smartupdatefinish' 146 }, function(ret, err){ 147 alert('云修复完成'); 148 }); 149 //launchviewclicked 启动页被用户点击后的回调,字符串类型 150 api.addEventListener({ 151 name:'launchviewclicked' 152 },function(ret,err){ 153 api.alert({ 154 msg:ret.value 155 }); 156 }); 157 158 // 159 }