Repository: cordova-plugin-network-information Updated Branches: refs/heads/master 5b3ac5462 -> b61bc6700
CB-6127lisa7cordova-plugin-consolecordova-plugin-network-information documentation translation: 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/b61bc670 Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/tree/b61bc670 Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/diff/b61bc670 Branch: refs/heads/master Commit: b61bc6700bd2445ba251b9e84610c6fca8655c6d Parents: 5b3ac54 Author: Lisa Seacat DeLuca <[email protected]> Authored: Mon Jul 7 15:28:15 2014 -0400 Committer: Lisa Seacat DeLuca <[email protected]> Committed: Mon Jul 7 15:28:15 2014 -0400 ---------------------------------------------------------------------- doc/de/index.md | 4 +- doc/es/index.md | 4 +- doc/fr/index.md | 4 +- doc/it/index.md | 4 +- doc/ja/index.md | 4 +- doc/ko/index.md | 4 +- doc/ru/index.md | 181 +++++++++++++++++++++++++++++++++++++++++++++++++++ doc/zh/index.md | 72 ++++++++++---------- 8 files changed, 229 insertions(+), 48 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/b61bc670/doc/de/index.md ---------------------------------------------------------------------- diff --git a/doc/de/index.md b/doc/de/index.md index 71e8647..7de0220 100644 --- a/doc/de/index.md +++ b/doc/de/index.md @@ -121,7 +121,7 @@ Das Ereignis wird ausgelöst, wenn eine Anwendung offline geht, und das Gerät n ### Informationen -Das `offline` -Ereignis wird ausgelöst, wenn ein bereits angeschlossenes Gerät eine Netzwerkverbindung verliert, so dass eine Anwendung nicht mehr auf das Internet zugreifen kann. Es stützt sich auf die gleichen Informationen wie die Verbindung-API und wird ausgelöst, wenn die `connection.type` ändert sich von `NONE` auf einen anderen Wert. +Das `offline` -Ereignis wird ausgelöst, wenn ein bereits angeschlossenes Gerät eine Netzwerkverbindung verliert, so dass eine Anwendung nicht mehr auf das Internet zugreifen kann. Es stützt sich auf die gleichen Informationen wie die Verbindung-API und wird ausgelöst, wenn der Wert des `connection.type` wird`NONE`. Anwendungen sollten in der Regel verwenden `document.addEventListener` einmal einen Ereignis-Listener hinzufügen das `deviceready` -Ereignis ausgelöst. @@ -155,7 +155,7 @@ Dieses Ereignis wird ausgelöst, wenn eine Anwendung online geht, und das Gerät ### Informationen -Das `online` -Ereignis wird ausgelöst, wenn ein zuvor unverbundenen Gerät eine Netzwerkverbindung zu einem Anwendung Zugriff auf das Internet empfängt. Es stützt sich auf die gleichen Informationen wie die Verbindung-API und wird ausgelöst, wenn der Wert des `connection.type` wird`NONE`. +Das `online` -Ereignis wird ausgelöst, wenn ein zuvor unverbundenen Gerät eine Netzwerkverbindung zu einem Anwendung Zugriff auf das Internet empfängt. Es stützt sich auf die gleichen Informationen wie die Verbindung-API und wird ausgelöst, wenn die `connection.type` ändert sich von `NONE` auf einen anderen Wert. Anwendungen sollten in der Regel verwenden `document.addEventListener` einmal einen Ereignis-Listener hinzufügen das `deviceready` -Ereignis ausgelöst. http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/b61bc670/doc/es/index.md ---------------------------------------------------------------------- diff --git a/doc/es/index.md b/doc/es/index.md index 26c051f..49709a0 100644 --- a/doc/es/index.md +++ b/doc/es/index.md @@ -121,7 +121,7 @@ El evento se desencadena cuando una aplicación está desconectada, y el disposi ### Detalles -El `offline` evento se desencadena cuando un dispositivo conectado previamente pierde una conexión de red para que una aplicación no puede acceder a Internet. Se basa en la misma información que la API de conexión y cuando se dispara el `connection.type` cambia de `NONE` a cualquier otro valor. +El `offline` evento se desencadena cuando un dispositivo conectado previamente pierde una conexión de red para que una aplicación no puede acceder a Internet. Se basa en la misma información que la API de conexión y cuando se dispara el valor del `connection.type` se convierte`NONE`. Las aplicaciones normalmente deben utilizar `document.addEventListener` para conectar un detector de eventos una vez el `deviceready` evento incendios. @@ -155,7 +155,7 @@ Este evento se desencadena cuando una aplicación en lÃnea, el dispositivo se c ### Detalles -El `online` evento se desencadena cuando un dispositivo previamente inconexos recibe una conexión de red para permitir un acceso a las aplicaciones a Internet. Se basa en la misma información que la API de conexión y cuando se dispara el valor del `connection.type` se convierte`NONE`. +El `online` evento se desencadena cuando un dispositivo previamente inconexos recibe una conexión de red para permitir un acceso a las aplicaciones a Internet. Se basa en la misma información que la API de conexión y cuando se dispara el `connection.type` cambia de `NONE` a cualquier otro valor. Las aplicaciones normalmente deben utilizar `document.addEventListener` para conectar un detector de eventos una vez el `deviceready` evento incendios. http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/b61bc670/doc/fr/index.md ---------------------------------------------------------------------- diff --git a/doc/fr/index.md b/doc/fr/index.md index ef1c9fa..1aaf8b2 100644 --- a/doc/fr/index.md +++ b/doc/fr/index.md @@ -121,7 +121,7 @@ L'évènement se déclenche lorsqu'une application se déconnecte, quand l'appar ### Détails -L'évènement `offline` se déclenche lorsqu'un appareil précédemment connecté perd sa connexion au réseau, empêchant ainsi l'application d'accéder à Internet. Il repose sur les mêmes informations que l'API Connection et se déclenche quand `connection.type` passe de `NONE` à une autre valeur. +L'évènement `offline` se déclenche lorsqu'un appareil précédemment connecté perd sa connexion au réseau, empêchant ainsi l'application d'accéder à Internet. Il s'appuie sur les mêmes informations que l'API de connexion et se déclenche lorsque la valeur de `connection.type` devient`NONE`. Les applications doivent généralement utiliser `document.addEventListener` pour attacher un écouteur d'événements une fois le `deviceready` événement se déclenche. @@ -153,7 +153,7 @@ L'évènement se déclenche lorsqu'une application se connecte, quand l'appareil ### Détails -L'évènement `online` se déclenche lorsqu'un appareil précédemment non-connecté se connecte au réseau, permettant ainsi à l'application d'accéder à Internet. Il repose sur les mêmes informations que l'API Connection et se déclenche quand la valeur de `connection.type` devient `NONE`. +L'évènement `online` se déclenche lorsqu'un appareil précédemment non-connecté se connecte au réseau, permettant ainsi à l'application d'accéder à Internet. Il s'appuie sur les mêmes informations que l'API de connexion et se déclenche quand le `connection.type` passe de `NONE` à une autre valeur. Les applications doivent généralement utiliser `document.addEventListener` pour attacher un écouteur d'événements une fois le `deviceready` événement se déclenche. http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/b61bc670/doc/it/index.md ---------------------------------------------------------------------- diff --git a/doc/it/index.md b/doc/it/index.md index d9addf1..e3a12a0 100644 --- a/doc/it/index.md +++ b/doc/it/index.md @@ -121,7 +121,7 @@ L'evento viene generato quando un'applicazione passa alla modalità offline, e i ### 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. +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 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. @@ -155,7 +155,7 @@ Questo evento viene generato quando un'applicazione va online, e il dispositivo ### 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`. +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 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. http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/b61bc670/doc/ja/index.md ---------------------------------------------------------------------- diff --git a/doc/ja/index.md b/doc/ja/index.md index b24c49f..601c09e 100644 --- a/doc/ja/index.md +++ b/doc/ja/index.md @@ -121,7 +121,7 @@ ### 詳細 -`offline`ã¢ããªã±ã¼ã·ã§ã³ã¯ãã¯ããã¤ã³ã¿ã¼ãããã«ã¢ã¯ã»ã¹ã§ããããã«ã以忥ç¶ãããããã¤ã¹ã¯ããããã¯ã¼ã¯æ¥ç¶ã失ãããã¨ãã«çºçãã¾ãã æ¥ç¶ API ã¨åãæ å ±ã«ä¾åãã¦ãããå ´åã«é©ç¨ããã¾ãã `connection.type` ãã夿´ `NONE` 以å¤ã®å¤ã«ãã¾ãã +`offline`ã¢ããªã±ã¼ã·ã§ã³ã¯ãã¯ããã¤ã³ã¿ã¼ãããã«ã¢ã¯ã»ã¹ã§ããããã«ã以忥ç¶ãããããã¤ã¹ã¯ããããã¯ã¼ã¯æ¥ç¶ã失ãããã¨ãã«çºçãã¾ãã æ¥ç¶ API ã¨åãæ å ±ã«ä¾åãã¦ãããç«ç½æã®å¤ `connection.type` ã«ãªãã¾ãã`NONE`. é常ã¢ããªã±ã¼ã·ã§ã³ã«ä½¿ç¨ããå¿ è¦ãããã¾ã `document.addEventListener` ä¸åº¦ã®ã¤ãã³ã ãªã¹ãã¼ãã¢ã¿ãããã `deviceready` ã¤ãã³ããçºçãã¾ãã @@ -155,7 +155,7 @@ ### 詳細 -`online`以忥ç¶ããã¦ããªãããã¤ã¹ããã¤ã³ã¿ã¼ãããã¸ã®ã¢ããªã±ã¼ã·ã§ã³ ã¢ã¯ã»ã¹ã許å¯ãããããã¯ã¼ã¯æ¥ç¶ãåä¿¡ããã¨ãã«çºçãã¾ãã æ¥ç¶ API ã¨åãæ å ±ã«ä¾åãã¦ãããç«ç½æã®å¤ `connection.type` ã«ãªãã¾ãã`NONE`. +`online`以忥ç¶ããã¦ããªãããã¤ã¹ããã¤ã³ã¿ã¼ãããã¸ã®ã¢ããªã±ã¼ã·ã§ã³ ã¢ã¯ã»ã¹ã許å¯ãããããã¯ã¼ã¯æ¥ç¶ãåä¿¡ããã¨ãã«çºçãã¾ãã æ¥ç¶ API ã¨åãæ å ±ã«ä¾åãã¦ãããå ´åã«é©ç¨ããã¾ãã `connection.type` ãã夿´ `NONE` 以å¤ã®å¤ã«ãã¾ãã é常ã¢ããªã±ã¼ã·ã§ã³ã«ä½¿ç¨ããå¿ è¦ãããã¾ã `document.addEventListener` ä¸åº¦ã®ã¤ãã³ã ãªã¹ãã¼ãã¢ã¿ãããã `deviceready` ã¤ãã³ããçºçãã¾ãã http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/b61bc670/doc/ko/index.md ---------------------------------------------------------------------- diff --git a/doc/ko/index.md b/doc/ko/index.md index af8868c..ba0eaf6 100644 --- a/doc/ko/index.md +++ b/doc/ko/index.md @@ -121,7 +121,7 @@ ### ì¸ë¶ ì ë³´ -`offline`ì´ë²¤í¸ê° ë°ì íë©´ ìì© íë¡ê·¸ë¨ì´ ë ì´ì ì¸í°ë·ì ì¡ì¸ì¤í ì ìëë¡ ì´ì ì°ê²° ë ì¥ì¹ê° ë¤í¸ìí¬ ì°ê²° ìì¤. ê·¸ê²ì ì°ê²° APIì ëì¼í ì ë³´ì ìì¡´ í ê³ ê²½ì°ì `connection.type` ìì ë³ê²½ `NONE` ë¤ë¥¸ ê°ì¼ë¡. +`offline`ì´ë²¤í¸ê° ë°ì íë©´ ìì© íë¡ê·¸ë¨ì´ ë ì´ì ì¸í°ë·ì ì¡ì¸ì¤í ì ìëë¡ ì´ì ì°ê²° ë ì¥ì¹ê° ë¤í¸ìí¬ ì°ê²° ìì¤. ê·¸ê²ì ì°ê²° APIì ëì¼í ì ë³´ì ìì¡´ í ê³ ê²½ì°ì ê° `connection.type` ëë¤`NONE`. ì¼ë°ì ì¼ë¡ ìì© íë¡ê·¸ë¨ì ì¬ì© í´ì¼ í©ëë¤ `document.addEventListener` íë² ì´ë²¤í¸ 리ì¤ë를 ì°ê²° íë `deviceready` ì´ë²¤í¸ê° ë°ì í©ëë¤. @@ -155,7 +155,7 @@ ### ì¸ë¶ ì ë³´ -`online`ì´ì ì°ê²° ëì§ ìì ì¥ì¹ë ì¸í°ë·ì ë í ìì© íë¡ê·¸ë¨ ì¡ì¸ì¤ë¥¼ íì© íëë¡ ë¤í¸ìí¬ ì°ê²°ì ë°ì ë ì´ë²¤í¸ê° ë°ì í©ëë¤. ê·¸ê²ì ì°ê²° APIì ëì¼í ì ë³´ì ìì¡´ í ê³ ê²½ì°ì ê° `connection.type` ëë¤`NONE`. +`online`ì´ì ì°ê²° ëì§ ìì ì¥ì¹ë ì¸í°ë·ì ë í ìì© íë¡ê·¸ë¨ ì¡ì¸ì¤ë¥¼ íì© íëë¡ ë¤í¸ìí¬ ì°ê²°ì ë°ì ë ì´ë²¤í¸ê° ë°ì í©ëë¤. ê·¸ê²ì ì°ê²° APIì ëì¼í ì ë³´ì ìì¡´ í ê³ ê²½ì°ì `connection.type` ìì ë³ê²½ `NONE` ë¤ë¥¸ ê°ì¼ë¡. ì¼ë°ì ì¼ë¡ ìì© íë¡ê·¸ë¨ì ì¬ì© í´ì¼ í©ëë¤ `document.addEventListener` íë² ì´ë²¤í¸ 리ì¤ë를 ì°ê²° íë `deviceready` ì´ë²¤í¸ê° ë°ì í©ëë¤. http://git-wip-us.apache.org/repos/asf/cordova-plugin-network-information/blob/b61bc670/doc/ru/index.md ---------------------------------------------------------------------- diff --git a/doc/ru/index.md b/doc/ru/index.md new file mode 100644 index 0000000..e5a0e76 --- /dev/null +++ b/doc/ru/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]. Ðн пÑедоÑÑавлÑÐµÑ Ð¸Ð½ÑоÑмаÑÐ¸Ñ Ð¾ ÑоÑовÑÑ Ð¸ Wi-Fi подклÑÑение ÑÑÑÑойÑÑва, и Ð¸Ð¼ÐµÐµÑ Ð»Ð¸ ÑÑÑÑойÑÑво подклÑÑÐµÐ½Ð¸Ñ Ðº ÐнÑеÑнеÑÑ. + + [1]: http://www.w3.org/TR/2011/WD-netinfo-api-20110607/ + +## УÑÑановка + + cordova plugin add org.apache.cordova.network-information + + +## ÐоддеÑживаемÑе плаÑÑоÑÐ¼Ñ + +* Amazon Fire ÐС +* Android +* BlackBerry 10 +* iOS +* Windows Phone 7 и 8 +* Tizen +* Windows 8 +* Firefox OS + +# ÐодклÑÑение + +> `connection`ÐбÑекÑов, ÑеÑез `navigator.connection` , пÑедоÑÑавлÑÐµÑ Ð¸Ð½ÑоÑмаÑÐ¸Ñ Ð¾ ÑоÑовÑÑ Ð¸ wifi подклÑÑение ÑÑÑÑойÑÑва. + +## СвойÑÑва + +* 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 Ð¼Ð¾Ð¶ÐµÑ ÑолÑко обнаÑÑжиÑÑ Wi-Fi или ÑоÑовой ÑвÑзи. + * `navigator.connection.type`Ð¸Ð¼ÐµÐµÑ Ð·Ð½Ð°Ñение `Connection.CELL_2G` Ð´Ð»Ñ Ð²ÑÐµÑ ÑоÑовÑÑ Ð´Ð°Ð½Ð½ÑÑ . + +### Firefox OS пÑиÑÑÐ´Ñ + +* Firefox 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/b61bc670/doc/zh/index.md ---------------------------------------------------------------------- diff --git a/doc/zh/index.md b/doc/zh/index.md index cae3cc2..7868eca 100644 --- a/doc/zh/index.md +++ b/doc/zh/index.md @@ -19,31 +19,31 @@ # org.apache.cordova.network-information -è¿ä¸ªæä»¶æä¾çæ§çæ¬ç[ç½ç»ä¿¡æ¯ API][1]å®ç°çã 宿ä¾äºæå ³è¯¥è®¾å¤çç§»å¨çµè¯åæ 线ç½ç»è¿æ¥çä¿¡æ¯åè®¾å¤æ¯å¦å·²è¿æ¥å° internetã +éå夿ç¨å¼æä¾çèçæ¬ç[網路è³è¨ API][1]實ç¾çã 宿ä¾äºæé該è¨åçè¡åé»è©±åç¡ç·ç¶²è·¯é£æ¥çè³è¨åè¨åæ¯å¦å·²é£æ¥å° internetã [1]: http://www.w3.org/TR/2011/WD-netinfo-api-20110607/ -## å®è£ +## å®è£ cordova plugin add org.apache.cordova.network-information -## æ¯æçå¹³å° +## æ¯æ´çå¹³èº -* äºé©¬éç« OS -* Android ç³»ç» +* äºé¦¬éç« OS +* Android 系統 * é»è 10 * iOS * Windows Phone 7 å 8 * Tizen * Windows 8 -* ç«çæµè§å¨æä½ç³»ç» +* ç«çç覽å¨ä½æ¥ç³»çµ± -# è¿æ¥ +# 飿¥ -> `connection`对象ï¼éè¿å ¬å¼ `navigator.connection` ï¼æä¾äºæå ³è¯¥è®¾å¤çç§»å¨çµè¯åæ 线ç½ç»è¿æ¥çä¿¡æ¯ã +> `connection`ç©ä»¶ï¼ééå ¬é `navigator.connection` ï¼æä¾äºæé該è¨åçè¡åé»è©±åç¡ç·ç¶²è·¯é£æ¥çè³è¨ã -## 屿§ +## å±¬æ§ * connection.type @@ -60,7 +60,7 @@ ## connection.type -æ¤å±æ§æä¾å¿«éçæ¹æ³æ¥ç¡®å®è®¾å¤çç½ç»è¿æ¥ç¶æï¼åè¿æ¥ç±»åã +æ¤å±¬æ§æä¾å¿«éçæ¹æ³ä¾ç¢ºå®è¨åçç¶²è·¯é£æ¥çæ ï¼åé£ç·é¡åã ### å¿«éçç¤ºä¾ @@ -85,45 +85,45 @@ ### API æ´æ¹ -ç¥éCordova 2.3.0ï¼ `Connection` 对象æ¯éè¿ `navigator.network.connection`è¢«è®¿é® ï¼ä¹åææ¹ä¸º `navigator.connection` å¹é ç W3C è§èã å®ä»ç¶æ¯å¨å ¶åæ¥çä½ç½®ï¼ä½å·²è¢«åºå¼ï¼æç»å°è¢«å é¤ã +ç§ç¾å¤ç¦ 2.3.0ï¼ç´å° `Connection` ç©ä»¶ç訪åéé `navigator.network.connection` 徿æ¹çºå ¶ä¸, `navigator.connection` 以å¹é ç W3C è¦ç¯ã å®å¨å ¶åå§ä½ç½®ï¼æ¯ä»ç¶å¯ç¨ï¼ä½å·²å»¢æ£ï¼æçµå°è¢«åªé¤ã ### iOS çæªç -* iOS æ æ³æ£æµå°èçªç½ç»è¿æ¥çç±»åã - * `navigator.connection.type`设置为 `Connection.CELL` 为ææèçªæ°æ®ã +* iOS ç¡æ³æª¢æ¸¬å°èçª©ç¶²è·¯é£æ¥çé¡åã + * `navigator.connection.type`è¨ç½®çº `Connection.CELL` çºææèçª©è³æã ### Windows Phone æªç -* å½è¿è¡å¨ä»¿çå¨ä¸ï¼æ»è½æ£æµå° `navigator.connection.type` ä½ä¸º`Connection.UNKNOWN`. +* ç¶éè¡å¨æ¨¡æ¬å¨ä¸ï¼ç¸½è½æª¢æ¸¬å° `navigator.connection.type` ä½çº`Connection.UNKNOWN`. -* Windows Phone ä¸è½æ£æµçèçªç½ç»è¿æ¥çç±»åã +* Windows Phone ä¸è½æª¢æ¸¬çèçª©ç¶²è·¯é£æ¥çé¡åã - * `navigator.connection.type`设置为 `Connection.CELL` 为ææèçªæ°æ®ã + * `navigator.connection.type`è¨ç½®çº `Connection.CELL` çºææèçª©è³æã ### Tizen æªç -* Tizen åªå¯ä»¥æ£æµä¸ä¸ª WiFi æè èçªè¿æ¥ã - * `navigator.connection.type`设置为 `Connection.CELL_2G` 为ææèçªæ°æ®ã +* Tizen åªå¯ä»¥æª¢æ¸¬ä¸å WiFi æè èçª©é£æ¥ã + * `navigator.connection.type`è¨ç½®çº `Connection.CELL_2G` çºææèçª©è³æã -### ç«çæµè§å¨æä½ç³»ç»çæªç +### ç«çç覽å¨ä½æ¥ç³»çµ±çæªç -* ç«çæµè§å¨æä½ç³»ç»æ æ³æ£æµå°èçªç½ç»è¿æ¥çç±»åã - * `navigator.connection.type`设置为 `Connection.CELL` 为ææèçªæ°æ®ã +* ç«çç覽å¨ä½æ¥ç³»çµ±ç¡æ³æª¢æ¸¬å°èçª©ç¶²è·¯é£æ¥çé¡åã + * `navigator.connection.type`è¨ç½®çº `Connection.CELL` çºææèçª©è³æã -# ä¸ç½ç»ç¸å ³çäºä»¶ +# è網路ç¸éçäºä»¶ ## offline -å½ä¸ä¸ªåºç¨ç¨åºç¦»çº¿ï¼å¹¶ä¸è¯¥è®¾å¤æªè¿æ¥å°äºèç½æ¶ï¼å°è§¦å该äºä»¶ã +ç¶ä¸åæç¨ç¨å¼é¢ç·æï¼è該è¨åæªé£æ¥å°äºè¯ç¶²æï¼å°è§¸ç¼è©²äºä»¶ã document.addEventListener("offline", yourCallbackFunction, false); -### 详ç»ä¿¡æ¯ +### 詳細è³è¨ -å½ä»¥åè¿æ¥ç设å¤å¤±å»ç½ç»è¿æ¥ï¼ä»¥è´åºç¨ç¨åºä¸åå¯ä»¥è®¿é®äºèç½æ¶ï¼å°è§¦å该`offline`äºä»¶ã å®ä¾èµäºè¿æ¥APIä¸ç¸åçä¿¡æ¯ï¼å¹¶ä¸ å½ `connection.type`ä» `NONE` æ´æ¹ä¸ºå ¶ä»ä»»ä½å¼çæ¶åï¼å°è§¦å该äºä»¶ã +`offline`以å飿¥çè¨å失å»ç¶²è·¯é£æ¥ï¼éæ¨£ï¼æç¨ç¨å¼ä¸åå¯ä»¥è¨ªåäºè¯ç¶²ææ¿ç¼çäºä»¶ã å®ä¾è³´äºé£æ¥ APIï¼ç¸åçè³è¨åç«ç½æçå¼ `connection.type` è®å¾`NONE`. -åºç¨ç¨åºé常åºä½¿ç¨ `document.addEventListener` å°ä¸ä¸ªäºä»¶ä¾¦å¬å¨éå 䏿¬¡ `deviceready` äºä»¶ç«ç¾ã +æç¨ç¨å¼é常æä½¿ç¨ `document.addEventListener` å°ä¸åäºä»¶ææªå¨éå 䏿¬¡ `deviceready` äºä»¶ç«ç½ã ### å¿«éçç¤ºä¾ @@ -136,28 +136,28 @@ ### iOS çæªç -å¨åå§å¯å¨æé´ï¼ç¬¬ä¸æ¬¡è±æºäºä»¶ ï¼å¦æéç¨ï¼ è³å°éè¦ä¸ç§å»è§¦åã +å¨åå§ååæéï¼ç¬¬ä¸æ¬¡é¢ç·äºä»¶ ï¼å¦æé©ç¨ï¼ éè³å°ä¸ç§çç«ã ### Windows Phone 7 çæªç -å½è¿è¡å¨ä»¿çå¨ä¸æ¶ï¼ `connection.status` å§ç»æ¯æªç¥çï¼å æ¤æ¤äºä»¶å°æ¯*not*触åã +ç¶éè¡å¨æ¨¡æ¬å¨ä¸ï¼ `connection.status` å§çµæ¯æªç¥çå æ¤æ¤äºä»¶ä¸æ*ä¸*ç«ã ### Windows Phone 8 æªç -仿çç¨åºæ¥åè¿æ¥ç±»å为 `Cellular` ï¼èä¸ä¼æ´æ¹ï¼æä»¥è¯¥äºä»¶å°æ¯*not*触åã +模æ¬ç¨å¼å ±åé£ç·é¡åçº `Cellular` ï¼èä¸ææ´æ¹ï¼æä»¥è©²äºä»¶ä¸æ*ä¸*ç«ã ## online -å½åºç¨ç¨åºè¿å ¥å¨çº¿ç¶æï¼å¹¶ä¸è¯¥è®¾å¤å°æä¸ºè¿æ¥å°äºèç½æ¶è§¦åæ¤äºä»¶ã +ç¶æç¨ç¨å¼é²å ¥ç·ä¸çæ ï¼å該è¨åå°æçºé£æ¥å°äºè¯ç¶²æè§¸ç¼æ¤äºä»¶ã document.addEventListener("online", yourCallbackFunction, false); -### 详ç»ä¿¡æ¯ +### 詳細è³è¨ -å½ä»¥åæªè¿æ¥çç§»å¨è®¾å¤æ¥æ¶å°ä¸ä¸ªç½ç»è¿æ¥ï¼ä»¥å 许åºç¨ç¨åºè®¿é®äºèç½æ¶å°è§¦å该`online`äºä»¶ã å®ä¾èµäºè¿æ¥ APIç¸åçä¿¡æ¯ï¼å¹¶ä¸å½ `connection.type` å为`NONE`æ¶æè§¦åã. +`online`ç¶å å飿¥çè¡åè£ç½®æ¥æ¶å°ä¸åç¶²è·¯é£æ¥ä»¥å 許æç¨ç¨å¼è¨ªåäºè¯ç¶²ææ¿ç¼çäºä»¶ã å®ä¾è³´äºé£æ¥ APIï¼ç¸åçè³è¨ï¼åææ¿ç¼ `connection.type` 徿´æ¹ `NONE` çºä»»ä½å ¶ä»å¼ã -åºç¨ç¨åºé常åºä½¿ç¨ `document.addEventListener` å°ä¸ä¸ªäºä»¶ä¾¦å¬å¨éå 䏿¬¡ `deviceready` äºä»¶ç«ç¾ã +æç¨ç¨å¼é常æä½¿ç¨ `document.addEventListener` å°ä¸åäºä»¶ææªå¨éå 䏿¬¡ `deviceready` äºä»¶ç«ç½ã ### å¿«éçç¤ºä¾ @@ -170,12 +170,12 @@ ### iOS çæªç -å¨åå§å¯å¨æé´ï¼ç¬¬ä¸æ¬¡è³å°éä¸ç§éæ¥è§¦å `online` äºä»¶ (妿éç¨)ï¼å¨è¿ä¹å`connection.type` æ¯`UNKNOWN`. +å¨åå§ååæéç¬¬ä¸æ¬¡ `online` äºä»¶ ï¼å¦æé©ç¨ï¼ï¼è³å°éä¸ç§çç«ç½ä¹åç, `connection.type` æ¯`UNKNOWN`. ### Windows Phone 7 çæªç -å½è¿è¡å¨ä»¿çå¨ä¸ï¼ `connection.status` å§ç»æ¯æªç¥çå æ¤æ¤äºä»¶ä¸ä¼*ä¸*ç«ã +ç¶éè¡å¨æ¨¡æ¬å¨ä¸ï¼ `connection.status` å§çµæ¯æªç¥çå æ¤æ¤äºä»¶ä¸æ*ä¸*ç«ã ### Windows Phone 8 æªç -仿çç¨åºæ¥åè¿æ¥ç±»å为 `Cellular` ï¼èä¸ä¼æ´æ¹ï¼æä»¥è¯¥äºä»¶å°æ¯*not*触åã \ No newline at end of file +模æ¬ç¨å¼å ±åé£ç·é¡åçº `Cellular` ï¼èä¸ææ´æ¹ï¼æä»¥äºä»¶ä¸**ç«ã \ No newline at end of file
