commonroutesServer/www/plugins/cordova-plugin-device/doc/zh

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

獲取科爾多瓦在設備上運行的版本。

支援的平臺

• 亞馬遜火 OS
• Android 系統
• 黑莓 10
• 瀏覽器
• 火狐瀏覽器作業系統
• iOS
• Tizen
• Windows Phone 7 和 8
• Windows 8

device.model

device.model返回設備的模型或產品的名稱。值由設備製造商設置和同一產品的不同版本可能不同。

支援的平臺

• Android 系統
• 黑莓 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. 請參閱 HTTP://theiphonewiki.com/wiki/index.php?title=Models / / var 模型 = device.model ；

Android 的怪癖

• 獲取產品名稱而不是產品型號名稱，這往往是生產代碼名稱。 例如，Nexus One 返回 Passion ，和摩托羅拉 Droid 返回voles.

Tizen 怪癖

• 例如，返回與供應商指派的設備模型TIZEN

Windows Phone 7 和 8 怪癖

• 返回由製造商指定的設備模型。例如，三星焦點返回SGH-i917.

device.platform

獲取設備的作業系統名稱。

var string = device.platform;

支援的平臺

• Android 系統
• 黑莓 10
• Browser4
• 火狐瀏覽器作業系統
• 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 系統
• 黑莓 10
• iOS
• Tizen
• Windows Phone 7 和 8
• Windows 8

快速的示例

/ / Android： 一個隨機的 64 位整數 （作為字串返回，再次!) / / 上設備的第一次啟動生成的整數 / / / / 黑莓手機： 返回設備的 PIN 號碼 / / 這是九個數字的唯一整數 （作為字串，雖然!) / / / / iPhone： （從 UIDevice 類文檔解釋） / / 返回一個字串的雜湊值創建的多個硬體標識。
/ / 它保證是唯一的每個設備並不能綁 / / 到使用者帳戶。
/ / Windows Phone 7： 返回的雜湊代碼的設備 + 當前使用者，/ / 如果未定義使用者，則一個 guid 生成的並且將會保留直到卸載該應用程式 / / Tizen： 返回設備 IMEI （國際行動裝置身份或 IMEI 是一個數位 / / 獨有的每一個 UMTS 和 GSM 行動電話。
var deviceID = device.uuid;

iOS 怪癖

uuid在 iOS 不是唯一的一種裝置，但對於每個應用程式，為每個安裝而異。 如果您刪除並重新安裝該應用程式，它更改和可能還當你升級 iOS，或甚至升級每個版本 （iOS 5.1 中存在明顯的） 的應用程式。 uuid不是一個可靠的值。

Windows Phone 7 和 8 怪癖

uuid為 Windows Phone 7 須經許可 ID_CAP_IDENTITY_DEVICE 。 Microsoft 可能會很快棄用此屬性。 如果沒有可用的能力，應用程式將生成設備上應用程式的安裝過程中保持持續的 guid。

device.version

獲取作業系統版本。

var string = device.version;

支援的平臺

• Android 2.1 +
• 黑莓 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;