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[![Build Status](https://travis-ci.org/apache/cordova-plugin-device.svg?branch=master)](https://travis-ci.org/apache/cordova-plugin-device)
 23
 24Questo 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.
 25
 26    document.addEventListener("deviceready", onDeviceReady, false);
 27    function onDeviceReady() {
 28        console.log(device.cordova);
 29    }
 30    
 31
 32## Installazione
 33
 34    cordova plugin add cordova-plugin-device
 35    
 36
 37## Proprietà
 38
 39  * device.cordova
 40  * device.model
 41  * device.platform
 42  * device.uuid
 43  * device.version
 44
 45## device.cordova
 46
 47Ottenere la versione di Cordova in esecuzione nel dispositivo.
 48
 49### Piattaforme supportate
 50
 51  * Amazon fuoco OS
 52  * Android
 53  * BlackBerry 10
 54  * Browser
 55  * Firefox OS
 56  * iOS
 57  * Tizen
 58  * Windows Phone 7 e 8
 59  * Windows 8
 60
 61## device.model
 62
 63Il `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.
 64
 65### Piattaforme supportate
 66
 67  * Android
 68  * BlackBerry 10
 69  * Browser
 70  * iOS
 71  * Tizen
 72  * Windows Phone 7 e 8
 73  * Windows 8
 74
 75### Esempio rapido
 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. Vedi http://theiphonewiki.com/wiki/index.php?title=Models / / modello var = device.model;
 83    
 84
 85### Stranezze Android
 86
 87  * Ottiene il [nome del prodotto](http://developer.android.com/reference/android/os/Build.html#PRODUCT) anziché il [nome del modello](http://developer.android.com/reference/android/os/Build.html#MODEL), che è spesso il nome di codice di produzione. Ad esempio, restituisce il Nexus One `Passion` , e Motorola Droid restituisce`voles`.
 88
 89### Tizen stranezze
 90
 91  * Restituisce il modello di dispositivo assegnato dal fornitore, ad esempio,`TIZEN`
 92
 93### Windows Phone 7 e 8 stranezze
 94
 95  * Restituisce il modello di dispositivo specificato dal produttore. Ad esempio, restituisce il Samsung Focus`SGH-i917`.
 96
 97## device.platform
 98
 99Ottenere il nome del sistema operativo del dispositivo.
100
101    var string = device.platform;
102    
103
104### Piattaforme supportate
105
106  * Android
107  * BlackBerry 10
108  * Browser4
109  * Firefox OS
110  * iOS
111  * Tizen
112  * Windows Phone 7 e 8
113  * Windows 8
114
115### Esempio rapido
116
117    // Depending on the device, a few examples are:
118    //   - "Android"
119    //   - "BlackBerry 10"
120    //   - Browser:         returns "MacIntel" on Mac
121    //                      returns "Win32" on Windows
122    //   - "iOS"
123    //   - "WinCE"
124    //   - "Tizen"
125    var devicePlatform = device.platform;
126    
127
128### Windows Phone 7 capricci
129
130Windows Phone 7 dispositivi segnalano la piattaforma come`WinCE`.
131
132### Windows Phone 8 stranezze
133
134Dispositivi Windows Phone 8 segnalano la piattaforma come`Win32NT`.
135
136## device.uuid
137
138Ottenere identificatore del dispositivo univoco universale ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)).
139
140    var string = device.uuid;
141    
142
143### Descrizione
144
145I dettagli di come viene generato un UUID sono determinati dal produttore del dispositivo e sono specifici per la piattaforma o il modello del dispositivo.
146
147### Piattaforme supportate
148
149  * Android
150  * BlackBerry 10
151  * iOS
152  * Tizen
153  * Windows Phone 7 e 8
154  * Windows 8
155
156### Esempio rapido
157
158    / / 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.
159    / / È garantito per essere unica per ogni dispositivo e non può essere legato / / per l'account utente.
160    / / 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.
161    var deviceID = device.uuid;
162    
163
164### iOS Quirk
165
166Il `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.
167
168### Windows Phone 7 e 8 stranezze
169
170Il `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.
171
172## device.version
173
174Ottenere la versione del sistema operativo.
175
176    var string = device.version;
177    
178
179### Piattaforme supportate
180
181  * Android 2.1 +
182  * BlackBerry 10
183  * Browser
184  * iOS
185  * Tizen
186  * Windows Phone 7 e 8
187  * Windows 8
188
189### Esempio rapido
190
191    // Android:    Froyo OS would return "2.2"
192    //             Eclair OS would return "2.1", "2.0.1", or "2.0"
193    //             Version can also return update level "2.1-update1"
194    //
195    // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
196    //
197    // Browser:    Returns version number for the browser
198    //
199    // iPhone:     iOS 3.2 returns "3.2"
200    //
201    // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
202    // Tizen: returns "TIZEN_20120425_2"
203    var deviceVersion = device.version;