Cordova事件整理

柔光的暖阳◎ 2022-07-12 10:40 200阅读 0赞

## Cordova事件 ##

Cordova框架了一组事件，开发者用来对某些运行Cordova应用的设备上的事件作出反应。事件处理的一种情况是硬件相关活动，如电池状态变化或用户按了某个物理按钮；另一种情况是应用程序状态的变化，如应用被中止或恢复。这些web应用使用的事件同Native应用使用的是一样的。

完整的支持的事件列表如下：

<table style="border-collapse:collapse; border-spacing:0px; margin:1.5em 0px; width:825px; color:rgb(51,51,51); font-family:&quot;Helvetica Neue&quot;,Helvetica,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;WenQuanYi Micro Hei&quot;,&quot;Microsoft Yahei&quot;,sans-serif; font-size:14px"> 
 <tbody style=""> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Cordova 事件</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 描述</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> backbutton</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 用户按设备后退键时触发</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> batterycritical</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 电池达到关键状态时触发。关键状态的定义因平台而异</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> batterylow</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 电池低电量状态时触发。低电量状态的定义因平台而异</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> batterystatus</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 电池状态至少改变1%时时触发(增加或减少)</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> deviceready</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> cordova容器完成初始化时触发</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> endcallbutton</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 在用户按手机的结束通话键时触发</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> menubutton</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 在用户按手机的菜单键时触发</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> offline</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 在设备失去网络连接时触发</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> online</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 在设备由没有网络连接转换到连接状态时触发</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> pause</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> Cordova应用被挂起时触发。一般发生在用户跳转到另一个应用，系统把当前应用放在后台时</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> resume</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 在被挂起的应用转到前台时触发</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> searchbutton</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 在用户按查找键时触发</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> startcallbutton</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 在用户按通话键时触发</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> volumedownbutton</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 用户按音量减少键时触发</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> volumnupbutton</td> 
   <td style="padding:5px 8px; border:1px solid rgb(230,230,230); word-break:normal"> 用户按音量键增加时触发</td> 
  </tr> 
 </tbody> 
</table>

> 老式手机使用物理按钮来拨通和结束通话。在较新的设备上，这些按钮被移除并用虚拟按键代替。虚拟按键只在用到(如菜单和查找按键)，或只用于某些应用(像电话按键)。

大多数的列出的事件都在Cordova容器中实现了。只有电池状态以插件形式实现了。要使应用能够监视电池事件必须首先添加电池状态插件：

cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin=battery-status.git

其中device事件在《cordova应用解析》讨论过。

要监视这些事件可以简单的在应用中为某个事件注册监听器。

document.addEventListener("eventName", eventFunction);

如要监听是否断开网络连接，可以注册offline事件的监听器：

document.addEventListener("offline", isOffline); function isOffline() { // 断开网络连接时的动作 }

> 事件在不同的移动平台上并不都准确的按期望的情况触发，需要在不同设备上测试确保应用按期望的工作。

**测试过的事件如下：**

/********Cordova事件绑定******/
    document.addEventListener('backbutton', function () {
        console.info("后退键被点击");
    }, false);
    document.addEventListener('deviceready', function () {
        console.info("cordova容器完成初始化时触发");
    }, false);
    document.addEventListener('menubutton', function () {
        console.info("在用户按手机的菜单键时触发");
    }, false);
    document.addEventListener('pause', function () {
        console.info("Cordova应用被挂起时触发");
    }, false);
    document.addEventListener('resume', function () {
        console.info("在被挂起的应用转到前台时触发");
    }, false);
    document.addEventListener('startcallbutton', function () {
        console.info("在用户按通话键时触发");
    }, false);

![Center][]

[cordova-plugin-vibration 设备震动整理][cordova-plugin-vibration]

[cordova-plugin-device 获取设备信息整理][cordova-plugin-device]

[cordova-plugin-network-information 网络状态获取整理][cordova-plugin-network-information]

[Center]: /images/20220710/ec1b76c714fd4807a4c4fcbe17927096.png
[cordova-plugin-vibration]: http://blog.csdn.net/u011127019/article/details/56284190
[cordova-plugin-device]: http://blog.csdn.net/u011127019/article/details/56281444
[cordova-plugin-network-information]: http://blog.csdn.net/u011127019/article/details/56276918