michael@0: <!---
michael@0:     Licensed to the Apache Software Foundation (ASF) under one
michael@0:     or more contributor license agreements.  See the NOTICE file
michael@0:     distributed with this work for additional information
michael@0:     regarding copyright ownership.  The ASF licenses this file
michael@0:     to you under the Apache License, Version 2.0 (the
michael@0:     "License"); you may not use this file except in compliance
michael@0:     with the License.  You may obtain a copy of the License at
michael@0: 
michael@0:       http://www.apache.org/licenses/LICENSE-2.0
michael@0: 
michael@0:     Unless required by applicable law or agreed to in writing,
michael@0:     software distributed under the License is distributed on an
michael@0:     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0:     KIND, either express or implied.  See the License for the
michael@0:     specific language governing permissions and limitations
michael@0:     under the License.
michael@0: -->
michael@0: 
michael@0: # org.apache.cordova.device
michael@0: 
michael@0: Questo 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.
michael@0: 
michael@0:     document.addEventListener("deviceready", onDeviceReady, false);
michael@0:     function onDeviceReady() {
michael@0:         console.log(device.cordova);
michael@0:     }
michael@0:     
michael@0: 
michael@0: ## Installazione
michael@0: 
michael@0:     cordova plugin add org.apache.cordova.device
michael@0:     
michael@0: 
michael@0: ## Proprietà
michael@0: 
michael@0: *   device.cordova
michael@0: *   device.model
michael@0: *   device.platform
michael@0: *   device.uuid
michael@0: *   device.version
michael@0: 
michael@0: ## device.cordova
michael@0: 
michael@0: Ottenere la versione di Cordova in esecuzione nel dispositivo.
michael@0: 
michael@0: ### Piattaforme supportate
michael@0: 
michael@0: *   Amazon fuoco OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Browser
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 e 8
michael@0: *   Windows 8
michael@0: 
michael@0: ## device.model
michael@0: 
michael@0: Il `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.
michael@0: 
michael@0: ### Piattaforme supportate
michael@0: 
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Browser
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 e 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Esempio rapido
michael@0: 
michael@0:     // Android:    Nexus One       returns "Passion" (Nexus One code name)
michael@0:     //             Motorola Droid  returns "voles"
michael@0:     // BlackBerry: Torch 9800      returns "9800"
michael@0:     // Browser:    Google Chrome   returns "Chrome"
michael@0:     //             Safari          returns "Safari"
michael@0:     // 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;
michael@0:     
michael@0: 
michael@0: ### Stranezze Android
michael@0: 
michael@0: *   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`.
michael@0: 
michael@0:  [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
michael@0:  [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
michael@0: 
michael@0: ### Tizen stranezze
michael@0: 
michael@0: *   Restituisce il modello di dispositivo assegnato dal fornitore, ad esempio,`TIZEN`
michael@0: 
michael@0: ### Windows Phone 7 e 8 stranezze
michael@0: 
michael@0: *   Restituisce il modello di dispositivo specificato dal produttore. Ad esempio, restituisce il Samsung Focus`SGH-i917`.
michael@0: 
michael@0: ## device.platform
michael@0: 
michael@0: Ottenere il nome del sistema operativo del dispositivo.
michael@0: 
michael@0:     var string = device.platform;
michael@0:     
michael@0: 
michael@0: ### Piattaforme supportate
michael@0: 
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Browser4
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 e 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Esempio rapido
michael@0: 
michael@0:     // Depending on the device, a few examples are:
michael@0:     //   - "Android"
michael@0:     //   - "BlackBerry 10"
michael@0:     //   - Browser:         returns "MacIntel" on Mac
michael@0:     //                      returns "Win32" on Windows
michael@0:     //   - "iOS"
michael@0:     //   - "WinCE"
michael@0:     //   - "Tizen"
michael@0:     var devicePlatform = device.platform;
michael@0:     
michael@0: 
michael@0: ### Windows Phone 7 capricci
michael@0: 
michael@0: Windows Phone 7 dispositivi segnalano la piattaforma come`WinCE`.
michael@0: 
michael@0: ### Windows Phone 8 stranezze
michael@0: 
michael@0: Dispositivi Windows Phone 8 segnalano la piattaforma come`Win32NT`.
michael@0: 
michael@0: ## device.uuid
michael@0: 
michael@0: Ottenere identificatore del dispositivo univoco universale ([UUID][3]).
michael@0: 
michael@0:  [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
michael@0: 
michael@0:     var string = device.uuid;
michael@0:     
michael@0: 
michael@0: ### Descrizione
michael@0: 
michael@0: I dettagli di come viene generato un UUID sono determinati dal produttore del dispositivo e sono specifici per la piattaforma o il modello del dispositivo.
michael@0: 
michael@0: ### Piattaforme supportate
michael@0: 
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 e 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Esempio rapido
michael@0: 
michael@0:     / / 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.
michael@0:     / / È garantito per essere unica per ogni dispositivo e non può essere legato / / per l'account utente.
michael@0:     / / 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.
michael@0:     var deviceID = device.uuid;
michael@0:     
michael@0: 
michael@0: ### iOS Quirk
michael@0: 
michael@0: Il `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.
michael@0: 
michael@0: ### Windows Phone 7 e 8 stranezze
michael@0: 
michael@0: Il `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.
michael@0: 
michael@0: ## device.version
michael@0: 
michael@0: Ottenere la versione del sistema operativo.
michael@0: 
michael@0:     var string = device.version;
michael@0:     
michael@0: 
michael@0: ### Piattaforme supportate
michael@0: 
michael@0: *   Android 2.1 +
michael@0: *   BlackBerry 10
michael@0: *   Browser
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 e 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Esempio rapido
michael@0: 
michael@0:     // Android:    Froyo OS would return "2.2"
michael@0:     //             Eclair OS would return "2.1", "2.0.1", or "2.0"
michael@0:     //             Version can also return update level "2.1-update1"
michael@0:     //
michael@0:     // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
michael@0:     //
michael@0:     // Browser:    Returns version number for the browser
michael@0:     //
michael@0:     // iPhone:     iOS 3.2 returns "3.2"
michael@0:     //
michael@0:     // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
michael@0:     // Tizen: returns "TIZEN_20120425_2"
michael@0:     var deviceVersion = device.version;