You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

206 lines
6.6 KiB

7 years ago
  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. http://www.apache.org/licenses/LICENSE-2.0
  10. Unless required by applicable law or agreed to in writing,
  11. software distributed under the License is distributed on an
  12. "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  13. KIND, either express or implied. See the License for the
  14. specific language governing permissions and limitations
  15. under the License.
  16. -->
  17. # cordova-plugin-device
  18. 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.
  19. document.addEventListener("deviceready", onDeviceReady, false);
  20. function onDeviceReady() {
  21. console.log(device.cordova);
  22. }
  23. ## Installazione
  24. cordova plugin add cordova-plugin-device
  25. ## Proprietà
  26. * device.cordova
  27. * device.model
  28. * device.platform
  29. * device.uuid
  30. * device.version
  31. ## device.cordova
  32. Ottenere la versione di Cordova in esecuzione nel dispositivo.
  33. ### Piattaforme supportate
  34. * Amazon fuoco OS
  35. * Android
  36. * BlackBerry 10
  37. * Browser
  38. * Firefox OS
  39. * iOS
  40. * Tizen
  41. * Windows Phone 7 e 8
  42. * Windows 8
  43. ## device.model
  44. 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.
  45. ### Piattaforme supportate
  46. * Android
  47. * BlackBerry 10
  48. * Browser
  49. * iOS
  50. * Tizen
  51. * Windows Phone 7 e 8
  52. * Windows 8
  53. ### Esempio rapido
  54. // Android: Nexus One returns "Passion" (Nexus One code name)
  55. // Motorola Droid returns "voles"
  56. // BlackBerry: Torch 9800 returns "9800"
  57. // Browser: Google Chrome returns "Chrome"
  58. // Safari returns "Safari"
  59. // 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;
  60. ### Stranezze Android
  61. * 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`.
  62. [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
  63. [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
  64. ### Tizen stranezze
  65. * Restituisce il modello di dispositivo assegnato dal fornitore, ad esempio,`TIZEN`
  66. ### Windows Phone 7 e 8 stranezze
  67. * Restituisce il modello di dispositivo specificato dal produttore. Ad esempio, restituisce il Samsung Focus`SGH-i917`.
  68. ## device.platform
  69. Ottenere il nome del sistema operativo del dispositivo.
  70. var string = device.platform;
  71. ### Piattaforme supportate
  72. * Android
  73. * BlackBerry 10
  74. * Browser4
  75. * Firefox OS
  76. * iOS
  77. * Tizen
  78. * Windows Phone 7 e 8
  79. * Windows 8
  80. ### Esempio rapido
  81. // Depending on the device, a few examples are:
  82. // - "Android"
  83. // - "BlackBerry 10"
  84. // - Browser: returns "MacIntel" on Mac
  85. // returns "Win32" on Windows
  86. // - "iOS"
  87. // - "WinCE"
  88. // - "Tizen"
  89. var devicePlatform = device.platform;
  90. ### Windows Phone 7 capricci
  91. Windows Phone 7 dispositivi segnalano la piattaforma come`WinCE`.
  92. ### Windows Phone 8 stranezze
  93. Dispositivi Windows Phone 8 segnalano la piattaforma come`Win32NT`.
  94. ## device.uuid
  95. Ottenere identificatore del dispositivo univoco universale ([UUID][3]).
  96. [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
  97. var string = device.uuid;
  98. ### Descrizione
  99. 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.
  100. ### Piattaforme supportate
  101. * Android
  102. * BlackBerry 10
  103. * iOS
  104. * Tizen
  105. * Windows Phone 7 e 8
  106. * Windows 8
  107. ### Esempio rapido
  108. / / 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.
  109. / / È garantito per essere unica per ogni dispositivo e non può essere legato / / per l'account utente.
  110. / / 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.
  111. var deviceID = device.uuid;
  112. ### iOS Quirk
  113. 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.
  114. ### Windows Phone 7 e 8 stranezze
  115. 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.
  116. ## device.version
  117. Ottenere la versione del sistema operativo.
  118. var string = device.version;
  119. ### Piattaforme supportate
  120. * Android 2.1 +
  121. * BlackBerry 10
  122. * Browser
  123. * iOS
  124. * Tizen
  125. * Windows Phone 7 e 8
  126. * Windows 8
  127. ### Esempio rapido
  128. // Android: Froyo OS would return "2.2"
  129. // Eclair OS would return "2.1", "2.0.1", or "2.0"
  130. // Version can also return update level "2.1-update1"
  131. //
  132. // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
  133. //
  134. // Browser: Returns version number for the browser
  135. //
  136. // iPhone: iOS 3.2 returns "3.2"
  137. //
  138. // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
  139. // Tizen: returns "TIZEN_20120425_2"
  140. var deviceVersion = device.version;