Thu, 04 Jun 2015 14:50:33 +0200
Genesis of lecture sources for Droidcon Berlin 2015 in Postbahnhof.
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
10 http://www.apache.org/licenses/LICENSE-2.0
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 -->
20 # org.apache.cordova.device
22 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.
24 document.addEventListener("deviceready", onDeviceReady, false);
25 function onDeviceReady() {
26 console.log(device.cordova);
27 }
30 ## Installazione
32 cordova plugin add org.apache.cordova.device
35 ## Proprietà
37 * device.cordova
38 * device.model
39 * device.platform
40 * device.uuid
41 * device.version
43 ## device.cordova
45 Ottenere la versione di Cordova in esecuzione nel dispositivo.
47 ### Piattaforme supportate
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
59 ## device.model
61 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.
63 ### Piattaforme supportate
65 * Android
66 * BlackBerry 10
67 * Browser
68 * iOS
69 * Tizen
70 * Windows Phone 7 e 8
71 * Windows 8
73 ### Esempio rapido
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;
83 ### Stranezze Android
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`.
87 [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
88 [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
90 ### Tizen stranezze
92 * Restituisce il modello di dispositivo assegnato dal fornitore, ad esempio,`TIZEN`
94 ### Windows Phone 7 e 8 stranezze
96 * Restituisce il modello di dispositivo specificato dal produttore. Ad esempio, restituisce il Samsung Focus`SGH-i917`.
98 ## device.platform
100 Ottenere il nome del sistema operativo del dispositivo.
102 var string = device.platform;
105 ### Piattaforme supportate
107 * Android
108 * BlackBerry 10
109 * Browser4
110 * Firefox OS
111 * iOS
112 * Tizen
113 * Windows Phone 7 e 8
114 * Windows 8
116 ### Esempio rapido
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;
129 ### Windows Phone 7 capricci
131 Windows Phone 7 dispositivi segnalano la piattaforma come`WinCE`.
133 ### Windows Phone 8 stranezze
135 Dispositivi Windows Phone 8 segnalano la piattaforma come`Win32NT`.
137 ## device.uuid
139 Ottenere identificatore del dispositivo univoco universale ([UUID][3]).
141 [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
143 var string = device.uuid;
146 ### Descrizione
148 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.
150 ### Piattaforme supportate
152 * Android
153 * BlackBerry 10
154 * iOS
155 * Tizen
156 * Windows Phone 7 e 8
157 * Windows 8
159 ### Esempio rapido
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;
167 ### iOS Quirk
169 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.
171 ### Windows Phone 7 e 8 stranezze
173 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.
175 ## device.version
177 Ottenere la versione del sistema operativo.
179 var string = device.version;
182 ### Piattaforme supportate
184 * Android 2.1 +
185 * BlackBerry 10
186 * Browser
187 * iOS
188 * Tizen
189 * Windows Phone 7 e 8
190 * Windows 8
192 ### Esempio rapido
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;