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# cordova-plugin-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 cordova-plugin-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
133Windows 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;