1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/Touchgui/plugins/org.apache.cordova.device/doc/ru/index.md Thu Jun 04 14:50:33 2015 +0200
1.3 @@ -0,0 +1,219 @@
1.4 +<!---
1.5 + Licensed to the Apache Software Foundation (ASF) under one
1.6 + or more contributor license agreements. See the NOTICE file
1.7 + distributed with this work for additional information
1.8 + regarding copyright ownership. The ASF licenses this file
1.9 + to you under the Apache License, Version 2.0 (the
1.10 + "License"); you may not use this file except in compliance
1.11 + with the License. You may obtain a copy of the License at
1.12 +
1.13 + http://www.apache.org/licenses/LICENSE-2.0
1.14 +
1.15 + Unless required by applicable law or agreed to in writing,
1.16 + software distributed under the License is distributed on an
1.17 + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
1.18 + KIND, either express or implied. See the License for the
1.19 + specific language governing permissions and limitations
1.20 + under the License.
1.21 +-->
1.22 +
1.23 +# org.apache.cordova.device
1.24 +
1.25 +Этот плагин определяет глобальный объект `device`, который описывает оборудование и программное обеспечение устройства. Несмотря на то что объект в глобальной области видимости, он не доступен до того момента пока не произойдет событие `deviceready`.
1.26 +
1.27 + document.addEventListener("deviceready", onDeviceReady, false);
1.28 + function onDeviceReady() {
1.29 + console.log(device.cordova);
1.30 + }
1.31 +
1.32 +
1.33 +## Установка
1.34 +
1.35 + cordova plugin add org.apache.cordova.device
1.36 +
1.37 +
1.38 +## Параметры
1.39 +
1.40 +* device.cordova
1.41 +* device.model
1.42 +* device.platform
1.43 +* device.uuid
1.44 +* device.version
1.45 +
1.46 +## device.cordova
1.47 +
1.48 +Возвращает версию Cordova, работающую на устройстве.
1.49 +
1.50 +### Поддерживаемые платформы
1.51 +
1.52 +* Amazon Fire OS
1.53 +* Android
1.54 +* BlackBerry 10
1.55 +* Обозреватель
1.56 +* Firefox OS
1.57 +* iOS
1.58 +* Tizen
1.59 +* Windows Phone 7 и 8
1.60 +* Windows 8
1.61 +
1.62 +## device.model
1.63 +
1.64 +Свойство `device.model` возвращает имя устройства модели или продукта. Значение устанавливается производителем устройства и могут отличаться в разных версиях одного и того же продукта.
1.65 +
1.66 +### Поддерживаемые платформы
1.67 +
1.68 +* Android
1.69 +* BlackBerry 10
1.70 +* Обозреватель
1.71 +* iOS
1.72 +* Tizen
1.73 +* Windows Phone 7 и 8
1.74 +* Windows 8
1.75 +
1.76 +### Краткий пример
1.77 +
1.78 + // Android: Nexus One returns "Passion" (Nexus One code name)
1.79 + // Motorola Droid returns "voles"
1.80 + // BlackBerry: Torch 9800 returns "9800"
1.81 + // Browser: Google Chrome returns "Chrome"
1.82 + // Safari returns "Safari"
1.83 + // iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. See http://theiphonewiki.com/wiki/index.php?title=Models
1.84 + //
1.85 + var model = device.model;
1.86 +
1.87 +
1.88 +### Особенности Android
1.89 +
1.90 +* Возвращает [имя продукта][1] , а не [имя модели][2], которое часто является производственным кодом. Например, Nexus One из них возвращает `Passion` , и Motorola Droid возвращает `voles`.
1.91 +
1.92 + [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
1.93 + [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
1.94 +
1.95 +### Особенности Tizen
1.96 +
1.97 +* Возвращает модель устройства, назначенного вендором, например,`TIZEN`
1.98 +
1.99 +### Особенности Windows Phone 7 и 8
1.100 +
1.101 +* Возвращает модель устройства, указанной заводом-изготовителем. Например Samsung Focus возвращает `SGH-i917`.
1.102 +
1.103 +## device.platform
1.104 +
1.105 +Получите имя операционной системы устройства.
1.106 +
1.107 + var string = device.platform;
1.108 +
1.109 +
1.110 +### Поддерживаемые платформы
1.111 +
1.112 +* Android
1.113 +* BlackBerry 10
1.114 +* Браузером4
1.115 +* Firefox OS
1.116 +* iOS
1.117 +* Tizen
1.118 +* Windows Phone 7 и 8
1.119 +* Windows 8
1.120 +
1.121 +### Краткий пример
1.122 +
1.123 + // Depending on the device, a few examples are:
1.124 + // - "Android"
1.125 + // - "BlackBerry 10"
1.126 + // - Browser: returns "MacIntel" on Mac
1.127 + // returns "Win32" on Windows
1.128 + // - "iOS"
1.129 + // - "WinCE"
1.130 + // - "Tizen"
1.131 + var devicePlatform = device.platform;
1.132 +
1.133 +
1.134 +### Особенности Windows Phone 7
1.135 +
1.136 +Windows Phone 7 устройства сообщают платформу как `WinCE`.
1.137 +
1.138 +### Особенности Windows Phone 8
1.139 +
1.140 +Устройства Windows Phone 8 сообщают платформу как `Win32NT`.
1.141 +
1.142 +## device.uuid
1.143 +
1.144 +Возвращает универсальный уникального идентификатора ([UUID][3] устройства).
1.145 +
1.146 + [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
1.147 +
1.148 + var string = device.uuid;
1.149 +
1.150 +
1.151 +### Описание
1.152 +
1.153 +Подробная информация о том как UUID генерируется, определяются изготовителем устройства и являются специфическими для платформы или модели устройства.
1.154 +
1.155 +### Поддерживаемые платформы
1.156 +
1.157 +* Android
1.158 +* BlackBerry 10
1.159 +* iOS
1.160 +* Tizen
1.161 +* Windows Phone 7 и 8
1.162 +* Windows 8
1.163 +
1.164 +### Краткий пример
1.165 +
1.166 + // Android: Возвращает случайное 64-разрядное целое число (в виде строки, опять!)
1.167 + // целое число генерируется при первой загрузке устройства
1.168 + //
1.169 + // BlackBerry: Возвращает номер PIN устройства
1.170 + // это 9 значный уникальный целочисленный (как строка, хотя!)
1.171 + //
1.172 + // iPhone: (Перефразировано из документации класса UIDevice)
1.173 + // возвращает строку хэш-значения, созданные из нескольких аппаратных определяет.
1.174 + // Это значение гарантированно является уникальным для каждого устройства и не может быть привязано
1.175 + // к учетной записи пользователя.
1.176 + // Windows Phone 7: Возвращает хэш устройство + текущего пользователя,
1.177 + // если пользователь не определен, формируется guid который и будет сохраняться до тех пор, пока приложение не удалиться
1.178 + // Tizen: возвращает IMEI устройства (Международный идентификатор мобильного оборудования или IMEI это число
1.179 + // уникальное для каждого мобильного телефона GSM и UMTS.
1.180 + var deviceID = device.uuid;
1.181 +
1.182 +
1.183 +### Особенности iOS
1.184 +
1.185 +На iOS `uuid` не является уникальным для устройства, но варьируется для каждого приложения, и для каждой установки. Значение меняется, если удалить и повторно установить приложение, и возможно также когда вы обновите iOS, или даже обновить приложение до следующей версии (очевидно в iOS 5.1). Значение `uuid` не является надежным.
1.186 +
1.187 +### Особенности Windows Phone 7 и 8
1.188 +
1.189 +Для Windows Phone 7 `uuid` требует разрешения `ID_CAP_IDENTITY_DEVICE` . Microsoft скорее всего скоро сделает это свойство устаревшим. Если возможность недоступна, приложение создает постоянные guid, который сохраняется на все время установки приложения на устройстве.
1.190 +
1.191 +## device.version
1.192 +
1.193 +Возвращает версию операционной системы.
1.194 +
1.195 + var string = device.version;
1.196 +
1.197 +
1.198 +### Поддерживаемые платформы
1.199 +
1.200 +* Android 2.1 +
1.201 +* BlackBerry 10
1.202 +* Обозреватель
1.203 +* iOS
1.204 +* Tizen
1.205 +* Windows Phone 7 и 8
1.206 +* Windows 8
1.207 +
1.208 +### Краткий пример
1.209 +
1.210 + // Android: Froyo OS would return "2.2"
1.211 + // Eclair OS would return "2.1", "2.0.1", or "2.0"
1.212 + // Version can also return update level "2.1-update1"
1.213 + //
1.214 + // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
1.215 + //
1.216 + // Browser: Returns version number for the browser
1.217 + //
1.218 + // iPhone: iOS 3.2 returns "3.2"
1.219 + //
1.220 + // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
1.221 + // Tizen: returns "TIZEN_20120425_2"
1.222 + var deviceVersion = device.version;
1.223 \ No newline at end of file
