This repository has been archived on 2023-11-19. You can view files and clone it, but cannot push or open issues or pull requests.
goober-ionic/plugins/cordova-plugin-device/doc/zh/index.md
2018-07-15 19:24:48 -07:00

6 KiB
Raw Blame History

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
  • Windows Phone 7 和 8
  • Windows 8

device.model

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

支援的平臺

  • Android 系統
  • 黑莓 10
  • 瀏覽器
  • iOS
  • 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
  • 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
  • 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;