comparison: Touchgui/plugins/org.apache.cordova.device/doc/ru/index.md
Touchgui/plugins/org.apache.cordova.device/doc/ru/index.md
- changeset 0
- e8ccd40d0ef6
equal
deleted
inserted
replaced
| -1:000000000000 | 0:801d8e7cd620 |
|---|---|
| 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 | |
| 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 | |
| 20 # org.apache.cordova.device | |
| 21 | |
| 22 Этот плагин определяет глобальный объект `device`, который описывает оборудование и программное обеспечение устройства. Несмотря на то что объект в глобальной области видимости, он не доступен до того момента пока не произойдет событие `deviceready`. | |
| 23 | |
| 24 document.addEventListener("deviceready", onDeviceReady, false); | |
| 25 function onDeviceReady() { | |
| 26 console.log(device.cordova); | |
| 27 } | |
| 28 | |
| 29 | |
| 30 ## Установка | |
| 31 | |
| 32 cordova plugin add org.apache.cordova.device | |
| 33 | |
| 34 | |
| 35 ## Параметры | |
| 36 | |
| 37 * device.cordova | |
| 38 * device.model | |
| 39 * device.platform | |
| 40 * device.uuid | |
| 41 * device.version | |
| 42 | |
| 43 ## device.cordova | |
| 44 | |
| 45 Возвращает версию Cordova, работающую на устройстве. | |
| 46 | |
| 47 ### Поддерживаемые платформы | |
| 48 | |
| 49 * Amazon Fire OS | |
| 50 * Android | |
| 51 * BlackBerry 10 | |
| 52 * Обозреватель | |
| 53 * Firefox OS | |
| 54 * iOS | |
| 55 * Tizen | |
| 56 * Windows Phone 7 и 8 | |
| 57 * Windows 8 | |
| 58 | |
| 59 ## device.model | |
| 60 | |
| 61 Свойство `device.model` возвращает имя устройства модели или продукта. Значение устанавливается производителем устройства и могут отличаться в разных версиях одного и того же продукта. | |
| 62 | |
| 63 ### Поддерживаемые платформы | |
| 64 | |
| 65 * Android | |
| 66 * BlackBerry 10 | |
| 67 * Обозреватель | |
| 68 * iOS | |
| 69 * Tizen | |
| 70 * Windows Phone 7 и 8 | |
| 71 * Windows 8 | |
| 72 | |
| 73 ### Краткий пример | |
| 74 | |
| 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. See http://theiphonewiki.com/wiki/index.php?title=Models | |
| 81 // | |
| 82 var model = device.model; | |
| 83 | |
| 84 | |
| 85 ### Особенности Android | |
| 86 | |
| 87 * Возвращает [имя продукта][1] , а не [имя модели][2], которое часто является производственным кодом. Например, Nexus One из них возвращает `Passion` , и Motorola Droid возвращает `voles`. | |
| 88 | |
| 89 [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT | |
| 90 [2]: http://developer.android.com/reference/android/os/Build.html#MODEL | |
| 91 | |
| 92 ### Особенности Tizen | |
| 93 | |
| 94 * Возвращает модель устройства, назначенного вендором, например,`TIZEN` | |
| 95 | |
| 96 ### Особенности Windows Phone 7 и 8 | |
| 97 | |
| 98 * Возвращает модель устройства, указанной заводом-изготовителем. Например Samsung Focus возвращает `SGH-i917`. | |
| 99 | |
| 100 ## device.platform | |
| 101 | |
| 102 Получите имя операционной системы устройства. | |
| 103 | |
| 104 var string = device.platform; | |
| 105 | |
| 106 | |
| 107 ### Поддерживаемые платформы | |
| 108 | |
| 109 * Android | |
| 110 * BlackBerry 10 | |
| 111 * Браузером4 | |
| 112 * Firefox OS | |
| 113 * iOS | |
| 114 * Tizen | |
| 115 * Windows Phone 7 и 8 | |
| 116 * Windows 8 | |
| 117 | |
| 118 ### Краткий пример | |
| 119 | |
| 120 // Depending on the device, a few examples are: | |
| 121 // - "Android" | |
| 122 // - "BlackBerry 10" | |
| 123 // - Browser: returns "MacIntel" on Mac | |
| 124 // returns "Win32" on Windows | |
| 125 // - "iOS" | |
| 126 // - "WinCE" | |
| 127 // - "Tizen" | |
| 128 var devicePlatform = device.platform; | |
| 129 | |
| 130 | |
| 131 ### Особенности Windows Phone 7 | |
| 132 | |
| 133 Windows Phone 7 устройства сообщают платформу как `WinCE`. | |
| 134 | |
| 135 ### Особенности Windows Phone 8 | |
| 136 | |
| 137 Устройства Windows Phone 8 сообщают платформу как `Win32NT`. | |
| 138 | |
| 139 ## device.uuid | |
| 140 | |
| 141 Возвращает универсальный уникального идентификатора ([UUID][3] устройства). | |
| 142 | |
| 143 [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier | |
| 144 | |
| 145 var string = device.uuid; | |
| 146 | |
| 147 | |
| 148 ### Описание | |
| 149 | |
| 150 Подробная информация о том как UUID генерируется, определяются изготовителем устройства и являются специфическими для платформы или модели устройства. | |
| 151 | |
| 152 ### Поддерживаемые платформы | |
| 153 | |
| 154 * Android | |
| 155 * BlackBerry 10 | |
| 156 * iOS | |
| 157 * Tizen | |
| 158 * Windows Phone 7 и 8 | |
| 159 * Windows 8 | |
| 160 | |
| 161 ### Краткий пример | |
| 162 | |
| 163 // Android: Возвращает случайное 64-разрядное целое число (в виде строки, опять!) | |
| 164 // целое число генерируется при первой загрузке устройства | |
| 165 // | |
| 166 // BlackBerry: Возвращает номер PIN устройства | |
| 167 // это 9 значный уникальный целочисленный (как строка, хотя!) | |
| 168 // | |
| 169 // iPhone: (Перефразировано из документации класса UIDevice) | |
| 170 // возвращает строку хэш-значения, созданные из нескольких аппаратных определяет. | |
| 171 // Это значение гарантированно является уникальным для каждого устройства и не может быть привязано | |
| 172 // к учетной записи пользователя. | |
| 173 // Windows Phone 7: Возвращает хэш устройство + текущего пользователя, | |
| 174 // если пользователь не определен, формируется guid который и будет сохраняться до тех пор, пока приложение не удалиться | |
| 175 // Tizen: возвращает IMEI устройства (Международный идентификатор мобильного оборудования или IMEI это число | |
| 176 // уникальное для каждого мобильного телефона GSM и UMTS. | |
| 177 var deviceID = device.uuid; | |
| 178 | |
| 179 | |
| 180 ### Особенности iOS | |
| 181 | |
| 182 На iOS `uuid` не является уникальным для устройства, но варьируется для каждого приложения, и для каждой установки. Значение меняется, если удалить и повторно установить приложение, и возможно также когда вы обновите iOS, или даже обновить приложение до следующей версии (очевидно в iOS 5.1). Значение `uuid` не является надежным. | |
| 183 | |
| 184 ### Особенности Windows Phone 7 и 8 | |
| 185 | |
| 186 Для Windows Phone 7 `uuid` требует разрешения `ID_CAP_IDENTITY_DEVICE` . Microsoft скорее всего скоро сделает это свойство устаревшим. Если возможность недоступна, приложение создает постоянные guid, который сохраняется на все время установки приложения на устройстве. | |
| 187 | |
| 188 ## device.version | |
| 189 | |
| 190 Возвращает версию операционной системы. | |
| 191 | |
| 192 var string = device.version; | |
| 193 | |
| 194 | |
| 195 ### Поддерживаемые платформы | |
| 196 | |
| 197 * Android 2.1 + | |
| 198 * BlackBerry 10 | |
| 199 * Обозреватель | |
| 200 * iOS | |
| 201 * Tizen | |
| 202 * Windows Phone 7 и 8 | |
| 203 * Windows 8 | |
| 204 | |
| 205 ### Краткий пример | |
| 206 | |
| 207 // Android: Froyo OS would return "2.2" | |
| 208 // Eclair OS would return "2.1", "2.0.1", or "2.0" | |
| 209 // Version can also return update level "2.1-update1" | |
| 210 // | |
| 211 // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600" | |
| 212 // | |
| 213 // Browser: Returns version number for the browser | |
| 214 // | |
| 215 // iPhone: iOS 3.2 returns "3.2" | |
| 216 // | |
| 217 // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720 | |
| 218 // Tizen: returns "TIZEN_20120425_2" | |
| 219 var deviceVersion = device.version; |
