Lisa testing pulling in plugins for plugin: cordova-plugin-network-information
Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/repo Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/commit/def55b89 Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/tree/def55b89 Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/diff/def55b89 Branch: refs/heads/master Commit: def55b89f95bab6d44e7b241e1ddd6c080da655c Parents: 996cd74 Author: ldeluca <[email protected]> Authored: Tue May 27 21:22:33 2014 -0400 Committer: ldeluca <[email protected]> Committed: Tue May 27 21:22:33 2014 -0400 ---------------------------------------------------------------------- doc/es/index.md | 12 +++- doc/fr/index.md | 6 ++ doc/it/index.md | 181 +++++++++++++++++++++++++++++++++++++++++++++++++++ doc/ko/index.md | 181 +++++++++++++++++++++++++++++++++++++++++++++++++++ doc/pl/index.md | 181 +++++++++++++++++++++++++++++++++++++++++++++++++++ doc/zh/index.md | 181 +++++++++++++++++++++++++++++++++++++++++++++++++++ 6 files changed, 740 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/def55b89/doc/es/index.md ---------------------------------------------------------------------- diff --git a/doc/es/index.md b/doc/es/index.md index 4817768..26c051f 100644 --- a/doc/es/index.md +++ b/doc/es/index.md @@ -37,6 +37,7 @@ Este plugin proporciona una implementación de una versión antigua de la [Red d * Windows Phone 7 y 8 * Tizen * Windows 8 +* Firefox OS # Conexión @@ -104,6 +105,11 @@ Hasta Cordova 2.3.0, el `Connection` objeto se accede a través de `navigator.ne * Tizen sólo puede detectar un Wi-Fi o conexión celular. * `navigator.connection.type`se establece en `Connection.CELL_2G` para todos los datos celulares. +### Firefox OS rarezas + +* Firefox OS no puede detectar el tipo de conexión de red celular. + * `navigator.connection.type`se establece en `Connection.CELL` para todos los datos celulares. + # Eventos relacionados con la red ## offline @@ -121,9 +127,11 @@ Las aplicaciones normalmente deben utilizar `document.addEventListener` para con ### Ejemplo rápido - document.addEventListener ("offline", onOffline, false); + document.addEventListener("offline", onOffline, false); - function onOffline() {/ / Handle del evento offline} + function onOffline() { + // Handle the offline event + } ### iOS rarezas http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/def55b89/doc/fr/index.md ---------------------------------------------------------------------- diff --git a/doc/fr/index.md b/doc/fr/index.md index 58e1d04..ef1c9fa 100644 --- a/doc/fr/index.md +++ b/doc/fr/index.md @@ -37,6 +37,7 @@ Ce plugin fournit une implémentation d'une ancienne version de l' [API Informat * Windows Phone 7 et 8 * Paciarelli * Windows 8 +* Firefox OS # Connexion @@ -104,6 +105,11 @@ Jusqu'à Cordova 2.3.0, l'objet `Connection` était accessible via `navigator.ne * Paciarelli peut uniquement détecter une connexion cellulaire ou bien WiFi. * `navigator.connection.type`a la valeur `Connection.CELL_2G` pour toutes les données cellulaires. +### Firefox OS Quirks + +* Firefox OS ne peut pas détecter le type de connexion au réseau cellulaire. + * `navigator.connection.type`a la valeur `Connection.CELL` pour toutes les données cellulaires. + # Ãvénements liés au réseau ## offline http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/def55b89/doc/it/index.md ---------------------------------------------------------------------- diff --git a/doc/it/index.md b/doc/it/index.md new file mode 100644 index 0000000..d9addf1 --- /dev/null +++ b/doc/it/index.md @@ -0,0 +1,181 @@ +<!--- + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. +--> + +# org.apache.cordova.network-information + +Questo plugin fornisce un'implementazione di una vecchia versione dell' [API di informazioni di rete][1]. Fornisce informazioni sul dispositivo cellulare e connessione wifi, e se il dispositivo dispone di una connessione internet. + + [1]: http://www.w3.org/TR/2011/WD-netinfo-api-20110607/ + +## Installazione + + cordova plugin add org.apache.cordova.network-information + + +## Piattaforme supportate + +* Amazon fuoco OS +* Android +* BlackBerry 10 +* iOS +* Windows Phone 7 e 8 +* Tizen +* Windows 8 +* Firefox OS + +# Connessione + +> Il `connection` oggetto, esposto tramite `navigator.connection` , fornisce informazioni sulla connessione wifi e cellulare del dispositivo. + +## Proprietà + +* connection.type + +## Costanti + +* Connection.UNKNOWN +* Connection.ETHERNET +* Connection.WIFI +* Connection.CELL_2G +* Connection.CELL_3G +* Connection.CELL_4G +* Connection.CELL +* Connection.NONE + +## connection.type + +Questa proprietà offre un modo rapido per determinare stato della connessione di rete del dispositivo e il tipo di connessione. + +### Esempio rapido + + 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(); + + +### Cambiamento di API + +Fino a Cordova 2.3.0, il `Connection` oggetto era accessibile tramite `navigator.network.connection` , dopo che è stato cambiato in `navigator.connection` per abbinare la specifica W3C. à ancora disponibile nella sua posizione originale, ma è obsoleto e verrà rimosso alla fine. + +### iOS stranezze + +* iOS non è possibile rilevare il tipo di connessione di rete cellulare. + * `navigator.connection.type`è impostata su `Connection.CELL` per tutti i dati cellulare. + +### Stranezze di Windows Phone + +* Quando è in esecuzione nell'emulatore, rileva sempre `navigator.connection.type` come`Connection.UNKNOWN`. + +* Windows Phone non riesce a rilevare il tipo di connessione di rete cellulare. + + * `navigator.connection.type`è impostata su `Connection.CELL` per tutti i dati cellulare. + +### Tizen stranezze + +* Tizen può rilevare solo un WiFi o una connessione cellulare. + * `navigator.connection.type`è impostata su `Connection.CELL_2G` per tutti i dati cellulare. + +### Firefox OS stranezze + +* Sistema operativo Firefox non riesce a rilevare il tipo di connessione di rete cellulare. + * `navigator.connection.type`è impostata su `Connection.CELL` per tutti i dati cellulare. + +# Eventi relativi alla rete + +## offline + +L'evento viene generato quando un'applicazione passa alla modalità offline, e il dispositivo non è connesso a Internet. + + document.addEventListener("offline", yourCallbackFunction, false); + + +### Dettagli + +Il `offline` evento viene generato quando un dispositivo precedentemente connesso perde una connessione di rete in modo che un'applicazione non è più possibile accedere a Internet. Esso si basa sulle stesse informazioni come l'API di connessione e viene attivato quando il `connection.type` cambia da `NONE` a qualsiasi altro valore. + +Applicazioni in genere è necessario utilizzare `document.addEventListener` per fissare un listener di eventi una volta il `deviceready` evento incendi. + +### Esempio rapido + + document.addEventListener("offline", onOffline, false); + + function onOffline() { + // Handle the offline event + } + + +### iOS stranezze + +Durante l'avvio iniziale, il primo evento offline (se applicabile) richiede almeno un secondo al fuoco. + +### Windows Phone 7 capricci + +Quando è in esecuzione nell'emulatore, il `connection.status` è sempre sconosciuto, così fa di questo evento *non* fuoco. + +### Windows Phone 8 stranezze + +L'emulatore riporta il tipo di connessione come `Cellular` , che non cambia, così fa l'evento *non* fuoco. + +## online + +Questo evento viene generato quando un'applicazione va online, e il dispositivo diventa collegato a Internet. + + document.addEventListener("online", yourCallbackFunction, false); + + +### Dettagli + +Il `online` evento viene generato quando un dispositivo precedentemente scollegato riceve una connessione di rete per consentire un'accesso di applicazione a Internet. Esso si basa sulle stesse informazioni come l'API di connessione e viene generato quando il valore di `connection.type` diventa`NONE`. + +Applicazioni in genere è necessario utilizzare `document.addEventListener` per fissare un listener di eventi una volta il `deviceready` evento incendi. + +### Esempio rapido + + document.addEventListener("online", onOnline, false); + + function onOnline() { + // Handle the online event + } + + +### iOS stranezze + +Durante l'avvio iniziale, il primo `online` evento (se applicabile) richiede almeno un secondo al fuoco, prima che `connection.type` è`UNKNOWN`. + +### Windows Phone 7 capricci + +Quando è in esecuzione nell'emulatore, il `connection.status` è sempre sconosciuto, così fa di questo evento *non* fuoco. + +### Windows Phone 8 stranezze + +L'emulatore riporta il tipo di connessione come `Cellular` , che non cambia, quindi, non gli eventi *non* a fuoco. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/def55b89/doc/ko/index.md ---------------------------------------------------------------------- diff --git a/doc/ko/index.md b/doc/ko/index.md new file mode 100644 index 0000000..af8868c --- /dev/null +++ b/doc/ko/index.md @@ -0,0 +1,181 @@ +<!--- + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. +--> + +# org.apache.cordova.network-information + +ì´ íë¬ê·¸ì¸ [ë¤í¸ìí¬ ì ë³´ API][1]ì ì´ì ë²ì ì ë í 구íì ì ê³µí©ëë¤. ììì ì 룰ë¬ì ìì´íì´ ì°ê²°ì ë í ì 보를 ì ê³µ í©ëë¤ ì¥ì¹ë ì¸í°ë· ì°ê²°ì ìëì§ ì¬ë¶. + + [1]: http://www.w3.org/TR/2011/WD-netinfo-api-20110607/ + +## ì¤ì¹ + + cordova plugin add org.apache.cordova.network-information + + +## ì§ì ëë íë«í¼ + +* ìë§ì¡´ íì¬ ì´ì ì²´ì +* ì ë ë¡ì´ë +* ë¸ëë² ë¦¬ 10 +* iOS +* Windows Phone 7ê³¼ 8 +* Tizen +* ìëì° 8 +* Firefox ì´ì ì²´ì + +# ì°ê²° + +> `connection`ê°ì²´ë¥¼ íµí´ ë ¸ì¶ `navigator.connection` , ììì ì 룰ë¬ì ìì´íì´ ì°ê²°ì ë í ì 보를 ì ê³µ í©ëë¤. + +## ìì± + +* connection.type + +## ìì + +* Connection.UNKNOWN +* Connection.ETHERNET +* Connection.WIFI +* Connection.CELL_2G +* Connection.CELL_3G +* Connection.CELL_4G +* Connection.CELL +* Connection.NONE + +## connection.type + +ì´ ëë°ì´ì¤ì ë¤í¸ìí¬ ì°ê²° ìí를 íì¸ íë ë¹ ë¥¸ ë°©ë²ì ì ê³µ í©ëë¤ ë° ì°ê²°ì ì¢ ë¥. + +### ë¹ ë¥¸ ìì + + 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(); + + +### API ë³ê²½ + +ì½ë¥´ ëì° ë° 2.3.0ê¹ì§ `Connection` ê°ì²´ë¥¼ íµí´ ì¡ì¸ì¤ íìµëë¤ `navigator.network.connection` , íì ë³ê²½ ë `navigator.connection` W3C ì¬ìì ë§ê². ê·¸ê²ì ê·¸ê²ì ìë ìì¹ì ê³ì ì¬ì©í ì íì§ë§ ì¬ì© ëì§ ììµëë¤ ë° ê²°êµ ì ê±° ë ê² ì´ë¤. + +### iOS ë¨ì + +* iOSë ì ë£°ë¬ ë¤í¸ìí¬ ì°ê²°ì ì¢ ë¥ë¥¼ ê°ì§í ì ììµëë¤. + * `navigator.connection.type`ë¡ ì¤ì ë `Connection.CELL` 모ë ì ë£°ë¬ ë°ì´í°ì ë í. + +### Windows Phone ë¨ì + +* ì뮬ë ì´í°ìì ì¤íí ë íì ê²ì `navigator.connection.type` ì¼ë¡`Connection.UNKNOWN`. + +* Windows Phone ì ë£°ë¬ ë¤í¸ìí¬ ì°ê²° ì íì ê²ìí ì ììµëë¤. + + * `navigator.connection.type`ë¡ ì¤ì ë `Connection.CELL` 모ë ì ë£°ë¬ ë°ì´í°ì ë í. + +### Tizen í¹ì + +* Tizenì ìì´íì´ ëë í´ë ì í ì°ê²°ìë§ ê²ìí ì ììµëë¤. + * `navigator.connection.type`ë¡ ì¤ì ë `Connection.CELL_2G` 모ë ì ë£°ë¬ ë°ì´í°ì ë í. + +### íì´ì´ íì¤ OS ë¨ì + +* íì´ì´ íì¤ OS ì ë£°ë¬ ë¤í¸ìí¬ ì°ê²° ì íì ê²ìí ì ììµëë¤. + * `navigator.connection.type`ë¡ ì¤ì ë `Connection.CELL` 모ë ì ë£°ë¬ ë°ì´í°ì ë í. + +# ë¤í¸ìí¬ ê´ë ¨ ì´ë²¤í¸ + +## offline + +ì´ë²¤í¸ê° ë°ì íë©´ ìì© íë¡ê·¸ë¨ ì¤í ë¼ì¸, ì´ë ë° ì¥ì¹ê° ì¸í°ë·ì ì°ê²° ëì´ ìì§. + + document.addEventListener("offline", yourCallbackFunction, false); + + +### ì¸ë¶ ì ë³´ + +`offline`ì´ë²¤í¸ê° ë°ì íë©´ ìì© íë¡ê·¸ë¨ì´ ë ì´ì ì¸í°ë·ì ì¡ì¸ì¤í ì ìëë¡ ì´ì ì°ê²° ë ì¥ì¹ê° ë¤í¸ìí¬ ì°ê²° ìì¤. ê·¸ê²ì ì°ê²° APIì ëì¼í ì ë³´ì ìì¡´ í ê³ ê²½ì°ì `connection.type` ìì ë³ê²½ `NONE` ë¤ë¥¸ ê°ì¼ë¡. + +ì¼ë°ì ì¼ë¡ ìì© íë¡ê·¸ë¨ì ì¬ì© í´ì¼ í©ëë¤ `document.addEventListener` íë² ì´ë²¤í¸ 리ì¤ë를 ì°ê²° íë `deviceready` ì´ë²¤í¸ê° ë°ì í©ëë¤. + +### ë¹ ë¥¸ ìì + + document.addEventListener("offline", onOffline, false); + + function onOffline() { + // Handle the offline event + } + + +### iOS ë¨ì + +ì²ì ìì íë ëì 첫 ë²ì§¸ ì¤í ë¼ì¸ ì´ë²¤í¸ (ìë ê²½ì°)를 ì ì´ë ì´ë¥¼ 걸립ëë¤. + +### Windows Phone 7 ë¨ì + +ì뮬ë ì´í°ìì ì¤í íë ê²½ì°ë `connection.status` íì ë¶ëª íë¤, ê·¸ëìì´ ì´ë²¤í¸ë *ìë* ë¶. + +### Windows Phone 8 ë¨ì + +ì뮬ë ì´í°ë ì°ê²° íìì ë³´ê³ `Cellular` ë ë³ê²½ ëì§ ììµëë¤, ê·¸ëì ì´ë²¤í¸ ììµëë¤ *íì§* ë¶. + +## online + +ìì© íë¡ê·¸ë¨ì ì¨ë¼ì¸ ë° ì¥ì¹ê° ì¸í°ë·ì ì°ê²° ëë¤ ëì´ ì´ë²¤í¸ê° ë°ì í©ëë¤. + + document.addEventListener("online", yourCallbackFunction, false); + + +### ì¸ë¶ ì ë³´ + +`online`ì´ì ì°ê²° ëì§ ìì ì¥ì¹ë ì¸í°ë·ì ë í ìì© íë¡ê·¸ë¨ ì¡ì¸ì¤ë¥¼ íì© íëë¡ ë¤í¸ìí¬ ì°ê²°ì ë°ì ë ì´ë²¤í¸ê° ë°ì í©ëë¤. ê·¸ê²ì ì°ê²° APIì ëì¼í ì ë³´ì ìì¡´ í ê³ ê²½ì°ì ê° `connection.type` ëë¤`NONE`. + +ì¼ë°ì ì¼ë¡ ìì© íë¡ê·¸ë¨ì ì¬ì© í´ì¼ í©ëë¤ `document.addEventListener` íë² ì´ë²¤í¸ 리ì¤ë를 ì°ê²° íë `deviceready` ì´ë²¤í¸ê° ë°ì í©ëë¤. + +### ë¹ ë¥¸ ìì + + document.addEventListener("online", onOnline, false); + + function onOnline() { + // Handle the online event + } + + +### iOS ë¨ì + +ì²ì ìì íë ëì 첫 ë²ì§¸ `online` ì´ë²¤í¸ (ìë ê²½ì°) ì´ì ì ë¶ ì´ ê±¸ë¦½ëë¤ ì´ì `connection.type` ì ëë¤`UNKNOWN`. + +### Windows Phone 7 ë¨ì + +ì뮬ë ì´í°ìì ì¤í íë ê²½ì°ë `connection.status` íì ë¶ëª íë¤, ê·¸ëìì´ ì´ë²¤í¸ë *ìë* ë¶. + +### Windows Phone 8 ë¨ì + +ì뮬ë ì´í°ë ì°ê²° íìì ë³´ê³ `Cellular` ë ë³ê²½ ëì§ ììµëë¤, ê·¸ëì ì´ë²¤í¸ ììµëë¤ *íì§* ë¶. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/def55b89/doc/pl/index.md ---------------------------------------------------------------------- diff --git a/doc/pl/index.md b/doc/pl/index.md new file mode 100644 index 0000000..e374819 --- /dev/null +++ b/doc/pl/index.md @@ -0,0 +1,181 @@ +<!--- + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. +--> + +# org.apache.cordova.network-information + +Wtyczka stanowi implementacjÄ starÄ wersjÄ [API informacji w sieci][1]. UdostÄpnia informacje na temat urzÄ dzenia komórkowe i wifi poÅÄ czenie, i czy urzÄ dzenie ma poÅÄ czenie z Internetem. + + [1]: http://www.w3.org/TR/2011/WD-netinfo-api-20110607/ + +## Instalacji + + cordova plugin add org.apache.cordova.network-information + + +## ObsÅugiwane platformy + +* Amazon ogieÅ OS +* Android +* Jeżyna 10 +* iOS +* Windows Phone 7 i 8 +* Tizen +* Windows 8 +* Firefox OS + +# PoÅÄ czenie + +> `connection`Obiektu, wystawiony przez `navigator.connection` , zawiera informacje o poÅÄ czeniu urzÄ dzenia komórkowe i wifi. + +## WÅaÅciwoÅci + +* Connection.Type + +## StaÅe + +* Connection.UNKNOWN +* Connection.ETHERNET +* Connection.WIFI +* Connection.CELL_2G +* Connection.CELL_3G +* Connection.CELL_4G +* Connection.CELL +* Connection.NONE + +## Connection.Type + +Oferuje szybki sposób ustaliÄ stan poÅÄ czenia sieciowego urzÄ dzenia i typ poÅÄ czenia. + +### Szybki przykÅad + + 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(); + + +### Zmiana interfejsu API + +Do Cordova 2.3.0 `Connection` obiekt uzyskano za poÅrednictwem `navigator.network.connection` , po którym zostaÅ zmieniony na `navigator.connection` odpowiadaÄ specyfikacji W3C. To jest nadal dostÄpne w jego oryginalnej lokalizacji, ale jest niezalecane i zostanÄ ostatecznie usuniÄte. + +### iOS dziwactwa + +* iOS nie może wykryÄ typ poÅÄ czenia w sieci komórkowej. + * `navigator.connection.type`jest zestaw `Connection.CELL` dla wszystkich komórek danych. + +### Windows Phone dziwactwa + +* Po uruchomieniu w emulatorze, zawsze wykrywa `navigator.connection.type` jako`Connection.UNKNOWN`. + +* Windows Phone nie może wykryÄ typ poÅÄ czenia w sieci komórkowej. + + * `navigator.connection.type`jest zestaw `Connection.CELL` dla wszystkich komórek danych. + +### OsobliwoÅci Tizen + +* Tizen można tylko dostrzegaÄ Wi-Fi lub poÅÄ czenia komórkowe. + * `navigator.connection.type`jest zestaw `Connection.CELL_2G` dla wszystkich komórek danych. + +### Firefox OS dziwactwa + +* Firefox OS nie można wykryÄ typ poÅÄ czenia w sieci komórkowej. + * `navigator.connection.type`jest zestaw `Connection.CELL` dla wszystkich komórek danych. + +# Zdarzenia zwiÄ zane z sieci + +## offline + +Zdarzenie odpala gdy aplikacja przejdzie do trybu offline, a urzÄ dzenie nie jest podÅÄ czone do Internetu. + + document.addEventListener("offline", yourCallbackFunction, false); + + +### SzczegóÅy + +`offline`Zdarzenie fires po wczeÅniej podÅÄ czone urzÄ dzenie traci poÅÄ czenia z sieciÄ , dziÄki czemu aplikacja może już dostÄp do Internetu. Opiera siÄ na te same informacje poÅÄ czenia API i gdy odpalam `connection.type` zmienia siÄ z `NONE` na innÄ wartoÅÄ. + +Aplikacje zwykle należy użyÄ `document.addEventListener` Aby doÅÄ czyÄ sÅuchacza raz `deviceready` pożary zdarzenia. + +### Szybki przykÅad + + document.addEventListener("offline", onOffline, false); + + function onOffline() { + // Handle the offline event + } + + +### iOS dziwactwa + +Podczas uruchamiania systemu pierwsza impreza offline (jeÅli dotyczy) trwa co najmniej drugi ognia. + +### Windows Phone 7 dziwactwa + +Po uruchomieniu w emulatorze, `connection.status` zawsze jest nieznana, wiÄc to wydarzenie *nie* ogieÅ. + +### Windows Phone 8 dziwactwa + +Emulator raporty typ poÅÄ czenia, jako `Cellular` , co nie zmienia, wiÄc zdarzenie *nie* ogieÅ. + +## online + +Wydarzenie to odpala gdy aplikacja przechodzi w tryb online i urzÄ dzenie staje siÄ poÅÄ czenie z Internetem. + + document.addEventListener("online", yourCallbackFunction, false); + + +### SzczegóÅy + +`online`Zdarzenie odpala gdy wczeÅniej niezwiÄ zane urzÄ dzenie odbiera poÅÄ czenie sieciowe, aby umożliwiÄ aplikacji dostÄp do Internetu. Opiera siÄ na te same informacje poÅÄ czenia API i gdy odpalam wartoÅÄ `connection.type` staje siÄ`NONE`. + +Aplikacje zwykle należy użyÄ `document.addEventListener` Aby doÅÄ czyÄ sÅuchacza raz `deviceready` pożary zdarzenia. + +### Szybki przykÅad + + document.addEventListener("online", onOnline, false); + + function onOnline() { + // Handle the online event + } + + +### iOS dziwactwa + +Podczas uruchamiania systemu pierwszy `online` zdarzenia (w stosownych przypadkach) zajmuje co najmniej drugie ognia, przed którym `connection.type` jest`UNKNOWN`. + +### Windows Phone 7 dziwactwa + +Po uruchomieniu w emulatorze, `connection.status` zawsze jest nieznana, wiÄc to wydarzenie *nie* ogieÅ. + +### Windows Phone 8 dziwactwa + +Emulator sprawozdania jako typ poÅÄ czenia `Cellular` , które nie zmienia, wiÄc wydarzenia czy *nie* ogieÅ. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/def55b89/doc/zh/index.md ---------------------------------------------------------------------- diff --git a/doc/zh/index.md b/doc/zh/index.md new file mode 100644 index 0000000..58141c6 --- /dev/null +++ b/doc/zh/index.md @@ -0,0 +1,181 @@ +<!--- + Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. +--> + +# org.apache.cordova.network-information + +éåå¤æç¨å¼æä¾çèçæ¬ç[網路è³è¨ API][1]實ç¾çã å®æä¾äºæé該è¨åçè¡åé»è©±åç¡ç·ç¶²è·¯é£æ¥çè³è¨åè¨åæ¯å¦å·²é£æ¥å° internetã + + [1]: http://www.w3.org/TR/2011/WD-netinfo-api-20110607/ + +## å®è£ + + cordova plugin add org.apache.cordova.network-information + + +## æ¯æ´çå¹³èº + +* äºé¦¬éç« OS +* Android 系統 +* é»è 10 +* iOS +* Windows Phone 7 å 8 +* Tizen +* Windows 8 +* ç«çç覽å¨ä½æ¥ç³»çµ± + +# é£æ¥ + +> `connection`ç©ä»¶ï¼ééå ¬é `navigator.connection` ï¼æä¾äºæé該è¨åçè¡åé»è©±åç¡ç·ç¶²è·¯é£æ¥çè³è¨ã + +## å±¬æ§ + +* connection.type + +## 常é + +* Connection.UNKNOWN +* Connection.ETHERNET +* Connection.WIFI +* Connection.CELL_2G +* Connection.CELL_3G +* Connection.CELL_4G +* Connection.CELL +* Connection.NONE + +## connection.type + +æ¤å±¬æ§æä¾å¿«éçæ¹æ³ä¾ç¢ºå®è¨åç網路é£æ¥çæ ï¼åé£ç·é¡åã + +### å¿«éçç¤ºä¾ + + 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(); + + +### API æ´æ¹ + +ç§ç¾å¤ç¦ 2.3.0ï¼ç´å° `Connection` ç©ä»¶ç訪åéé `navigator.network.connection` å¾ææ¹çºå ¶ä¸, `navigator.connection` 以å¹é ç W3C è¦ç¯ã å®å¨å ¶åå§ä½ç½®ï¼æ¯ä»ç¶å¯ç¨ï¼ä½å·²å»¢æ£ï¼æçµå°è¢«åªé¤ã + +### iOS çæªç + +* iOS ç¡æ³æª¢æ¸¬å°è窩網路é£æ¥çé¡åã + * `navigator.connection.type`è¨ç½®çº `Connection.CELL` çºææè窩è³æã + +### Windows Phone æªç + +* ç¶éè¡å¨æ¨¡æ¬å¨ä¸ï¼ç¸½è½æª¢æ¸¬å° `navigator.connection.type` ä½çº`Connection.UNKNOWN`. + +* Windows Phone ä¸è½æª¢æ¸¬çè窩網路é£æ¥çé¡åã + + * `navigator.connection.type`è¨ç½®çº `Connection.CELL` çºææè窩è³æã + +### Tizen æªç + +* Tizen åªå¯ä»¥æª¢æ¸¬ä¸å WiFi æè è窩é£æ¥ã + * `navigator.connection.type`è¨ç½®çº `Connection.CELL_2G` çºææè窩è³æã + +### ç«çç覽å¨ä½æ¥ç³»çµ±çæªç + +* ç«çç覽å¨ä½æ¥ç³»çµ±ç¡æ³æª¢æ¸¬å°è窩網路é£æ¥çé¡åã + * `navigator.connection.type`è¨ç½®çº `Connection.CELL` çºææè窩è³æã + +# è網路ç¸éçäºä»¶ + +## offline + +ç¶ä¸åæç¨ç¨å¼é¢ç·æï¼è該è¨åæªé£æ¥å°äºè¯ç¶²æï¼å°è§¸ç¼è©²äºä»¶ã + + document.addEventListener("offline", yourCallbackFunction, false); + + +### 詳細è³è¨ + +`offline`以åé£æ¥çè¨å失å»ç¶²è·¯é£æ¥ï¼é樣ï¼æç¨ç¨å¼ä¸åå¯ä»¥è¨ªåäºè¯ç¶²ææ¿ç¼çäºä»¶ã å®ä¾è³´äºé£æ¥ API ä¸ï¼ç¸åçè³è¨åç«ç½æ `connection.type` å¾æ´æ¹ `NONE` çºå ¶ä»ä»»ä½å¼ã + +æç¨ç¨å¼é常æä½¿ç¨ `document.addEventListener` å°ä¸åäºä»¶ææªå¨éå ä¸æ¬¡ `deviceready` äºä»¶ç«ç½ã + +### å¿«éçç¤ºä¾ + + document.addEventListener("offline", onOffline, false); + + function onOffline() { + // Handle the offline event + } + + +### iOS çæªç + +å¨åå§ååæéï¼ç¬¬ä¸æ¬¡é¢ç·äºä»¶ ï¼å¦æé©ç¨ï¼ éè³å°ä¸ç§çç«ã + +### Windows Phone 7 çæªç + +ç¶éè¡å¨æ¨¡æ¬å¨ä¸ï¼ `connection.status` å§çµæ¯æªç¥çå æ¤æ¤äºä»¶ä¸æ*ä¸*ç«ã + +### Windows Phone 8 æªç + +模æ¬ç¨å¼å ±åé£ç·é¡åçº `Cellular` ï¼èä¸ææ´æ¹ï¼æ以該äºä»¶ä¸æ*ä¸*ç«ã + +## online + +ç¶æç¨ç¨å¼é²å ¥ç·ä¸çæ ï¼å該è¨åå°æçºé£æ¥å°äºè¯ç¶²æ觸ç¼æ¤äºä»¶ã + + document.addEventListener("online", yourCallbackFunction, false); + + +### 詳細è³è¨ + +`online`ç¶å åé£æ¥çè¡åè£ç½®æ¥æ¶å°ä¸å網路é£æ¥ä»¥å 許æç¨ç¨å¼è¨ªåäºè¯ç¶²ææ¿ç¼çäºä»¶ã å®ä¾è³´äºé£æ¥ API ä¸ï¼ç¸åçè³è¨åç«ç½æçå¼ `connection.type` æçº`NONE`. + +æç¨ç¨å¼é常æä½¿ç¨ `document.addEventListener` å°ä¸åäºä»¶ææªå¨éå ä¸æ¬¡ `deviceready` äºä»¶ç«ç½ã + +### å¿«éçç¤ºä¾ + + document.addEventListener("online", onOnline, false); + + function onOnline() { + // Handle the online event + } + + +### iOS çæªç + +å¨åå§ååæé第ä¸æ¬¡ `online` äºä»¶ ï¼å¦æé©ç¨ï¼ï¼è³å°éä¸ç§çç«ç½ä¹åç, `connection.type` æ¯`UNKNOWN`. + +### Windows Phone 7 çæªç + +ç¶éè¡å¨æ¨¡æ¬å¨ä¸ï¼ `connection.status` å§çµæ¯æªç¥çå æ¤æ¤äºä»¶ä¸æ*ä¸*ç«ã + +### Windows Phone 8 æªç + +模æ¬ç¨å¼å ±åé£ç·é¡åçº `Cellular` ï¼èä¸ææ´æ¹ï¼æ以äºä»¶ä¸**ç«ã \ No newline at end of file
