CB-9128 cordova-plugin-network-information documentation translation: cordova-plugin-network-information

2026-04-22 00:00:02 +08:00 · 2015-06-12 09:42:27 -05:00
parent 9ec0b4a2bd
commit a8310e9635
8 changed files with 1518 additions and 0 deletions
@@ -0,0 +1,190 @@
+<!--
+# license: 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.
+-->
+
+# cordova-plugin-network-information
+
+[![Build Status](https://travis-ci.org/apache/cordova-plugin-network-information.svg)](https://travis-ci.org/apache/cordova-plugin-network-information)
+
+Wtyczka stanowi implementację starą wersję [API informacji w sieci](http://www.w3.org/TR/2011/WD-netinfo-api-20110607/). Udostępnia informacje na temat urządzenia komórkowe i wifi połączenie, i czy urządzenie ma połączenie z Internetem.
+
+## Instalacja
+
+    cordova plugin add cordova-plugin-network-information
+    
+
+## Obsługiwane platformy
+
+  * Amazon Fire OS
+  * Android
+  * BlackBerry 10
+  * Przeglądarka
+  * iOS
+  * Windows Phone 7 i 8
+  * Tizen
+  * Windows
+  * 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.
+
+### Dziwactwa iOS
+
+  * 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.
+
+### Windows dziwactwa
+
+  * Po uruchomieniu w emulatorze telefonu 8.1, zawsze wykrywa `navigator.connection.type` jako `Connection.ETHERNET`.
+
+### Dziwactwa Tizen
+
+  * Tizen można tylko dostrzegać Wi-Fi lub połączenia komórkowe. 
+      * `Navigator.Connection.Type` jest zestaw do `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.
+
+### Quirks przeglądarki
+
+  * Przeglądarka nie może wykryć typ połączenia sieciowego. `Navigator.Connection.Type` jest zawsze zestaw do `Connection.UNKNOWN` podczas online.
+
+# 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 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("offline", onOffline, false);
+    
+    function onOffline() {
+        // Handle the offline event
+    }
+    
+
+### Dziwactwa iOS
+
+Podczas uruchamiania systemu pierwsza impreza offline (jeśli dotyczy) trwa co najmniej drugi ognia.
+
+### Dziwactwa Windows Phone 7
+
+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 `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("online", onOnline, false);
+    
+    function onOnline() {
+        // Handle the online event
+    }
+    
+
+### Dziwactwa iOS
+
+Podczas uruchamiania systemu pierwszy `online` zdarzenia (w stosownych przypadkach) zajmuje co najmniej drugie ognia, przed którym `connection.type` jest`UNKNOWN`.
+
+### Dziwactwa Windows Phone 7
+
+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ń.