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.5 KiB

8 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. 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.
  19. document.addEventListener("deviceready", onDeviceReady, false);
  20. function onDeviceReady() {
  21. console.log(device.cordova);
  22. }
  23. ## Instalacja
  24. cordova plugin add cordova-plugin-device
  25. ## Właściwości
  26. * device.cordova
  27. * device.model
  28. * device.platform
  29. * device.uuid
  30. * device.version
  31. ## device.cordova
  32. Pobierz wersję Cordova działa na urządzeniu.
  33. ### Obsługiwane platformy
  34. * Amazon Fire OS
  35. * Android
  36. * BlackBerry 10
  37. * Przeglądarka
  38. * Firefox OS
  39. * iOS
  40. * Tizen
  41. * Windows Phone 7 i 8
  42. * Windows 8
  43. ## device.model
  44. `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.
  45. ### Obsługiwane platformy
  46. * Android
  47. * BlackBerry 10
  48. * Przeglądarka
  49. * iOS
  50. * Tizen
  51. * Windows Phone 7 i 8
  52. * Windows 8
  53. ### Szybki przykład
  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. Zobacz http://theiphonewiki.com/wiki/index.php?title=Models / / modelu var = device.model;
  60. ### Dziwactwa Androida
  61. * Pobiera [nazwę produktu][1] zamiast [nazwy modelu][2], który często jest nazwą kod produkcji. Na przykład, Nexus One zwraca `Passion` , i zwraca Motorola Droid`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. ### Dziwactwa Tizen
  65. * Zwraca modelu urządzenia przypisane przez dostawcę, na przykład,`TIZEN`
  66. ### Windows Phone 7 i 8 dziwactwa
  67. * Zwraca modelu urządzenia, określonej przez producenta. Na przykład Samsung ostrości zwraca`SGH-i917`.
  68. ## device.platform
  69. Uzyskać nazwę systemu operacyjnego urządzenia.
  70. var string = device.platform;
  71. ### Obsługiwane platformy
  72. * Android
  73. * BlackBerry 10
  74. * Browser4
  75. * Firefox OS
  76. * iOS
  77. * Tizen
  78. * Windows Phone 7 i 8
  79. * Windows 8
  80. ### Szybki przykład
  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. ### Dziwactwa Windows Phone 7
  91. Urządzenia Windows Phone 7 raport platformy jako`WinCE`.
  92. ### Windows Phone 8 dziwactwa
  93. Urządzenia Windows Phone 8 raport platformy jako`Win32NT`.
  94. ## device.uuid
  95. Się urządzenia uniwersalnie unikatowy identyfikator ([UUID][3]).
  96. [3]: 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: zwraca losowe 64-bitowa liczba całkowita (jako ciąg, znowu!) / / liczba całkowita jest generowany na pierwszego uruchomienia urządzenia / / / / BlackBerry: zwraca numer PIN urządzenia / / to jest unikatową liczbą całkowitą dziewięciu cyfr (jako ciąg, choć!) / / / / iPhone: (zacytowana w dokumentacji klasy UIDevice) / / zwraca ciąg wartości mieszania utworzone z wielu sprzętu identyfikuje.
  109. Zapewniona jest unikatowy dla każdego urządzenia i nie może być związane z / do konta użytkownika.
  110. / / Windows Phone 7: zwraca wartość mieszania urządzenia + bieżący użytkownik, / / jeśli nie zdefiniowane przez użytkownika, identyfikator guid jest generowany i będzie trwać do czasu odinstalowania aplikacji / / Tizen: zwraca urządzenia IMEI (International Mobile Equipment Identity lub IMEI jest liczbą / / unikatowe dla każdego telefonu komórkowego GSM i UMTS.
  111. var deviceID = device.uuid;
  112. ### iOS dziwactwo
  113. `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.
  114. ### Windows Phone 7 i 8 dziwactwa
  115. `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.
  116. ## device.version
  117. Pobierz wersję systemu operacyjnego.
  118. var string = device.version;
  119. ### Obsługiwane platformy
  120. * Android 2.1 +
  121. * BlackBerry 10
  122. * Przeglądarka
  123. * iOS
  124. * Tizen
  125. * Windows Phone 7 i 8
  126. * Windows 8
  127. ### Szybki przykład
  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;