.. | ||
index.md | ||
README.md |
cordova-plugin-device
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.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(device.cordova);
}
Installazione
cordova plugin add cordova-plugin-device
Proprietà
- device.cordova
- device.model
- device.platform
- device.uuid
- device.version
device.cordova
Ottenere la versione di Cordova in esecuzione nel dispositivo.
Piattaforme supportate
- Amazon fuoco OS
- Android
- BlackBerry 10
- Browser
- Firefox OS
- iOS
- Tizen
- Windows Phone 7 e 8
- Windows 8
device.model
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.
Piattaforme supportate
- Android
- BlackBerry 10
- Browser
- iOS
- Tizen
- Windows Phone 7 e 8
- Windows 8
Esempio rapido
// Android: Nexus One returns "Passion" (Nexus One code name)
// Motorola Droid returns "voles"
// BlackBerry: Torch 9800 returns "9800"
// Browser: Google Chrome returns "Chrome"
// Safari returns "Safari"
// 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;
Stranezze Android
- Ottiene il nome del prodotto anziché il nome del modello, che è spesso il nome di codice di produzione. Ad esempio, restituisce il Nexus One
Passion
, e Motorola Droid restituiscevoles
.
Tizen stranezze
- Restituisce il modello di dispositivo assegnato dal fornitore, ad esempio,
TIZEN
Windows Phone 7 e 8 stranezze
- Restituisce il modello di dispositivo specificato dal produttore. Ad esempio, restituisce il Samsung Focus
SGH-i917
.
device.platform
Ottenere il nome del sistema operativo del dispositivo.
var string = device.platform;
Piattaforme supportate
- Android
- BlackBerry 10
- Browser4
- Firefox OS
- iOS
- Tizen
- Windows Phone 7 e 8
- Windows 8
Esempio rapido
// Depending on the device, a few examples are:
// - "Android"
// - "BlackBerry 10"
// - Browser: returns "MacIntel" on Mac
// returns "Win32" on Windows
// - "iOS"
// - "WinCE"
// - "Tizen"
var devicePlatform = device.platform;
Windows Phone 7 capricci
Windows Phone 7 dispositivi segnalano la piattaforma comeWinCE
.
Windows Phone 8 stranezze
Dispositivi Windows Phone 8 segnalano la piattaforma comeWin32NT
.
device.uuid
Ottenere identificatore del dispositivo univoco universale (UUID).
var string = device.uuid;
Descrizione
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.
Piattaforme supportate
- Android
- BlackBerry 10
- iOS
- Tizen
- Windows Phone 7 e 8
- Windows 8
Esempio rapido
/ / 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.
/ / È garantito per essere unica per ogni dispositivo e non può essere legato / / per l'account utente.
/ / 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.
var deviceID = device.uuid;
iOS Quirk
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.
Windows Phone 7 e 8 stranezze
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.
device.version
Ottenere la versione del sistema operativo.
var string = device.version;
Piattaforme supportate
- Android 2.1 +
- BlackBerry 10
- Browser
- iOS
- Tizen
- Windows Phone 7 e 8
- Windows 8
Esempio rapido
// Android: Froyo OS would return "2.2"
// Eclair OS would return "2.1", "2.0.1", or "2.0"
// Version can also return update level "2.1-update1"
//
// BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
//
// Browser: Returns version number for the browser
//
// iPhone: iOS 3.2 returns "3.2"
//
// Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
// Tizen: returns "TIZEN_20120425_2"
var deviceVersion = device.version;