cordova-plugin-device 1.1.3

cordova-plugin-device 1.1.3

测试已测试
语言语言 Obj-CObjective C
许可证 Apache 2
发布最新发布2016年11月

Holly Schinsky,《a href="/owners/16594">Shazron Abdullah 维护。



  • Adobe PhoneGap 团队

标题:设备

描述:获取设备信息。

Android iOS Windows 8.1 商店 Windows 8.1 手机 Windows 10 商店 Travis CI
Build Status Build Status Build Status Build Status Build Status

cordova-plugin-device

此插件定义了一个全局的 device 对象,它描述了设备的硬件和软件。尽管该对象位于全局作用域中,但它直到 deviceready 事件之后才可用。

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

在此插件的 Apache Cordova 问题跟踪器上报告问题

安装

cordova plugin add cordova-plugin-device

属性

  • device.cordova
  • device.model
  • device.platform
  • device.uuid
  • device.version
  • device.manufacturer
  • device.isVirtual
  • device.serial

device.cordova

获取设备上运行的 Cordova 版本。

支持的平台

  • Amazon Fire OS
  • Android
  • BlackBerry 10
  • 浏览器
  • Firefox OS
  • iOS
  • Tizen
  • Windows Phone 7 和 8
  • Windows
  • OSX

device.model

《code>device.model 返回设备的型号或产品名称。该值由设备制造商设置,可能在不同版本的相同产品中不同。

支持的平台

  • Android
  • BlackBerry 10
  • 浏览器
  • iOS
  • Tizen
  • Windows Phone 7 和 8
  • Windows
  • OSX

快速示例

// 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
// OSX:                        returns "x86_64"
//
var model = device.model;

Android 的怪异之处

  • 获取产品名称而不是型号名称,这通常是生产代码名称。例如,Nexus One 返回 Passion,Motorola Droid 返回 voles

Tizen 的怪异之处

  • 返回由供应商分配的设备型号,例如,TIZEN

Windows Phone 7 和 8 程序异常

  • 返回制造商指定的设备型号。例如,三星Focus返回SGH-i917

device.platform

获取设备的操作系统名称。

var string = device.platform;

支持的平台

  • Android
  • BlackBerry 10
  • 浏览器
  • Firefox OS
  • iOS
  • Tizen
  • Windows Phone 7 和 8
  • Windows
  • OSX

快速示例

// Depending on the device, a few examples are:
//   - "Android"
//   - "BlackBerry 10"
//   - "browser"
//   - "iOS"
//   - "WinCE"
//   - "Tizen"
//   - "Mac OS X"
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
  • OSX

快速示例

// Android: Returns a random 64-bit integer (as a string, again!)
//          The integer is generated on the device's first boot
//
// BlackBerry: Returns the PIN number of the device
//             This is a nine-digit unique integer (as a string, though!)
//
// iPhone: (Paraphrased from the UIDevice Class documentation)
//         Returns the [UIDevice identifierForVendor] UUID which is unique and the same for all apps installed by the same vendor. However the UUID can be different if the user deletes all apps from the vendor and then reinstalls it.
// Windows Phone 7 : Returns a hash of device+current user,
// if the user is not defined, a guid is generated and will persist until the app is uninstalled
// Tizen: returns the device IMEI (International Mobile Equipment Identity or IMEI is a number
// unique to every GSM and UMTS mobile phone.
var deviceID = device.uuid;

iOS 程序异常

在iOS上,uuid使用identifierForVendor属性。它对于同一供应商的设备是唯一的,但对于不同的供应商将不同,如果从供应商卸载并重新安装所有应用程序,它将发生变化。有关详情,请参考此处。如果从备份或iCloud恢复应用程序,则UUID将与保存到首选项中的UUID相同。使用此插件旧版本的用户仍然会接收到通过其他方式生成的相同的先前UUID,因为它将从首选项中检索。

OSX 程序异常

如果尚不存在,OSX上的uuid将自动生成,并存储在CDVUUID属性中的standardUserDefaults

Windows Phone 7 和 8 程序异常

Windows Phone 7上的uuid需要权限ID_CAP_IDENTITY_DEVICE。微软可能会很快弃用此属性。如果该功能不可用,则应用程序生成一个持久的guid,在整个应用程序安装于设备期间保持不变。

device.version

获取操作系统版本。

var string = device.version;

支持的平台

  • Android 2.1+
  • BlackBerry 10
  • 浏览器
  • iOS
  • Tizen
  • Windows Phone 7 和 8
  • Windows
  • OSX

快速示例

// 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
// Windows 8: return the current OS version, ex on Windows 8.1 returns 6.3.9600.16384
// Tizen: returns "TIZEN_20120425_2"
// OSX:        El Capitan would return "10.11.2"
//
var deviceVersion = device.version;

device.manufacturer

获取设备的制造商。

var string = device.manufacturer;

支持的平台

  • Android
  • BlackBerry 10
  • iOS
  • Windows Phone 7 和 8
  • Windows

快速示例

// Android:    Motorola XT1032 would return "motorola"
// BlackBerry: returns "BlackBerry"
// iPhone:     returns "Apple"
//
var deviceManufacturer = device.manufacturer;

device.isVirtual

设备是否在模拟器上运行。

var isSim = device.isVirtual;

支持的平台

  • Android 2.1+
  • iOS
  • Windows Phone 8
  • Windows
  • OSX

OSX 的怪癖

在 OS X 上,isVirtual 属性始终返回 false。

device.serial

获取设备硬件序列号 (SERIAL)。

var string = device.serial;

支持的平台

  • Android
  • OSX