Mon 21 Jul 22:43:21 CEST 2025
This commit is contained in:
parent
f4b68d9792
commit
e842501296
203
js/ui/cordova/plugins/cordova-plugin-device/doc/zh/README.md
Normal file
203
js/ui/cordova/plugins/cordova-plugin-device/doc/zh/README.md
Normal file
|
|
@ -0,0 +1,203 @@
|
||||||
|
<!--
|
||||||
|
# license: Licensed to the Apache Software Foundation (ASF) under one
|
||||||
|
# or more contributor license agreements. See the NOTICE file
|
||||||
|
# distributed with this work for additional information
|
||||||
|
# regarding copyright ownership. The ASF licenses this file
|
||||||
|
# to you under the Apache License, Version 2.0 (the
|
||||||
|
# "License"); you may not use this file except in compliance
|
||||||
|
# with the License. You may obtain a copy of the License at
|
||||||
|
#
|
||||||
|
# http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
#
|
||||||
|
# Unless required by applicable law or agreed to in writing,
|
||||||
|
# software distributed under the License is distributed on an
|
||||||
|
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
||||||
|
# KIND, either express or implied. See the License for the
|
||||||
|
# specific language governing permissions and limitations
|
||||||
|
# under the License.
|
||||||
|
-->
|
||||||
|
|
||||||
|
# cordova-plugin-device
|
||||||
|
|
||||||
|
[](https://travis-ci.org/apache/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 的怪癖
|
||||||
|
|
||||||
|
* 獲取[產品名稱](http://developer.android.com/reference/android/os/Build.html#PRODUCT)而不是[產品型號名稱](http://developer.android.com/reference/android/os/Build.html#MODEL)，這往往是生產代碼名稱。 例如，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](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)).
|
||||||
|
|
||||||
|
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;
|
||||||
Loading…
Reference in New Issue
Block a user