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

Thu, 04 Jun 2015 14:50:33 +0200

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Thu, 04 Jun 2015 14:50:33 +0200
changeset 0
e8ccd40d0ef6
permissions
-rw-r--r--

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;

mercurial