forked from apache/cordova-plugin-network-information
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
CB-9128 cordova-plugin-network-information documentation translation:…
… cordova-plugin-network-information
- Loading branch information
Victor Sosa
committed
Jun 12, 2015
1 parent
9ec0b4a
commit a8310e9
Showing
8 changed files
with
1,518 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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) | ||
|
||
Dieses Plugin stellt eine Implementierung einer alten Version der [Netzwerk-Informationen-API](http://www.w3.org/TR/2011/WD-netinfo-api-20110607/). Es werden Informationen über das Gerät Mobilfunk und Wifi-Anschluss, und ob das Gerät über eine Internetverbindung verfügt. | ||
|
||
## Installation | ||
|
||
cordova plugin add cordova-plugin-network-information | ||
|
||
|
||
## Unterstützte Plattformen | ||
|
||
* Amazon Fire OS | ||
* Android | ||
* BlackBerry 10 | ||
* Browser | ||
* iOS | ||
* Windows Phone 7 und 8 | ||
* Tizen | ||
* Windows | ||
* Firefox OS | ||
|
||
# Connection | ||
|
||
> Das `connection` Objekt, verfügbar gemachten über `navigator.connection`, enthält Informationen über die Mobilfunk- und Wi-Fi-Verbindung des Gerätes. | ||
## Eigenschaften | ||
|
||
* connection.type | ||
|
||
## Konstanten | ||
|
||
* Connection.UNKNOWN | ||
* Connection.ETHERNET | ||
* Connection.WIFI | ||
* Connection.CELL_2G | ||
* Connection.CELL_3G | ||
* Connection.CELL_4G | ||
* Connection.CELL | ||
* Connection.NONE | ||
|
||
## connection.type | ||
|
||
Diese Eigenschaft bietet eine schnelle Möglichkeit, um den Netzwerkverbindungsstatus und die Art der Verbindung zu bestimmen. | ||
|
||
### Kurzes Beispiel | ||
|
||
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 Änderung | ||
|
||
Bis Cordova 2.3.0 wurde auf das `Connection` Objekt über `navigator.network.connection` zugegriffen, danach wurde der Zugriff auf `navigator.connection` geändert, um der W3C-Spezifikation zu entsprechen. Es steht immer noch an seiner ursprünglichen Stelle, aber ist veraltet und wird schliesslich entfernt. | ||
|
||
### iOS Macken | ||
|
||
* iOS kann Mobilfunknetz Verbindungstyp nicht erkennen. | ||
* `navigator.connection.type`auf festgelegt ist `Connection.CELL` für alle Handy-Daten. | ||
|
||
### Windows Phone Macken | ||
|
||
* Wenn im Emulator ausgeführt wird, erkennt immer `navigator.connection.type` als`Connection.UNKNOWN`. | ||
|
||
* Windows Phone kann Mobilfunknetz Verbindungstyp nicht erkennen. | ||
|
||
* `navigator.connection.type`auf festgelegt ist `Connection.CELL` für alle Handy-Daten. | ||
|
||
### Windows-Eigenheiten | ||
|
||
* Wenn im Telefon 8.1 Emulator ausgeführt wird, erkennt immer `navigator.connection.type` als `Connection.ETHERNET`. | ||
|
||
### Tizen Macken | ||
|
||
* Tizen kann nur ein WiFi oder Mobilfunkverbindung erkennen. | ||
* `Navigator.Connection.Type` ist für alle Handy-Daten auf `Connection.CELL_2G` festgelegt. | ||
|
||
### Firefox OS Macken | ||
|
||
* Firefox-OS kann Mobilfunknetz Verbindungstyp nicht erkennen. | ||
* `navigator.connection.type`auf festgelegt ist `Connection.CELL` für alle Handy-Daten. | ||
|
||
### Browser-Eigenheiten | ||
|
||
* Browser kann die Art der Netzwerkverbindung nicht erkennen. `navigator.connection.type` ist immer auf `Connection.UNKNOWN` beim online gesetzt. | ||
|
||
# Netzwerk-Veranstaltungen | ||
|
||
## offline | ||
|
||
Das Ereignis wird ausgelöst, wenn eine Anwendung offline geht, und das Gerät nicht mit dem Internet verbunden ist. | ||
|
||
document.addEventListener("offline", yourCallbackFunction, false); | ||
|
||
|
||
### Details | ||
|
||
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. | ||
|
||
### Kurzes Beispiel | ||
|
||
document.addEventListener("offline", onOffline, false); | ||
|
||
function onOffline() { | ||
// Handle the offline event | ||
} | ||
|
||
|
||
### iOS Macken | ||
|
||
Beim ersten Start dauert das erste offline-Event (falls zutreffend) mindestens eine Sekunde zu schießen. | ||
|
||
### Windows Phone 7 Macken | ||
|
||
Bei der Ausführung im Emulator, der `connection.status` ist immer unbekannt, so dass dieses Ereignis *nicht* Feuer. | ||
|
||
### Windows Phone 8 Macken | ||
|
||
Der Emulator meldet den Verbindungstyp als `Cellular` , die wird nicht geändert, so dass das Ereignis *nicht* Feuer. | ||
|
||
## online | ||
|
||
Dieses Ereignis wird ausgelöst, wenn eine Anwendung online geht, und das Gerät wird mit dem Internet verbunden. | ||
|
||
document.addEventListener("online", yourCallbackFunction, false); | ||
|
||
|
||
### Details | ||
|
||
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. | ||
|
||
### Kurzes Beispiel | ||
|
||
document.addEventListener("online", onOnline, false); | ||
|
||
function onOnline() { | ||
// Handle the online event | ||
} | ||
|
||
|
||
### iOS Macken | ||
|
||
Beim ersten Start die erste `online` Ereignis (falls zutreffend) dauert mindestens eine Sekunde vor dem Feuer `connection.type` ist`UNKNOWN`. | ||
|
||
### Windows Phone 7 Macken | ||
|
||
Bei der Ausführung im Emulator, der `connection.status` ist immer unbekannt, so dass dieses Ereignis *nicht* Feuer. | ||
|
||
### Windows Phone 8 Macken | ||
|
||
Der Emulator meldet den Verbindungstyp als `Cellular` , die wird nicht geändert, so dass Ereignisse *nicht* Feuer. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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) | ||
|
||
Este plugin proporciona una implementación de una versión antigua de la [Red de información API](http://www.w3.org/TR/2011/WD-netinfo-api-20110607/). Proporciona información acerca del dispositivo móvil y conexión wifi, y si el dispositivo tiene una conexión a internet. | ||
|
||
## Instalación | ||
|
||
cordova plugin add cordova-plugin-network-information | ||
|
||
|
||
## Plataformas soportadas | ||
|
||
* Amazon fire OS | ||
* Android | ||
* BlackBerry 10 | ||
* Explorador | ||
* iOS | ||
* Windows Phone 7 y 8 | ||
* Tizen | ||
* Windows | ||
* Firefox OS | ||
|
||
# Connection | ||
|
||
> El objeto de `connection`, expuesto a través de `navigator.connection`, proporciona información sobre conexión celular y wifi del dispositivo. | ||
## Propiedades | ||
|
||
* connection.type | ||
|
||
## Constantes | ||
|
||
* Connection.UNKNOWN | ||
* Connection.ETHERNET | ||
* Connection.WIFI | ||
* Connection.CELL_2G | ||
* Connection.CELL_3G | ||
* Connection.CELL_4G | ||
* Connection.CELL | ||
* Connection.NONE | ||
|
||
## connection.type | ||
|
||
Esta propiedad ofrece una forma rápida de determinar el estado de conexión de red del dispositivo y el tipo de conexión. | ||
|
||
### Ejemplo rápido | ||
|
||
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(); | ||
|
||
|
||
### Cambio de API | ||
|
||
Hasta Cordova 2.3.0, el objeto de `conexión` era acceder a través de `navigator.network.connection`, tras lo cual fue cambiada a `navigator.connection` para que coincida con la especificación del W3C. Sigue estando disponible en su ubicación original, pero es obsoleto y eventualmente desaparecerá. | ||
|
||
### iOS rarezas | ||
|
||
* iOS no puede detectar el tipo de conexión de red celular. | ||
* `navigator.connection.type` está establecido en `Connection.CELL` para todos los datos de celulares. | ||
|
||
### Windows Phone rarezas | ||
|
||
* Cuando se ejecuta en el emulador, siempre detecta `navigator.connection.type` como `Connection.UNKNOWN`. | ||
|
||
* Windows Phone no puede detectar el tipo de conexión de red celular. | ||
|
||
* `navigator.connection.type` está establecido en `Connection.CELL` para todos los datos de celulares. | ||
|
||
### Windows rarezas | ||
|
||
* Cuando se ejecuta en el emulador de teléfono 8.1, siempre detecta `navigator.connection.type` como`Connection.ETHERNET`. | ||
|
||
### Rarezas Tizen | ||
|
||
* 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` está establecido en `Connection.CELL` para todos los datos de celulares. | ||
|
||
### Navegador rarezas | ||
|
||
* Navegador no puede detectar el tipo de conexión de red. `Navigator.Connection.Type` se encuentra siempre a `Connection.UNKNOWN` cuando en línea. | ||
|
||
# Eventos relacionados con la red | ||
|
||
## offline | ||
|
||
El evento se desencadena cuando una aplicación está desconectada, y el dispositivo no está conectado a Internet. | ||
|
||
document.addEventListener("offline", yourCallbackFunction, false); | ||
|
||
|
||
### Detalles | ||
|
||
El evento `offline` 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 que se desencadene el evento `deviceready`. | ||
|
||
### Ejemplo rápido | ||
|
||
document.addEventListener("offline", onOffline, false); | ||
|
||
function onOffline() { | ||
// Handle the offline event | ||
} | ||
|
||
|
||
### iOS rarezas | ||
|
||
Durante el arranque inicial, el primer evento offline (si es aplicable) tarda al menos un segundo en fuego. | ||
|
||
### Windows Phone 7 rarezas | ||
|
||
Cuando se ejecuta en el emulador, la `connection.status` siempre es desconocido, así que este evento no se ** fuego. | ||
|
||
### Windows Phone 8 rarezas | ||
|
||
El emulador informa el tipo de conexión como `celular`, que no cambia, así que el evento *no se* fuego. | ||
|
||
## online | ||
|
||
Este evento se desencadena cuando una aplicación va en línea, y el dispositivo se conecta a Internet. | ||
|
||
document.addEventListener("online", yourCallbackFunction, false); | ||
|
||
|
||
### Detalles | ||
|
||
El evento `online` se desencadena cuando un dispositivo previamente inconexos recibe una conexión de red para permitir un acceso a las aplicaciones para Internet. Se basa en la misma información que la API de conexión y se desencadena cuando el `connection.type` cambia de `ninguno` a cualquier otro valor. | ||
|
||
Las aplicaciones normalmente deben utilizar `document.addEventListener` para conectar un detector de eventos una vez que se desencadene el evento `deviceready`. | ||
|
||
### Ejemplo rápido | ||
|
||
document.addEventListener("online", onOnline, false); | ||
|
||
function onOnline() { | ||
// Handle the online event | ||
} | ||
|
||
|
||
### iOS rarezas | ||
|
||
Durante el arranque inicial, el primer evento `en línea` (si procede) al menos toma un segundo para disparar, antes de que `connection.type` es `desconocido`. | ||
|
||
### Windows Phone 7 rarezas | ||
|
||
Cuando se ejecuta en el emulador, la `connection.status` siempre es desconocido, así que este evento no se ** fuego. | ||
|
||
### Windows Phone 8 rarezas | ||
|
||
El emulador, informa el tipo de conexión como `Cellular` , que no cambia, así que se lo eventos *no* fuego. |
Oops, something went wrong.