mirror of
https://gitee.com/shuto/cordova-plugin-network-information.git
synced 2025-01-31 18:47:21 +08:00
181 lines
6.1 KiB
Markdown
181 lines
6.1 KiB
Markdown
|
<!---
|
||
|
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ń.
|