Touchgui/plugins/org.apache.cordova.device/doc/it/index.md

changeset 0
e8ccd40d0ef6
equal deleted inserted replaced
-1:000000000000 0:eb7f07edea6a
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 # org.apache.cordova.device
21
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.
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 org.apache.cordova.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
45 Ottenere 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
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.
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
100 Ottenere 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
131 Windows Phone 7 dispositivi segnalano la piattaforma come`WinCE`.
132
133 ### Windows Phone 8 stranezze
134
135 Dispositivi Windows Phone 8 segnalano la piattaforma come`Win32NT`.
136
137 ## device.uuid
138
139 Ottenere 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
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.
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
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.
170
171 ### Windows Phone 7 e 8 stranezze
172
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.
174
175 ## device.version
176
177 Ottenere 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;

mercurial