1<!---
  2    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
 22Questo plugin definisce un global `device` oggetto che descrive il dispositivo hardware e software. Sebbene l'oggetto sia in ambito globale, non è disponibile fino a dopo il `deviceready` evento.
 23
 24    document.addEventListener("deviceready", onDeviceReady, false);
 25    function onDeviceReady() {
 26        console.log(device.cordova);
 27    }
 28    
 29
 30## Installazione
 31
 32    cordova plugin add cordova-plugin-device
 33    
 34
 35## Proprietà
 36
 37*   device.cordova
 38*   device.model
 39*   device.platform
 40*   device.uuid
 41*   device.version
 42
 43## device.cordova
 44
 45Ottenere la versione di Cordova in esecuzione nel dispositivo.
 46
 47### Piattaforme supportate
 48
 49*   Amazon fuoco OS
 50*   Android
 51*   BlackBerry 10
 52*   Browser
 53*   Firefox OS
 54*   iOS
 55*   Tizen
 56*   Windows Phone 7 e 8
 57*   Windows 8
 58
 59## device.model
 60
 61Il `device.model` restituisce il nome del modello del dispositivo o del prodotto. Il valore viene impostato dal produttore del dispositivo e può essere differente tra le versioni dello stesso prodotto.
 62
 63### Piattaforme supportate
 64
 65*   Android
 66*   BlackBerry 10
 67*   Browser
 68*   iOS
 69*   Tizen
 70*   Windows Phone 7 e 8
 71*   Windows 8
 72
 73### Esempio rapido
 74
 75    // Android:    Nexus One       returns "Passion" (Nexus One code name)
 76    //             Motorola Droid  returns "voles"
 77    // BlackBerry: Torch 9800      returns "9800"
 78    // Browser:    Google Chrome   returns "Chrome"
 79    //             Safari          returns "Safari"
 80    // iOS:     for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Vedi http://theiphonewiki.com/wiki/index.php?title=Models / / modello var = device.model;
 81    
 82
 83### Stranezze Android
 84
 85*   Ottiene il [nome del prodotto][1] anziché il [nome del modello][2], che è spesso il nome di codice di produzione. Ad esempio, restituisce il Nexus One `Passion` , e Motorola Droid restituisce`voles`.
 86
 87 [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
 88 [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
 89
 90### Tizen stranezze
 91
 92*   Restituisce il modello di dispositivo assegnato dal fornitore, ad esempio,`TIZEN`
 93
 94### Windows Phone 7 e 8 stranezze
 95
 96*   Restituisce il modello di dispositivo specificato dal produttore. Ad esempio, restituisce il Samsung Focus`SGH-i917`.
 97
 98## device.platform
 99
100Ottenere il nome del sistema operativo del dispositivo.
101
102    var string = device.platform;
103    
104
105### Piattaforme supportate
106
107*   Android
108*   BlackBerry 10
109*   Browser4
110*   Firefox OS
111*   iOS
112*   Tizen
113*   Windows Phone 7 e 8
114*   Windows 8
115
116### Esempio rapido
117
118    // Depending on the device, a few examples are:
119    //   - "Android"
120    //   - "BlackBerry 10"
121    //   - Browser:         returns "MacIntel" on Mac
122    //                      returns "Win32" on Windows
123    //   - "iOS"
124    //   - "WinCE"
125    //   - "Tizen"
126    var devicePlatform = device.platform;
127    
128
129### Windows Phone 7 capricci
130
131Windows Phone 7 dispositivi segnalano la piattaforma come`WinCE`.
132
133### Windows Phone 8 stranezze
134
135Dispositivi Windows Phone 8 segnalano la piattaforma come`Win32NT`.
136
137## device.uuid
138
139Ottenere identificatore del dispositivo univoco universale ([UUID][3]).
140
141 [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
142
143    var string = device.uuid;
144    
145
146### Descrizione
147
148I dettagli di come viene generato un UUID sono determinati dal produttore del dispositivo e sono specifici per la piattaforma o il modello del dispositivo.
149
150### Piattaforme supportate
151
152*   Android
153*   BlackBerry 10
154*   iOS
155*   Tizen
156*   Windows Phone 7 e 8
157*   Windows 8
158
159### Esempio rapido
160
161    / / Android: restituisce un intero casuale di 64 bit (come stringa, ancora una volta!) / / il numero intero è generato al primo avvio del dispositivo / / / / BlackBerry: restituisce il numero PIN del dispositivo / / questo è un valore integer univoco a nove cifre (come stringa, benchè!) / / / / iPhone: (parafrasato dalla documentazione della classe UIDevice) / / restituisce una stringa di valori hash creata dall'hardware più identifica.
162    / / È garantito per essere unica per ogni dispositivo e non può essere legato / / per l'account utente.
163    / / Windows Phone 7: restituisce un hash dell'utente corrente, + dispositivo / / se l'utente non è definito, un guid generato e persisterà fino a quando l'applicazione viene disinstallata / / Tizen: restituisce il dispositivo IMEI (International Mobile Equipment Identity o IMEI è un numero / / unico per ogni cellulare GSM e UMTS.
164    var deviceID = device.uuid;
165    
166
167### iOS Quirk
168
169Il `uuid` su iOS non è univoco per un dispositivo, ma varia per ogni applicazione, per ogni installazione. Cambia se si elimina e re-installare l'app, e possibilmente anche quando aggiornare iOS o anche aggiornare l'app per ogni versione (apparente in iOS 5.1). Il `uuid` non è un valore affidabile.
170
171### Windows Phone 7 e 8 stranezze
172
173Il `uuid` per Windows Phone 7 richiede l'autorizzazione `ID_CAP_IDENTITY_DEVICE` . Microsoft probabilmente sarà presto deprecare questa proprietà. Se la funzionalità non è disponibile, l'applicazione genera un guid persistente che viene mantenuto per la durata dell'installazione dell'applicazione sul dispositivo.
174
175## device.version
176
177Ottenere la versione del sistema operativo.
178
179    var string = device.version;
180    
181
182### Piattaforme supportate
183
184*   Android 2.1 +
185*   BlackBerry 10
186*   Browser
187*   iOS
188*   Tizen
189*   Windows Phone 7 e 8
190*   Windows 8
191
192### Esempio rapido
193
194    // Android:    Froyo OS would return "2.2"
195    //             Eclair OS would return "2.1", "2.0.1", or "2.0"
196    //             Version can also return update level "2.1-update1"
197    //
198    // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
199    //
200    // Browser:    Returns version number for the browser
201    //
202    // iPhone:     iOS 3.2 returns "3.2"
203    //
204    // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
205    // Tizen: returns "TIZEN_20120425_2"
206    var deviceVersion = device.version;