michael@0: <!---
michael@0:     Licensed to the Apache Software Foundation (ASF) under one
michael@0:     or more contributor license agreements.  See the NOTICE file
michael@0:     distributed with this work for additional information
michael@0:     regarding copyright ownership.  The ASF licenses this file
michael@0:     to you under the Apache License, Version 2.0 (the
michael@0:     "License"); you may not use this file except in compliance
michael@0:     with the License.  You may obtain a copy of the License at
michael@0: 
michael@0:       http://www.apache.org/licenses/LICENSE-2.0
michael@0: 
michael@0:     Unless required by applicable law or agreed to in writing,
michael@0:     software distributed under the License is distributed on an
michael@0:     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0:     KIND, either express or implied.  See the License for the
michael@0:     specific language governing permissions and limitations
michael@0:     under the License.
michael@0: -->
michael@0: 
michael@0: # org.apache.cordova.device
michael@0: 
michael@0: Этот плагин определяет глобальный объект `device`, который описывает оборудование и программное обеспечение устройства. Несмотря на то что объект в глобальной области видимости, он не доступен до того момента пока не произойдет событие `deviceready`.
michael@0: 
michael@0:     document.addEventListener("deviceready", onDeviceReady, false);
michael@0:     function onDeviceReady() {
michael@0:         console.log(device.cordova);
michael@0:     }
michael@0:     
michael@0: 
michael@0: ## Установка
michael@0: 
michael@0:     cordova plugin add org.apache.cordova.device
michael@0:     
michael@0: 
michael@0: ## Параметры
michael@0: 
michael@0: *   device.cordova
michael@0: *   device.model
michael@0: *   device.platform
michael@0: *   device.uuid
michael@0: *   device.version
michael@0: 
michael@0: ## device.cordova
michael@0: 
michael@0: Возвращает версию Cordova, работающую на устройстве.
michael@0: 
michael@0: ### Поддерживаемые платформы
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Обозреватель
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 и 8
michael@0: *   Windows 8
michael@0: 
michael@0: ## device.model
michael@0: 
michael@0: Свойство `device.model` возвращает имя устройства модели или продукта. Значение устанавливается производителем устройства и могут отличаться в разных версиях одного и того же продукта.
michael@0: 
michael@0: ### Поддерживаемые платформы
michael@0: 
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Обозреватель
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 и 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Краткий пример
michael@0: 
michael@0:     // Android:    Nexus One       returns "Passion" (Nexus One code name)
michael@0:     //             Motorola Droid  returns "voles"
michael@0:     // BlackBerry: Torch 9800      returns "9800"
michael@0:     // Browser:    Google Chrome   returns "Chrome"
michael@0:     //             Safari          returns "Safari"
michael@0:     // iOS:     for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. See http://theiphonewiki.com/wiki/index.php?title=Models
michael@0:     //
michael@0:     var model = device.model;
michael@0:     
michael@0: 
michael@0: ### Особенности Android
michael@0: 
michael@0: *   Возвращает [имя продукта][1] , а не [имя модели][2], которое часто является производственным кодом. Например, Nexus One из них возвращает `Passion` , и Motorola Droid возвращает `voles`.
michael@0: 
michael@0:  [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
michael@0:  [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
michael@0: 
michael@0: ### Особенности Tizen
michael@0: 
michael@0: *   Возвращает модель устройства, назначенного вендором, например,`TIZEN`
michael@0: 
michael@0: ### Особенности Windows Phone 7 и 8
michael@0: 
michael@0: *   Возвращает модель устройства, указанной заводом-изготовителем. Например Samsung Focus возвращает `SGH-i917`.
michael@0: 
michael@0: ## device.platform
michael@0: 
michael@0: Получите имя операционной системы устройства.
michael@0: 
michael@0:     var string = device.platform;
michael@0:     
michael@0: 
michael@0: ### Поддерживаемые платформы
michael@0: 
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Браузером4
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 и 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Краткий пример
michael@0: 
michael@0:     // Depending on the device, a few examples are:
michael@0:     //   - "Android"
michael@0:     //   - "BlackBerry 10"
michael@0:     //   - Browser:         returns "MacIntel" on Mac
michael@0:     //                      returns "Win32" on Windows
michael@0:     //   - "iOS"
michael@0:     //   - "WinCE"
michael@0:     //   - "Tizen"
michael@0:     var devicePlatform = device.platform;
michael@0:     
michael@0: 
michael@0: ### Особенности Windows Phone 7
michael@0: 
michael@0: Windows Phone 7 устройства сообщают платформу как `WinCE`.
michael@0: 
michael@0: ### Особенности Windows Phone 8
michael@0: 
michael@0: Устройства Windows Phone 8 сообщают платформу как `Win32NT`.
michael@0: 
michael@0: ## device.uuid
michael@0: 
michael@0: Возвращает универсальный уникального идентификатора ([UUID][3] устройства).
michael@0: 
michael@0:  [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
michael@0: 
michael@0:     var string = device.uuid;
michael@0:     
michael@0: 
michael@0: ### Описание
michael@0: 
michael@0: Подробная информация о том как UUID генерируется, определяются изготовителем устройства и являются специфическими для платформы или модели устройства.
michael@0: 
michael@0: ### Поддерживаемые платформы
michael@0: 
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 и 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Краткий пример
michael@0: 
michael@0:     // Android: Возвращает случайное 64-разрядное целое число (в виде строки, опять!) 
michael@0:     // целое число генерируется при первой загрузке устройства 
michael@0:     //
michael@0:     // BlackBerry: Возвращает номер PIN устройства 
michael@0:     // это 9 значный уникальный целочисленный (как строка, хотя!) 
michael@0:     // 
michael@0:     // iPhone: (Перефразировано из документации класса UIDevice) 
michael@0:     // возвращает строку хэш-значения, созданные из нескольких аппаратных определяет.
michael@0:     // Это значение гарантированно является уникальным для каждого устройства и не может быть привязано 
michael@0:     // к учетной записи пользователя.
michael@0:     // Windows Phone 7: Возвращает хэш устройство + текущего пользователя, 
michael@0:     // если пользователь не определен, формируется guid который и будет сохраняться до тех пор, пока приложение не удалиться 
michael@0:     // Tizen: возвращает IMEI устройства (Международный идентификатор мобильного оборудования или IMEI это число 
michael@0:     // уникальное для каждого мобильного телефона GSM и UMTS.
michael@0:     var deviceID = device.uuid;
michael@0:     
michael@0: 
michael@0: ### Особенности iOS
michael@0: 
michael@0: На iOS `uuid` не является уникальным для устройства, но варьируется для каждого приложения, и для каждой установки. Значение меняется, если удалить и повторно установить приложение, и возможно также когда вы обновите iOS, или даже обновить приложение до следующей версии (очевидно в iOS 5.1). Значение `uuid` не является надежным.
michael@0: 
michael@0: ### Особенности Windows Phone 7 и 8
michael@0: 
michael@0: Для Windows Phone 7 `uuid` требует разрешения `ID_CAP_IDENTITY_DEVICE` . Microsoft скорее всего скоро сделает это свойство устаревшим. Если возможность недоступна, приложение создает постоянные guid, который сохраняется на все время установки приложения на устройстве.
michael@0: 
michael@0: ## device.version
michael@0: 
michael@0: Возвращает версию операционной системы.
michael@0: 
michael@0:     var string = device.version;
michael@0:     
michael@0: 
michael@0: ### Поддерживаемые платформы
michael@0: 
michael@0: *   Android 2.1 +
michael@0: *   BlackBerry 10
michael@0: *   Обозреватель
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 и 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Краткий пример
michael@0: 
michael@0:     // Android:    Froyo OS would return "2.2"
michael@0:     //             Eclair OS would return "2.1", "2.0.1", or "2.0"
michael@0:     //             Version can also return update level "2.1-update1"
michael@0:     //
michael@0:     // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
michael@0:     //
michael@0:     // Browser:    Returns version number for the browser
michael@0:     //
michael@0:     // iPhone:     iOS 3.2 returns "3.2"
michael@0:     //
michael@0:     // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
michael@0:     // Tizen: returns "TIZEN_20120425_2"
michael@0:     var deviceVersion = device.version;