PhoneGap API介绍：Connection

来源：互联网发布：新手开淘宝网店编辑：程序博客网时间：2024/05/17 23:40

本文将介绍PhoneGap API

——Connection:快速检查WiFi或蜂窝网络的信息。Connection对象提供对设备的蜂窝及WiFi连接信息的访问。通过navigator.network接口访问该对象。

属性：

connection.type

常量：

connection.UNKNOWN

connection.ETHERNET

connection.WIFI

connection.CELL_2G

connection.CELL_3G

connection.CELL_4G

connection.NONE

connection.type

检查正在使用的活动网络连接。

说明：

该属性是确定设备网络连接状态和连接类型的快速方法。

支持的平台：

iOS

Android

BlackBerry WebWorks (OS 5.0或更高版本)

简单的范例：

function checkConnection() { 
    var networkState = navigator.network.connection.type; 
     
    var states = {}; 
    states[Connection.UNKNOWN]  = 'Unknown connection'; 
    states[Connection.ETHERNET] = 'Ethernet connection'; 
    states[Connection.WIFI]     = 'WiFi connection'; 
    states[Connection.CELL_2G]  = 'Cell 2G connection'; 
    states[Connection.CELL_3G]  = 'Cell 3G connection'; 
    states[Connection.CELL_4G]  = 'Cell 4G connection'; 
    states[Connection.NONE]     = 'No network connection'; 
     
    alert('Connection type: ' + states[networkState]); 
} 
     
checkConnection();

完整的范例：

<!DOCTYPE html> 
<html> 
<head> 
<title>navigator.network.connection.type Example</title>  
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>   
<script type="text/javascript" charset="utf-8">   
 
    // 等待加载PhoneGap 
    document.addEventListener(“deviceready“, onDeviceReady, false);   
 
    // PhoneGap加载完毕，可以安全调用PhoneGap方法 
    function onDeviceReady() {  
        checkConnection();  
    }   
 
    function checkConnection() {  
        var networkState = navigator.network.connection.type;         
 
        var states = {};  
        states[Connection.UNKNOWN]  = 'Unknown connection';  
        states[Connection.ETHERNET] = 'Ethernet connection';  
        states[Connection.WIFI]     = 'WiFi connection';  
        states[Connection.CELL_2G]  = 'Cell 2G connection';  
        states[Connection.CELL_3G]  = 'Cell 3G connection';  
        states[Connection.CELL_4G]  = 'Cell 4G connection';  
        states[Connection.NONE]     = 'No network connection';  
 
        alert('Connection type: ' + states[networkState]);  
} 
 
</script> 
</head> 
<body> 
    <p>A dialog box will report the network state.</p> 
</body> 
</html>