index.md 8.9 KB

cordova-plugin-device

Этот плагин определяет глобальный объект device, который описывает оборудование и программное обеспечение устройства. Несмотря на то что объект в глобальной области видимости, он не доступен до того момента пока не произойдет событие deviceready.

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(device.cordova);
}

Установка

cordova plugin add cordova-plugin-device

Параметры

  • device.cordova
  • device.model
  • device.platform
  • device.uuid
  • device.version

device.cordova

Возвращает версию Cordova, работающую на устройстве.

Поддерживаемые платформы

  • Amazon Fire OS
  • Android
  • BlackBerry 10
  • Обозреватель
  • Firefox OS
  • iOS
  • Tizen
  • Windows Phone 7 и 8
  • Windows 8

device.model

Свойство device.model возвращает имя устройства модели или продукта. Значение устанавливается производителем устройства и могут отличаться в разных версиях одного и того же продукта.

Поддерживаемые платформы

  • Android
  • BlackBerry 10
  • Обозреватель
  • iOS
  • Tizen
  • Windows Phone 7 и 8
  • Windows 8

Краткий пример

// Android:    Nexus One       returns "Passion" (Nexus One code name)
//             Motorola Droid  returns "voles"
// BlackBerry: Torch 9800      returns "9800"
// Browser:    Google Chrome   returns "Chrome"
//             Safari          returns "Safari"
// iOS:     for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. See http://theiphonewiki.com/wiki/index.php?title=Models
//
var model = device.model;

Особенности Android

  • Возвращает имя продукта , а не имя модели, которое часто является производственным кодом. Например, Nexus One из них возвращает Passion , и Motorola Droid возвращает voles.

Особенности Tizen

  • Возвращает модель устройства, назначенного вендором, например,TIZEN

Особенности Windows Phone 7 и 8

  • Возвращает модель устройства, указанной заводом-изготовителем. Например Samsung Focus возвращает SGH-i917.

device.platform

Получите имя операционной системы устройства.

var string = device.platform;

Поддерживаемые платформы

  • Android
  • BlackBerry 10
  • Браузером4
  • Firefox OS
  • iOS
  • Tizen
  • Windows Phone 7 и 8
  • Windows 8

Краткий пример

// Depending on the device, a few examples are:
//   - "Android"
//   - "BlackBerry 10"
//   - Browser:         returns "MacIntel" on Mac
//                      returns "Win32" on Windows
//   - "iOS"
//   - "WinCE"
//   - "Tizen"
var devicePlatform = device.platform;

Особенности Windows Phone 7

Windows Phone 7 устройства сообщают платформу как WinCE.

Особенности Windows Phone 8

Устройства Windows Phone 8 сообщают платформу как Win32NT.

device.uuid

Возвращает универсальный уникального идентификатора (UUID устройства).

var string = device.uuid;

Описание

Подробная информация о том как UUID генерируется, определяются изготовителем устройства и являются специфическими для платформы или модели устройства.

Поддерживаемые платформы

  • Android
  • BlackBerry 10
  • iOS
  • Tizen
  • Windows Phone 7 и 8
  • Windows 8

Краткий пример

// Android: Возвращает случайное 64-разрядное целое число (в виде строки, опять!) 
// целое число генерируется при первой загрузке устройства 
//
// BlackBerry: Возвращает номер PIN устройства 
// это 9 значный уникальный целочисленный (как строка, хотя!) 
// 
// iPhone: (Перефразировано из документации класса UIDevice) 
// возвращает строку хэш-значения, созданные из нескольких аппаратных определяет.
// Это значение гарантированно является уникальным для каждого устройства и не может быть привязано 
// к учетной записи пользователя.
// Windows Phone 7: Возвращает хэш устройство + текущего пользователя, 
// если пользователь не определен, формируется guid который и будет сохраняться до тех пор, пока приложение не удалиться 
// Tizen: возвращает IMEI устройства (Международный идентификатор мобильного оборудования или IMEI это число 
// уникальное для каждого мобильного телефона GSM и UMTS.
var deviceID = device.uuid;

Особенности iOS

На iOS uuid не является уникальным для устройства, но варьируется для каждого приложения, и для каждой установки. Значение меняется, если удалить и повторно установить приложение, и возможно также когда вы обновите iOS, или даже обновить приложение до следующей версии (очевидно в iOS 5.1). Значение uuid не является надежным.

Особенности Windows Phone 7 и 8

Для Windows Phone 7 uuid требует разрешения ID_CAP_IDENTITY_DEVICE . Microsoft скорее всего скоро сделает это свойство устаревшим. Если возможность недоступна, приложение создает постоянные guid, который сохраняется на все время установки приложения на устройстве.

device.version

Возвращает версию операционной системы.

var string = device.version;

Поддерживаемые платформы

  • Android 2.1 +
  • BlackBerry 10
  • Обозреватель
  • iOS
  • Tizen
  • Windows Phone 7 и 8
  • Windows 8

Краткий пример

// Android:    Froyo OS would return "2.2"
//             Eclair OS would return "2.1", "2.0.1", or "2.0"
//             Version can also return update level "2.1-update1"
//
// BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
//
// Browser:    Returns version number for the browser
//
// iPhone:     iOS 3.2 returns "3.2"
//
// Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
// Tizen: returns "TIZEN_20120425_2"
var deviceVersion = device.version;