1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/Touchgui/plugins/org.apache.cordova.device/doc/it/index.md Thu Jun 04 14:50:33 2015 +0200
1.3 @@ -0,0 +1,206 @@
1.4 +<!---
1.5 + Licensed to the Apache Software Foundation (ASF) under one
1.6 + or more contributor license agreements. See the NOTICE file
1.7 + distributed with this work for additional information
1.8 + regarding copyright ownership. The ASF licenses this file
1.9 + to you under the Apache License, Version 2.0 (the
1.10 + "License"); you may not use this file except in compliance
1.11 + with the License. You may obtain a copy of the License at
1.12 +
1.13 + http://www.apache.org/licenses/LICENSE-2.0
1.14 +
1.15 + Unless required by applicable law or agreed to in writing,
1.16 + software distributed under the License is distributed on an
1.17 + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
1.18 + KIND, either express or implied. See the License for the
1.19 + specific language governing permissions and limitations
1.20 + under the License.
1.21 +-->
1.22 +
1.23 +# org.apache.cordova.device
1.24 +
1.25 +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.
1.26 +
1.27 + document.addEventListener("deviceready", onDeviceReady, false);
1.28 + function onDeviceReady() {
1.29 + console.log(device.cordova);
1.30 + }
1.31 +
1.32 +
1.33 +## Installazione
1.34 +
1.35 + cordova plugin add org.apache.cordova.device
1.36 +
1.37 +
1.38 +## Proprietà
1.39 +
1.40 +* device.cordova
1.41 +* device.model
1.42 +* device.platform
1.43 +* device.uuid
1.44 +* device.version
1.45 +
1.46 +## device.cordova
1.47 +
1.48 +Ottenere la versione di Cordova in esecuzione nel dispositivo.
1.49 +
1.50 +### Piattaforme supportate
1.51 +
1.52 +* Amazon fuoco OS
1.53 +* Android
1.54 +* BlackBerry 10
1.55 +* Browser
1.56 +* Firefox OS
1.57 +* iOS
1.58 +* Tizen
1.59 +* Windows Phone 7 e 8
1.60 +* Windows 8
1.61 +
1.62 +## device.model
1.63 +
1.64 +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.
1.65 +
1.66 +### Piattaforme supportate
1.67 +
1.68 +* Android
1.69 +* BlackBerry 10
1.70 +* Browser
1.71 +* iOS
1.72 +* Tizen
1.73 +* Windows Phone 7 e 8
1.74 +* Windows 8
1.75 +
1.76 +### Esempio rapido
1.77 +
1.78 + // Android: Nexus One returns "Passion" (Nexus One code name)
1.79 + // Motorola Droid returns "voles"
1.80 + // BlackBerry: Torch 9800 returns "9800"
1.81 + // Browser: Google Chrome returns "Chrome"
1.82 + // Safari returns "Safari"
1.83 + // 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;
1.84 +
1.85 +
1.86 +### Stranezze Android
1.87 +
1.88 +* 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`.
1.89 +
1.90 + [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
1.91 + [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
1.92 +
1.93 +### Tizen stranezze
1.94 +
1.95 +* Restituisce il modello di dispositivo assegnato dal fornitore, ad esempio,`TIZEN`
1.96 +
1.97 +### Windows Phone 7 e 8 stranezze
1.98 +
1.99 +* Restituisce il modello di dispositivo specificato dal produttore. Ad esempio, restituisce il Samsung Focus`SGH-i917`.
1.100 +
1.101 +## device.platform
1.102 +
1.103 +Ottenere il nome del sistema operativo del dispositivo.
1.104 +
1.105 + var string = device.platform;
1.106 +
1.107 +
1.108 +### Piattaforme supportate
1.109 +
1.110 +* Android
1.111 +* BlackBerry 10
1.112 +* Browser4
1.113 +* Firefox OS
1.114 +* iOS
1.115 +* Tizen
1.116 +* Windows Phone 7 e 8
1.117 +* Windows 8
1.118 +
1.119 +### Esempio rapido
1.120 +
1.121 + // Depending on the device, a few examples are:
1.122 + // - "Android"
1.123 + // - "BlackBerry 10"
1.124 + // - Browser: returns "MacIntel" on Mac
1.125 + // returns "Win32" on Windows
1.126 + // - "iOS"
1.127 + // - "WinCE"
1.128 + // - "Tizen"
1.129 + var devicePlatform = device.platform;
1.130 +
1.131 +
1.132 +### Windows Phone 7 capricci
1.133 +
1.134 +Windows Phone 7 dispositivi segnalano la piattaforma come`WinCE`.
1.135 +
1.136 +### Windows Phone 8 stranezze
1.137 +
1.138 +Dispositivi Windows Phone 8 segnalano la piattaforma come`Win32NT`.
1.139 +
1.140 +## device.uuid
1.141 +
1.142 +Ottenere identificatore del dispositivo univoco universale ([UUID][3]).
1.143 +
1.144 + [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
1.145 +
1.146 + var string = device.uuid;
1.147 +
1.148 +
1.149 +### Descrizione
1.150 +
1.151 +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.
1.152 +
1.153 +### Piattaforme supportate
1.154 +
1.155 +* Android
1.156 +* BlackBerry 10
1.157 +* iOS
1.158 +* Tizen
1.159 +* Windows Phone 7 e 8
1.160 +* Windows 8
1.161 +
1.162 +### Esempio rapido
1.163 +
1.164 + / / 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.
1.165 + / / È garantito per essere unica per ogni dispositivo e non può essere legato / / per l'account utente.
1.166 + / / 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.
1.167 + var deviceID = device.uuid;
1.168 +
1.169 +
1.170 +### iOS Quirk
1.171 +
1.172 +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.
1.173 +
1.174 +### Windows Phone 7 e 8 stranezze
1.175 +
1.176 +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.
1.177 +
1.178 +## device.version
1.179 +
1.180 +Ottenere la versione del sistema operativo.
1.181 +
1.182 + var string = device.version;
1.183 +
1.184 +
1.185 +### Piattaforme supportate
1.186 +
1.187 +* Android 2.1 +
1.188 +* BlackBerry 10
1.189 +* Browser
1.190 +* iOS
1.191 +* Tizen
1.192 +* Windows Phone 7 e 8
1.193 +* Windows 8
1.194 +
1.195 +### Esempio rapido
1.196 +
1.197 + // Android: Froyo OS would return "2.2"
1.198 + // Eclair OS would return "2.1", "2.0.1", or "2.0"
1.199 + // Version can also return update level "2.1-update1"
1.200 + //
1.201 + // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
1.202 + //
1.203 + // Browser: Returns version number for the browser
1.204 + //
1.205 + // iPhone: iOS 3.2 returns "3.2"
1.206 + //
1.207 + // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
1.208 + // Tizen: returns "TIZEN_20120425_2"
1.209 + var deviceVersion = device.version;
1.210 \ No newline at end of file
