接続
connectionオブジェクトによって公開されてnavigator.connection、デバイスの携帯電話や wifi 接続に関する情報を提供します。
プロパティ
定数
- Connection.UNKNOWN
- Connection.ETHERNET
- Connection.WIFI
- Connection.CELL_2G
- Connection.CELL_3G
- Connection.CELL_4G
- Connection.CELL
- Connection.NONE
機能へのアクセス
バージョン 3.0 は、コルドバのプラグインとしてデバイス レベルの Api を実装します。 CLI の使用 plugin のコマンドライン ・ インタ フェースを追加または削除、プロジェクトに対してこの機能を記載されているコマンド。
$ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information.git
$ cordova plugin rm org.apache.cordova.core.network-information
これらのコマンドすべてのターゲット プラットフォームに適用されますが、以下のプラットフォームに固有の構成設定を変更します。
-
アンドロイド
(in app/res/xml/config.xml) <feature name="NetworkStatus"> <param name="android-package" value="org.apache.cordova.NetworkManager" /> </feature> (in app/AndroidManifest.xml) <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> -
ブラックベリー WebWorks
(in www/plugins.xml) <feature name="Network Status"> <param name="blackberry-package" value="org.apache.cordova.network.Network" /> </feature> -
iOS (
config.xml)<feature name="NetworkStatus"> <param name="ios-package" value="CDVConnection" /> </feature> -
(Windows Phone
Properties/WPAppManifest.xml)<Capabilities> <Capability Name="ID_CAP_NETWORKING" /> </Capabilities> -
(Tizen
config.xml)<feature name="http://tizen.org/api/systeminfo" required="true"/>
いくつかのプラットフォームは特別な構成を必要とせずにこの機能をサポート可能性があります。概要については、プラットフォームのサポートを参照してください。
connection.type
現在アクティブなネットワーク接続を確認します。
説明
このプロパティはデバイスのネットワーク接続状態を確認する速い方法を提供し、接続の種類。
サポートされているプラットフォーム
- iOS
- アンドロイド
- ブラックベリー WebWorks (OS 5.0 およびより高い)
- Tizen
- Windows Phone 7 と 8
- Windows 8
簡単な例
function checkConnection() {
var networkState = navigator.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.CELL] = 'Cell generic connection';
states[Connection.NONE] = 'No network connection';
alert('Connection type: ' + states[networkState]);
}
checkConnection();
完全な例
<!DOCTYPE html>
<html>
<head>
<title>navigator.connection.type Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
document.addEventListener("deviceready", onDeviceReady, false);
// device APIs are available
//
function onDeviceReady() {
checkConnection();
}
function checkConnection() {
var networkState = navigator.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.CELL] = 'Cell generic 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>
API の変更
コルドバ 2.3.0、まで、 Connection 経由でアクセスされたオブジェクトが navigator.network.connection 、それに変更されましたが後 navigator.connection W3C の仕様に一致します。 それはまだ元の場所は廃止され、最終的に削除されます。
iOS の癖
- iOS は、携帯電話のネットワーク接続の種類を検出できません。
-
navigator.connection.typeis set toConnection.CELLfor all cellular data.
-
Windows Phone の癖
When running in the emulator, always detects
navigator.connection.typeasConnection.UNKNOWN.-
Windows Phone 携帯電話ネットワーク接続の種類を検出できません。
-
navigator.connection.typeis set toConnection.CELLfor all cellular data.
-
Tizen の癖
- Tizen には、WiFi または携帯電話の接続だけを検出できます。
-
navigator.connection.typeis set toConnection.CELL_2Gfor all cellular data.
-