Thu, 04 Jun 2015 14:50:33 +0200
Genesis of lecture sources for Droidcon Berlin 2015 in Postbahnhof.
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
10 http://www.apache.org/licenses/LICENSE-2.0
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 -->
20 # org.apache.cordova.device
22 Этот плагин определяет глобальный объект `device`, который описывает оборудование и программное обеспечение устройства. Несмотря на то что объект в глобальной области видимости, он не доступен до того момента пока не произойдет событие `deviceready`.
24 document.addEventListener("deviceready", onDeviceReady, false);
25 function onDeviceReady() {
26 console.log(device.cordova);
27 }
30 ## Установка
32 cordova plugin add org.apache.cordova.device
35 ## Параметры
37 * device.cordova
38 * device.model
39 * device.platform
40 * device.uuid
41 * device.version
43 ## device.cordova
45 Возвращает версию Cordova, работающую на устройстве.
47 ### Поддерживаемые платформы
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
59 ## device.model
61 Свойство `device.model` возвращает имя устройства модели или продукта. Значение устанавливается производителем устройства и могут отличаться в разных версиях одного и того же продукта.
63 ### Поддерживаемые платформы
65 * Android
66 * BlackBerry 10
67 * Обозреватель
68 * iOS
69 * Tizen
70 * Windows Phone 7 и 8
71 * Windows 8
73 ### Краткий пример
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;
85 ### Особенности Android
87 * Возвращает [имя продукта][1] , а не [имя модели][2], которое часто является производственным кодом. Например, Nexus One из них возвращает `Passion` , и Motorola Droid возвращает `voles`.
89 [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
90 [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
92 ### Особенности Tizen
94 * Возвращает модель устройства, назначенного вендором, например,`TIZEN`
96 ### Особенности Windows Phone 7 и 8
98 * Возвращает модель устройства, указанной заводом-изготовителем. Например Samsung Focus возвращает `SGH-i917`.
100 ## device.platform
102 Получите имя операционной системы устройства.
104 var string = device.platform;
107 ### Поддерживаемые платформы
109 * Android
110 * BlackBerry 10
111 * Браузером4
112 * Firefox OS
113 * iOS
114 * Tizen
115 * Windows Phone 7 и 8
116 * Windows 8
118 ### Краткий пример
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;
131 ### Особенности Windows Phone 7
133 Windows Phone 7 устройства сообщают платформу как `WinCE`.
135 ### Особенности Windows Phone 8
137 Устройства Windows Phone 8 сообщают платформу как `Win32NT`.
139 ## device.uuid
141 Возвращает универсальный уникального идентификатора ([UUID][3] устройства).
143 [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
145 var string = device.uuid;
148 ### Описание
150 Подробная информация о том как UUID генерируется, определяются изготовителем устройства и являются специфическими для платформы или модели устройства.
152 ### Поддерживаемые платформы
154 * Android
155 * BlackBerry 10
156 * iOS
157 * Tizen
158 * Windows Phone 7 и 8
159 * Windows 8
161 ### Краткий пример
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;
180 ### Особенности iOS
182 На iOS `uuid` не является уникальным для устройства, но варьируется для каждого приложения, и для каждой установки. Значение меняется, если удалить и повторно установить приложение, и возможно также когда вы обновите iOS, или даже обновить приложение до следующей версии (очевидно в iOS 5.1). Значение `uuid` не является надежным.
184 ### Особенности Windows Phone 7 и 8
186 Для Windows Phone 7 `uuid` требует разрешения `ID_CAP_IDENTITY_DEVICE` . Microsoft скорее всего скоро сделает это свойство устаревшим. Если возможность недоступна, приложение создает постоянные guid, который сохраняется на все время установки приложения на устройстве.
188 ## device.version
190 Возвращает версию операционной системы.
192 var string = device.version;
195 ### Поддерживаемые платформы
197 * Android 2.1 +
198 * BlackBerry 10
199 * Обозреватель
200 * iOS
201 * Tizen
202 * Windows Phone 7 и 8
203 * Windows 8
205 ### Краткий пример
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;