• file
• revisions
• annotate
• diff
• comparison
• raw

Touchgui/plugins/org.apache.cordova.device/doc/zh/index.md@e8ccd40d0ef6 (annotated)

Touchgui/plugins/org.apache.cordova.device/doc/zh/index.md

Thu, 04 Jun 2015 14:50:33 +0200

author

Michael Schloh von Bennewitz <michael@schloh.com>

date

Thu, 04 Jun 2015 14:50:33 +0200

changeset 0

e8ccd40d0ef6

permissions

-rw-r--r--

Genesis of lecture sources for Droidcon Berlin 2015 in Postbahnhof.

michael@0	1	<!---
michael@0	2	Licensed to the Apache Software Foundation (ASF) under one
michael@0	3	or more contributor license agreements. See the NOTICE file
michael@0	4	distributed with this work for additional information
michael@0	5	regarding copyright ownership. The ASF licenses this file
michael@0	6	to you under the Apache License, Version 2.0 (the
michael@0	7	"License"); you may not use this file except in compliance
michael@0	8	with the License. You may obtain a copy of the License at
michael@0	9
michael@0	10	http://www.apache.org/licenses/LICENSE-2.0
michael@0	11
michael@0	12	Unless required by applicable law or agreed to in writing,
michael@0	13	software distributed under the License is distributed on an
michael@0	14	"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0	15	KIND, either express or implied. See the License for the
michael@0	16	specific language governing permissions and limitations
michael@0	17	under the License.
michael@0	18	-->
michael@0	19
michael@0	20	# org.apache.cordova.device
michael@0	21
michael@0	22	這個外掛程式定義全球 `device` 物件，描述該設備的硬體和軟體。 雖然物件是在全球範圍內，但不是可用，直到後 `deviceready` 事件。
michael@0	23
michael@0	24	document.addEventListener("deviceready", onDeviceReady, false);
michael@0	25	function onDeviceReady() {
michael@0	26	console.log(device.cordova);
michael@0	27	}
michael@0	28
michael@0	29
michael@0	30	## 安裝
michael@0	31
michael@0	32	cordova plugin add org.apache.cordova.device
michael@0	33
michael@0	34
michael@0	35	## 屬性
michael@0	36
michael@0	37	* device.cordova
michael@0	38	* device.model
michael@0	39	* device.platform
michael@0	40	* device.uuid
michael@0	41	* device.version
michael@0	42
michael@0	43	## device.cordova
michael@0	44
michael@0	45	獲取科爾多瓦在設備上運行的版本。
michael@0	46
michael@0	47	### 支援的平臺
michael@0	48
michael@0	49	* 亞馬遜火 OS
michael@0	50	* Android 系統
michael@0	51	* 黑莓 10
michael@0	52	* 瀏覽器
michael@0	53	* 火狐瀏覽器的作業系統
michael@0	54	* iOS
michael@0	55	* 泰
michael@0	56	* Windows Phone 7 和 8
michael@0	57	* Windows 8
michael@0	58
michael@0	59	## device.model
michael@0	60
michael@0	61	`device.model`返回設備的模型或產品的名稱。值由設備製造商設置和同一產品的不同版本可能不同。
michael@0	62
michael@0	63	### 支援的平臺
michael@0	64
michael@0	65	* Android 系統
michael@0	66	* 黑莓 10
michael@0	67	* 瀏覽器
michael@0	68	* iOS
michael@0	69	* 泰
michael@0	70	* Windows Phone 7 和 8
michael@0	71	* Windows 8
michael@0	72
michael@0	73	### 快速的示例
michael@0	74
michael@0	75	// Android: Nexus One returns "Passion" (Nexus One code name)
michael@0	76	// Motorola Droid returns "voles"
michael@0	77	// BlackBerry: Torch 9800 returns "9800"
michael@0	78	// Browser: Google Chrome returns "Chrome"
michael@0	79	// Safari returns "Safari"
michael@0	80	// 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 ；
michael@0	81
michael@0	82
michael@0	83	### Android 的怪癖
michael@0	84
michael@0	85	* 獲取[產品名稱][1]而不是[產品型號名稱][2]，這往往是生產代碼名稱。 例如，Nexus One 返回 `Passion` ，和摩托羅拉 Droid 返回`voles`.
michael@0	86
michael@0	87	[1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
michael@0	88	[2]: http://developer.android.com/reference/android/os/Build.html#MODEL
michael@0	89
michael@0	90	### Tizen 怪癖
michael@0	91
michael@0	92	* 例如，返回與供應商指派的設備模型`TIZEN`
michael@0	93
michael@0	94	### Windows Phone 7 和 8 怪癖
michael@0	95
michael@0	96	* 返回由製造商指定的設備模型。例如，三星焦點返回`SGH-i917`.
michael@0	97
michael@0	98	## device.platform
michael@0	99
michael@0	100	獲取設備的作業系統名稱。
michael@0	101
michael@0	102	var string = device.platform;
michael@0	103
michael@0	104
michael@0	105	### 支援的平臺
michael@0	106
michael@0	107	* Android 系統
michael@0	108	* 黑莓 10
michael@0	109	* Browser4
michael@0	110	* 火狐瀏覽器的作業系統
michael@0	111	* iOS
michael@0	112	* 泰
michael@0	113	* Windows Phone 7 和 8
michael@0	114	* Windows 8
michael@0	115
michael@0	116	### 快速的示例
michael@0	117
michael@0	118	// Depending on the device, a few examples are:
michael@0	119	// - "Android"
michael@0	120	// - "BlackBerry 10"
michael@0	121	// - Browser: returns "MacIntel" on Mac
michael@0	122	// returns "Win32" on Windows
michael@0	123	// - "iOS"
michael@0	124	// - "WinCE"
michael@0	125	// - "Tizen"
michael@0	126	var devicePlatform = device.platform;
michael@0	127
michael@0	128
michael@0	129	### Windows Phone 7 的怪癖
michael@0	130
michael@0	131	Windows Phone 7 設備報告作為平臺`WinCE`.
michael@0	132
michael@0	133	### Windows Phone 8 怪癖
michael@0	134
michael@0	135	Windows Phone 8 設備報告作為平臺`Win32NT`.
michael@0	136
michael@0	137	## device.uuid
michael@0	138
michael@0	139	獲取設備的通用唯一識別碼 ([UUID][3]).
michael@0	140
michael@0	141	[3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
michael@0	142
michael@0	143	var string = device.uuid;
michael@0	144
michael@0	145
michael@0	146	### 說明
michael@0	147
michael@0	148	如何生成一個 UUID 的細節由設備製造商和特定于設備的平臺或模型。
michael@0	149
michael@0	150	### 支援的平臺
michael@0	151
michael@0	152	* Android 系統
michael@0	153	* 黑莓 10
michael@0	154	* iOS
michael@0	155	* Tizen
michael@0	156	* Windows Phone 7 和 8
michael@0	157	* Windows 8
michael@0	158
michael@0	159	### 快速的示例
michael@0	160
michael@0	161	/ / Android： 一個隨機的 64 位整數 （作為字串返回，再次!) / / 上設備的第一次啟動生成的整數 / / / / 黑莓手機： 返回設備的 PIN 號碼 / / 這是九個數字的唯一整數 （作為字串，雖然!) / / / / iPhone： （從 UIDevice 類文檔解釋） / / 返回一個字串的雜湊值創建的多個硬體標識。
michael@0	162	/ / 它保證是唯一的每個設備並不能綁 / / 到使用者帳戶。
michael@0	163	/ / Windows Phone 7： 返回的雜湊代碼的設備 + 當前使用者，/ / 如果未定義使用者，則一個 guid 生成的並且將會保留直到卸載該應用程式 / / Tizen： 返回設備 IMEI （國際行動裝置身份或 IMEI 是一個數位 / / 獨有的每一個 UMTS 和 GSM 行動電話。
michael@0	164	var deviceID = device.uuid;
michael@0	165
michael@0	166
michael@0	167	### iOS 怪癖
michael@0	168
michael@0	169	`uuid`在 iOS 不是唯一的一種裝置，但對於每個應用程式，為每個安裝而異。 如果您刪除並重新安裝該應用程式，它更改和可能還當你升級 iOS，或甚至升級每個版本 （iOS 5.1 中存在明顯的） 的應用程式。 `uuid`不是一個可靠的值。
michael@0	170
michael@0	171	### Windows Phone 7 和 8 怪癖
michael@0	172
michael@0	173	`uuid`為 Windows Phone 7 須經許可 `ID_CAP_IDENTITY_DEVICE` 。 Microsoft 可能會很快棄用此屬性。 如果沒有可用的能力，應用程式將生成設備上應用程式的安裝過程中保持持續的 guid。
michael@0	174
michael@0	175	## device.version
michael@0	176
michael@0	177	獲取作業系統版本。
michael@0	178
michael@0	179	var string = device.version;
michael@0	180
michael@0	181
michael@0	182	### 支援的平臺
michael@0	183
michael@0	184	* Android 2.1 +
michael@0	185	* 黑莓 10
michael@0	186	* 瀏覽器
michael@0	187	* iOS
michael@0	188	* 泰
michael@0	189	* Windows Phone 7 和 8
michael@0	190	* Windows 8
michael@0	191
michael@0	192	### 快速的示例
michael@0	193
michael@0	194	// Android: Froyo OS would return "2.2"
michael@0	195	// Eclair OS would return "2.1", "2.0.1", or "2.0"
michael@0	196	// Version can also return update level "2.1-update1"
michael@0	197	//
michael@0	198	// BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
michael@0	199	//
michael@0	200	// Browser: Returns version number for the browser
michael@0	201	//
michael@0	202	// iPhone: iOS 3.2 returns "3.2"
michael@0	203	//
michael@0	204	// Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
michael@0	205	// Tizen: returns "TIZEN_20120425_2"
michael@0	206	var deviceVersion = device.version;