README.md 6.6 KB

cordova-plugin-network-information

Build Status

Wtyczka stanowi implementację starą wersję API informacji w sieci. 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

connectionObiektu, 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.typejest zestaw Connection.CELL dla wszystkich komórek danych.

Windows Phone dziwactwa

  • Po uruchomieniu w emulatorze, zawsze wykrywa navigator.connection.type jakoConnection.UNKNOWN.

  • Windows Phone nie może wykryć typ połączenia w sieci komórkowej.

    • navigator.connection.typejest 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.typejest 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

offlineZdarzenie 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

onlineZdarzenie 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 jestUNKNOWN.

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ń.