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.

219 lines
8.9 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. Этот плагин определяет глобальный объект `device`, который описывает оборудование и программное обеспечение устройства. Несмотря на то что объект в глобальной области видимости, он не доступен до того момента пока не произойдет событие `deviceready`.
  19. document.addEventListener("deviceready", onDeviceReady, false);
  20. function onDeviceReady() {
  21. console.log(device.cordova);
  22. }
  23. ## Установка
  24. cordova plugin add cordova-plugin-device
  25. ## Параметры
  26. * device.cordova
  27. * device.model
  28. * device.platform
  29. * device.uuid
  30. * device.version
  31. ## device.cordova
  32. Возвращает версию Cordova, работающую на устройстве.
  33. ### Поддерживаемые платформы
  34. * Amazon Fire OS
  35. * Android
  36. * BlackBerry 10
  37. * Обозреватель
  38. * Firefox OS
  39. * iOS
  40. * Tizen
  41. * Windows Phone 7 и 8
  42. * Windows 8
  43. ## device.model
  44. Свойство `device.model` возвращает имя устройства модели или продукта. Значение устанавливается производителем устройства и могут отличаться в разных версиях одного и того же продукта.
  45. ### Поддерживаемые платформы
  46. * Android
  47. * BlackBerry 10
  48. * Обозреватель
  49. * iOS
  50. * Tizen
  51. * Windows Phone 7 и 8
  52. * Windows 8
  53. ### Краткий пример
  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. See http://theiphonewiki.com/wiki/index.php?title=Models
  60. //
  61. var model = device.model;
  62. ### Особенности Android
  63. * Возвращает [имя продукта][1] , а не [имя модели][2], которое часто является производственным кодом. Например, Nexus One из них возвращает `Passion` , и Motorola Droid возвращает `voles`.
  64. [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
  65. [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
  66. ### Особенности Tizen
  67. * Возвращает модель устройства, назначенного вендором, например,`TIZEN`
  68. ### Особенности Windows Phone 7 и 8
  69. * Возвращает модель устройства, указанной заводом-изготовителем. Например Samsung Focus возвращает `SGH-i917`.
  70. ## device.platform
  71. Получите имя операционной системы устройства.
  72. var string = device.platform;
  73. ### Поддерживаемые платформы
  74. * Android
  75. * BlackBerry 10
  76. * Браузером4
  77. * Firefox OS
  78. * iOS
  79. * Tizen
  80. * Windows Phone 7 и 8
  81. * Windows 8
  82. ### Краткий пример
  83. // Depending on the device, a few examples are:
  84. // - "Android"
  85. // - "BlackBerry 10"
  86. // - Browser: returns "MacIntel" on Mac
  87. // returns "Win32" on Windows
  88. // - "iOS"
  89. // - "WinCE"
  90. // - "Tizen"
  91. var devicePlatform = device.platform;
  92. ### Особенности Windows Phone 7
  93. Windows Phone 7 устройства сообщают платформу как `WinCE`.
  94. ### Особенности Windows Phone 8
  95. Устройства Windows Phone 8 сообщают платформу как `Win32NT`.
  96. ## device.uuid
  97. Возвращает универсальный уникального идентификатора ([UUID][3] устройства).
  98. [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
  99. var string = device.uuid;
  100. ### Описание
  101. Подробная информация о том как UUID генерируется, определяются изготовителем устройства и являются специфическими для платформы или модели устройства.
  102. ### Поддерживаемые платформы
  103. * Android
  104. * BlackBerry 10
  105. * iOS
  106. * Tizen
  107. * Windows Phone 7 и 8
  108. * Windows 8
  109. ### Краткий пример
  110. // Android: Возвращает случайное 64-разрядное целое число (в виде строки, опять!)
  111. // целое число генерируется при первой загрузке устройства
  112. //
  113. // BlackBerry: Возвращает номер PIN устройства
  114. // это 9 значный уникальный целочисленный (как строка, хотя!)
  115. //
  116. // iPhone: (Перефразировано из документации класса UIDevice)
  117. // возвращает строку хэш-значения, созданные из нескольких аппаратных определяет.
  118. // Это значение гарантированно является уникальным для каждого устройства и не может быть привязано
  119. // к учетной записи пользователя.
  120. // Windows Phone 7: Возвращает хэш устройство + текущего пользователя,
  121. // если пользователь не определен, формируется guid который и будет сохраняться до тех пор, пока приложение не удалиться
  122. // Tizen: возвращает IMEI устройства (Международный идентификатор мобильного оборудования или IMEI это число
  123. // уникальное для каждого мобильного телефона GSM и UMTS.
  124. var deviceID = device.uuid;
  125. ### Особенности iOS
  126. На iOS `uuid` не является уникальным для устройства, но варьируется для каждого приложения, и для каждой установки. Значение меняется, если удалить и повторно установить приложение, и возможно также когда вы обновите iOS, или даже обновить приложение до следующей версии (очевидно в iOS 5.1). Значение `uuid` не является надежным.
  127. ### Особенности Windows Phone 7 и 8
  128. Для Windows Phone 7 `uuid` требует разрешения `ID_CAP_IDENTITY_DEVICE` . Microsoft скорее всего скоро сделает это свойство устаревшим. Если возможность недоступна, приложение создает постоянные guid, который сохраняется на все время установки приложения на устройстве.
  129. ## device.version
  130. Возвращает версию операционной системы.
  131. var string = device.version;
  132. ### Поддерживаемые платформы
  133. * Android 2.1 +
  134. * BlackBerry 10
  135. * Обозреватель
  136. * iOS
  137. * Tizen
  138. * Windows Phone 7 и 8
  139. * Windows 8
  140. ### Краткий пример
  141. // Android: Froyo OS would return "2.2"
  142. // Eclair OS would return "2.1", "2.0.1", or "2.0"
  143. // Version can also return update level "2.1-update1"
  144. //
  145. // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
  146. //
  147. // Browser: Returns version number for the browser
  148. //
  149. // iPhone: iOS 3.2 returns "3.2"
  150. //
  151. // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
  152. // Tizen: returns "TIZEN_20120425_2"
  153. var deviceVersion = device.version;