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.

213 lines
6.7 KiB

8 years ago
  1. <!--
  2. # license: 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. # cordova-plugin-device
  20. [![Build Status](https://travis-ci.org/apache/cordova-plugin-device.svg?branch=master)](https://travis-ci.org/apache/cordova-plugin-device)
  21. Ten plugin określa globalne `device` obiekt, który opisuje urządzenia sprzętowe i programowe. Mimo, że obiekt jest w globalnym zasięgu, nie jest dostępne dopiero po `deviceready` zdarzenie.
  22. document.addEventListener("deviceready", onDeviceReady, false);
  23. function onDeviceReady() {
  24. console.log(device.cordova);
  25. }
  26. ## Instalacja
  27. cordova plugin add cordova-plugin-device
  28. ## Właściwości
  29. * device.cordova
  30. * device.model
  31. * device.platform
  32. * device.uuid
  33. * device.version
  34. ## device.cordova
  35. Pobierz wersję Cordova działa na urządzeniu.
  36. ### Obsługiwane platformy
  37. * Amazon Fire OS
  38. * Android
  39. * BlackBerry 10
  40. * Przeglądarka
  41. * Firefox OS
  42. * iOS
  43. * Tizen
  44. * Windows Phone 7 i 8
  45. * Windows 8
  46. ## device.model
  47. `device.model`Zwraca nazwę modelu lub produktu. Wartość jest zestaw przez producenta urządzenia i mogą się różnić między wersjami tego samego produktu.
  48. ### Obsługiwane platformy
  49. * Android
  50. * BlackBerry 10
  51. * Przeglądarka
  52. * iOS
  53. * Tizen
  54. * Windows Phone 7 i 8
  55. * Windows 8
  56. ### Szybki przykład
  57. // Android: Nexus One returns "Passion" (Nexus One code name)
  58. // Motorola Droid returns "voles"
  59. // BlackBerry: Torch 9800 returns "9800"
  60. // Browser: Google Chrome returns "Chrome"
  61. // Safari returns "Safari"
  62. // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Zobacz http://theiphonewiki.com/wiki/index.php?title=Models / / modelu var = device.model;
  63. ### Dziwactwa Androida
  64. * Pobiera [nazwę produktu](http://developer.android.com/reference/android/os/Build.html#PRODUCT) zamiast [nazwy modelu](http://developer.android.com/reference/android/os/Build.html#MODEL), który często jest nazwą kod produkcji. Na przykład, Nexus One zwraca `Passion` , i zwraca Motorola Droid`voles`.
  65. ### Dziwactwa Tizen
  66. * Zwraca modelu urządzenia przypisane przez dostawcę, na przykład,`TIZEN`
  67. ### Windows Phone 7 i 8 dziwactwa
  68. * Zwraca modelu urządzenia, określonej przez producenta. Na przykład Samsung ostrości zwraca`SGH-i917`.
  69. ## device.platform
  70. Uzyskać nazwę systemu operacyjnego urządzenia.
  71. var string = device.platform;
  72. ### Obsługiwane platformy
  73. * Android
  74. * BlackBerry 10
  75. * Browser4
  76. * Firefox OS
  77. * iOS
  78. * Tizen
  79. * Windows Phone 7 i 8
  80. * Windows 8
  81. ### Szybki przykład
  82. // Depending on the device, a few examples are:
  83. // - "Android"
  84. // - "BlackBerry 10"
  85. // - Browser: returns "MacIntel" on Mac
  86. // returns "Win32" on Windows
  87. // - "iOS"
  88. // - "WinCE"
  89. // - "Tizen"
  90. var devicePlatform = device.platform;
  91. ### Dziwactwa Windows Phone 7
  92. Urządzenia Windows Phone 7 raport platformy jako`WinCE`.
  93. ### Windows Phone 8 dziwactwa
  94. Urządzenia Windows Phone 8 raport platformy jako`Win32NT`.
  95. ## device.uuid
  96. Się urządzenia uniwersalnie unikatowy identyfikator ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)).
  97. var string = device.uuid;
  98. ### Opis
  99. Szczegóły jak UUID jest generowane są określane przez producenta urządzenia i są specyficzne dla platformy lub modelu urządzenia.
  100. ### Obsługiwane platformy
  101. * Android
  102. * BlackBerry 10
  103. * iOS
  104. * Tizen
  105. * Windows Phone 7 i 8
  106. * Windows 8
  107. ### Szybki przykład
  108. // Android: Returns a random 64-bit integer (as a string, again!)
  109. // The integer is generated on the device's first boot
  110. //
  111. // BlackBerry: Returns the PIN number of the device
  112. // This is a nine-digit unique integer (as a string, though!)
  113. //
  114. // iPhone: (Paraphrased from the UIDevice Class documentation)
  115. // Returns a string of hash values created from multiple hardware identifies.
  116. // It is guaranteed to be unique for every device and can't be tied
  117. // to the user account.
  118. // Windows Phone 7 : Returns a hash of device+current user,
  119. // if the user is not defined, a guid is generated and will persist until the app is uninstalled
  120. // Tizen: returns the device IMEI (International Mobile Equipment Identity or IMEI is a number
  121. // unique to every GSM and UMTS mobile phone.
  122. var deviceID = device.uuid;
  123. ### iOS dziwactwo
  124. `uuid`Na iOS nie jest przypisany do urządzenia, ale różni się dla każdej aplikacji, dla każdej instalacji. Zmienia się jeśli możesz usunąć i ponownie zainstalować aplikację, a ewentualnie także po aktualizacji iOS czy nawet uaktualnienia aplikacji dla wersji (widoczny w iOS 5.1). `uuid`Jest nie wiarygodne wartości.
  125. ### Windows Phone 7 i 8 dziwactwa
  126. `uuid`Dla Windows Phone 7 wymaga uprawnień `ID_CAP_IDENTITY_DEVICE` . Microsoft będzie prawdopodobnie potępiać ten wkrótce. Jeśli funkcja nie jest dostępna, aplikacja generuje trwałe identyfikator guid, który jest utrzymywany przez czas trwania instalacji aplikacji na urządzeniu.
  127. ## device.version
  128. Pobierz wersję systemu operacyjnego.
  129. var string = device.version;
  130. ### Obsługiwane platformy
  131. * Android 2.1 +
  132. * BlackBerry 10
  133. * Przeglądarka
  134. * iOS
  135. * Tizen
  136. * Windows Phone 7 i 8
  137. * Windows 8
  138. ### Szybki przykład
  139. // Android: Froyo OS would return "2.2"
  140. // Eclair OS would return "2.1", "2.0.1", or "2.0"
  141. // Version can also return update level "2.1-update1"
  142. //
  143. // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
  144. //
  145. // Browser: Returns version number for the browser
  146. //
  147. // iPhone: iOS 3.2 returns "3.2"
  148. //
  149. // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
  150. // Tizen: returns "TIZEN_20120425_2"
  151. var deviceVersion = device.version;