openEventsPlatformApp/plugins/cordova-plugin-device/doc/es/README.md
plugins/cordova-plugin-device/doc/es/README.mdRaw
1<!--
2# license: Licensed to the Apache Software Foundation (ASF) under one
3# or more contributor license agreements. See the NOTICE file
4# distributed with this work for additional information
5# regarding copyright ownership. The ASF licenses this file
6# to you under the Apache License, Version 2.0 (the
7# "License"); you may not use this file except in compliance
8# with the License. You may obtain a copy of the License at
9#
10# http://www.apache.org/licenses/LICENSE-2.0
11#
12# Unless required by applicable law or agreed to in writing,
13# software distributed under the License is distributed on an
14# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15# KIND, either express or implied. See the License for the
16# specific language governing permissions and limitations
17# under the License.
18-->
19
20# cordova-plugin-device
21
22[](https://travis-ci.org/apache/cordova-plugin-device)
23
24Este plugin define un global `device` objeto que describe del dispositivo hardware y software. Aunque el objeto está en el ámbito global, no está disponible hasta después de la `deviceready` evento.
25
26 document.addEventListener("deviceready", onDeviceReady, false);
27 function onDeviceReady() {
28 console.log(device.cordova);
29 }
30
31
32## Instalación
33
34 cordova plugin add cordova-plugin-device
35
36
37## Propiedades
38
39 * device.cordova
40 * device.model
41 * device.platform
42 * device.uuid
43 * device.version
44
45## device.cordova
46
47Obtener la versión de Cordova que se ejecuta en el dispositivo.
48
49### Plataformas soportadas
50
51 * Amazon fire OS
52 * Android
53 * BlackBerry 10
54 * Explorador
55 * Firefox OS
56 * iOS
57 * Tizen
58 * Windows Phone 7 y 8
59 * Windows 8
60
61## device.model
62
63El `device.model` devuelve el nombre de modelo del dispositivo o producto. El valor es fijado por el fabricante del dispositivo y puede ser diferente a través de versiones del mismo producto.
64
65### Plataformas soportadas
66
67 * Android
68 * BlackBerry 10
69 * Explorador
70 * iOS
71 * Tizen
72 * Windows Phone 7 y 8
73 * Windows 8
74
75### Ejemplo rápido
76
77 // Android: Nexus One returns "Passion" (Nexus One code name)
78 // Motorola Droid returns "voles"
79 // BlackBerry: Torch 9800 returns "9800"
80 // Browser: Google Chrome returns "Chrome"
81 // Safari returns "Safari"
82 // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. See http://theiphonewiki.com/wiki/index.php?title=Models
83 //
84 var model = device.model;
85
86
87### Rarezas Android
88
89 * Obtiene el [nombre del producto](http://developer.android.com/reference/android/os/Build.html#PRODUCT) en lugar del [nombre de la modelo](http://developer.android.com/reference/android/os/Build.html#MODEL), que es a menudo el nombre de código de producción. Por ejemplo, el Nexus One devuelve `Passion` y Motorola Droid devuelve `voles`.
90
91### Rarezas Tizen
92
93 * Devuelve que el modelo de dispositivo asignado por el proveedor, por ejemplo, `TIZEN`
94
95### Windows Phone 7 y 8 rarezas
96
97 * Devuelve el modelo de dispositivo especificado por el fabricante. Por ejemplo, el Samsung Focus devuelve `SGH-i917`.
98
99## device.platform
100
101Obtener el nombre del sistema operativo del dispositivo.
102
103 var string = device.platform;
104
105
106### Plataformas soportadas
107
108 * Android
109 * BlackBerry 10
110 * Browser4
111 * Firefox OS
112 * iOS
113 * Tizen
114 * Windows Phone 7 y 8
115 * Windows 8
116
117### Ejemplo rápido
118
119 // Depending on the device, a few examples are:
120 // - "Android"
121 // - "BlackBerry 10"
122 // - Browser: returns "MacIntel" on Mac
123 // returns "Win32" on Windows
124 // - "iOS"
125 // - "WinCE"
126 // - "Tizen"
127 var devicePlatform = device.platform;
128
129
130### Windows Phone 7 rarezas
131
132Dispositivos Windows Phone 7 informe de la plataforma como `WinCE`.
133
134### Windows Phone 8 rarezas
135
136Dispositivos Windows Phone 8 Informe la plataforma como `Win32NT`.
137
138## device.uuid
139
140Obtener identificador universalmente única del dispositivo ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)).
141
142 var string = device.uuid;
143
144
145### Descripción
146
147Los detalles de cómo se genera un UUID son determinados por el fabricante del dispositivo y son específicos a la plataforma del dispositivo o modelo.
148
149### Plataformas soportadas
150
151 * Android
152 * BlackBerry 10
153 * iOS
154 * Tizen
155 * Windows Phone 7 y 8
156 * Windows 8
157
158### Ejemplo rápido
159
160 // Android: Returns a random 64-bit integer (as a string, again!)
161 // The integer is generated on the device's first boot
162 //
163 // BlackBerry: Returns the PIN number of the device
164 // This is a nine-digit unique integer (as a string, though!)
165 //
166 // iPhone: (Paraphrased from the UIDevice Class documentation)
167 // Returns a string of hash values created from multiple hardware identifies.
168 // It is guaranteed to be unique for every device and can't be tied
169 // to the user account.
170 // Windows Phone 7 : Returns a hash of device+current user,
171 // if the user is not defined, a guid is generated and will persist until the app is uninstalled
172 // Tizen: returns the device IMEI (International Mobile Equipment Identity or IMEI is a number
173 // unique to every GSM and UMTS mobile phone.
174 var deviceID = device.uuid;
175
176
177### Rarezas de iOS
178
179El `uuid` en iOS no es exclusiva de un dispositivo, pero varía para cada aplicación, para cada instalación. Cambia si puedes borrar y volver a instalar la aplicación, y posiblemente también cuándo actualizar iOS, o incluso mejorar la aplicación por la versión (evidente en iOS 5.1). El `uuid` no es un valor confiable.
180
181### Windows Phone 7 y 8 rarezas
182
183El `uuid` para Windows Phone 7 requiere el permiso `ID_CAP_IDENTITY_DEVICE`. Microsoft pronto probablemente desaprueban esta propiedad. Si la capacidad no está disponible, la aplicación genera un guid persistente que se mantiene durante la duración de la instalación de la aplicación en el dispositivo.
184
185## device.version
186
187Obtener la versión del sistema operativo.
188
189 var string = device.version;
190
191
192### Plataformas soportadas
193
194 * Android 2.1 +
195 * BlackBerry 10
196 * Explorador
197 * iOS
198 * Tizen
199 * Windows Phone 7 y 8
200 * Windows 8
201
202### Ejemplo rápido
203
204 // Android: Froyo OS would return "2.2"
205 // Eclair OS would return "2.1", "2.0.1", or "2.0"
206 // Version can also return update level "2.1-update1"
207 //
208 // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
209 //
210 // Browser: Returns version number for the browser
211 //
212 // iPhone: iOS 3.2 returns "3.2"
213 //
214 // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
215 // Tizen: returns "TIZEN_20120425_2"
216 var deviceVersion = device.version;