| 15747 |
anikendra |
1 |
<!---
|
|
|
2 |
Licensed to the Apache Software Foundation (ASF) under one
|
|
|
3 |
or more contributor license agreements. See the NOTICE file
|
|
|
4 |
distributed with this work for additional information
|
|
|
5 |
regarding copyright ownership. The ASF licenses this file
|
|
|
6 |
to you under the Apache License, Version 2.0 (the
|
|
|
7 |
"License"); you may not use this file except in compliance
|
|
|
8 |
with the License. You may obtain a copy of the License at
|
|
|
9 |
|
|
|
10 |
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
11 |
|
|
|
12 |
Unless required by applicable law or agreed to in writing,
|
|
|
13 |
software distributed under the License is distributed on an
|
|
|
14 |
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
|
15 |
KIND, either express or implied. See the License for the
|
|
|
16 |
specific language governing permissions and limitations
|
|
|
17 |
under the License.
|
|
|
18 |
-->
|
|
|
19 |
|
|
|
20 |
# org.apache.cordova.device
|
|
|
21 |
|
|
|
22 |
Ten plugin określa globalne `device` obiekt, który opisuje urządzenia sprzętowe i programowe. Mimo, że obiekt jest w globalnym zasięgu, nie jest dostępne dopiero po `deviceready` zdarzenie.
|
|
|
23 |
|
|
|
24 |
document.addEventListener("deviceready", onDeviceReady, false);
|
|
|
25 |
function onDeviceReady() {
|
|
|
26 |
console.log(device.cordova);
|
|
|
27 |
}
|
|
|
28 |
|
|
|
29 |
|
|
|
30 |
## Instalacja
|
|
|
31 |
|
|
|
32 |
cordova plugin add org.apache.cordova.device
|
|
|
33 |
|
|
|
34 |
|
|
|
35 |
## Właściwości
|
|
|
36 |
|
|
|
37 |
* device.cordova
|
|
|
38 |
* device.model
|
|
|
39 |
* device.platform
|
|
|
40 |
* device.uuid
|
|
|
41 |
* device.version
|
|
|
42 |
|
|
|
43 |
## device.cordova
|
|
|
44 |
|
|
|
45 |
Pobierz wersję Cordova działa na urządzeniu.
|
|
|
46 |
|
|
|
47 |
### Obsługiwane platformy
|
|
|
48 |
|
|
|
49 |
* Amazon Fire OS
|
|
|
50 |
* Android
|
|
|
51 |
* BlackBerry 10
|
|
|
52 |
* Przeglądarka
|
|
|
53 |
* Firefox OS
|
|
|
54 |
* iOS
|
|
|
55 |
* Tizen
|
|
|
56 |
* Windows Phone 7 i 8
|
|
|
57 |
* Windows 8
|
|
|
58 |
|
|
|
59 |
## device.model
|
|
|
60 |
|
|
|
61 |
`device.model`Zwraca nazwę modelu lub produktu. Wartość jest zestaw przez producenta urządzenia i mogą się różnić między wersjami tego samego produktu.
|
|
|
62 |
|
|
|
63 |
### Obsługiwane platformy
|
|
|
64 |
|
|
|
65 |
* Android
|
|
|
66 |
* BlackBerry 10
|
|
|
67 |
* Przeglądarka
|
|
|
68 |
* iOS
|
|
|
69 |
* Tizen
|
|
|
70 |
* Windows Phone 7 i 8
|
|
|
71 |
* Windows 8
|
|
|
72 |
|
|
|
73 |
### Szybki przykład
|
|
|
74 |
|
|
|
75 |
// Android: Nexus One returns "Passion" (Nexus One code name)
|
|
|
76 |
// Motorola Droid returns "voles"
|
|
|
77 |
// BlackBerry: Torch 9800 returns "9800"
|
|
|
78 |
// Browser: Google Chrome returns "Chrome"
|
|
|
79 |
// Safari returns "Safari"
|
|
|
80 |
// iOS: for the iPad Mini, returns iPad2,5; iPhone 5 is iPhone 5,1. Zobacz http://theiphonewiki.com/wiki/index.php?title=Models / / modelu var = device.model;
|
|
|
81 |
|
|
|
82 |
|
|
|
83 |
### Dziwactwa Androida
|
|
|
84 |
|
|
|
85 |
* Pobiera [nazwę produktu][1] zamiast [nazwy modelu][2], który często jest nazwą kod produkcji. Na przykład, Nexus One zwraca `Passion` , i zwraca Motorola Droid`voles`.
|
|
|
86 |
|
|
|
87 |
[1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
|
|
|
88 |
[2]: http://developer.android.com/reference/android/os/Build.html#MODEL
|
|
|
89 |
|
|
|
90 |
### Dziwactwa Tizen
|
|
|
91 |
|
|
|
92 |
* Zwraca modelu urządzenia przypisane przez dostawcę, na przykład,`TIZEN`
|
|
|
93 |
|
|
|
94 |
### Windows Phone 7 i 8 dziwactwa
|
|
|
95 |
|
|
|
96 |
* Zwraca modelu urządzenia, określonej przez producenta. Na przykład Samsung ostrości zwraca`SGH-i917`.
|
|
|
97 |
|
|
|
98 |
## device.platform
|
|
|
99 |
|
|
|
100 |
Uzyskać nazwę systemu operacyjnego urządzenia.
|
|
|
101 |
|
|
|
102 |
var string = device.platform;
|
|
|
103 |
|
|
|
104 |
|
|
|
105 |
### Obsługiwane platformy
|
|
|
106 |
|
|
|
107 |
* Android
|
|
|
108 |
* BlackBerry 10
|
|
|
109 |
* Browser4
|
|
|
110 |
* Firefox OS
|
|
|
111 |
* iOS
|
|
|
112 |
* Tizen
|
|
|
113 |
* Windows Phone 7 i 8
|
|
|
114 |
* Windows 8
|
|
|
115 |
|
|
|
116 |
### Szybki przykład
|
|
|
117 |
|
|
|
118 |
// Depending on the device, a few examples are:
|
|
|
119 |
// - "Android"
|
|
|
120 |
// - "BlackBerry 10"
|
|
|
121 |
// - Browser: returns "MacIntel" on Mac
|
|
|
122 |
// returns "Win32" on Windows
|
|
|
123 |
// - "iOS"
|
|
|
124 |
// - "WinCE"
|
|
|
125 |
// - "Tizen"
|
|
|
126 |
var devicePlatform = device.platform;
|
|
|
127 |
|
|
|
128 |
|
|
|
129 |
### Dziwactwa Windows Phone 7
|
|
|
130 |
|
|
|
131 |
Urządzenia Windows Phone 7 raport platformy jako`WinCE`.
|
|
|
132 |
|
|
|
133 |
### Windows Phone 8 dziwactwa
|
|
|
134 |
|
|
|
135 |
Urządzenia Windows Phone 8 raport platformy jako`Win32NT`.
|
|
|
136 |
|
|
|
137 |
## device.uuid
|
|
|
138 |
|
|
|
139 |
Się urządzenia uniwersalnie unikatowy identyfikator ([UUID][3]).
|
|
|
140 |
|
|
|
141 |
[3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
|
|
|
142 |
|
|
|
143 |
var string = device.uuid;
|
|
|
144 |
|
|
|
145 |
|
|
|
146 |
### Opis
|
|
|
147 |
|
|
|
148 |
Szczegóły jak UUID jest generowane są określane przez producenta urządzenia i są specyficzne dla platformy lub modelu urządzenia.
|
|
|
149 |
|
|
|
150 |
### Obsługiwane platformy
|
|
|
151 |
|
|
|
152 |
* Android
|
|
|
153 |
* BlackBerry 10
|
|
|
154 |
* iOS
|
|
|
155 |
* Tizen
|
|
|
156 |
* Windows Phone 7 i 8
|
|
|
157 |
* Windows 8
|
|
|
158 |
|
|
|
159 |
### Szybki przykład
|
|
|
160 |
|
|
|
161 |
/ / Android: zwraca losowe 64-bitowa liczba całkowita (jako ciąg, znowu!) / / liczba całkowita jest generowany na pierwszego uruchomienia urządzenia / / / / BlackBerry: zwraca numer PIN urządzenia / / to jest unikatową liczbą całkowitą dziewięciu cyfr (jako ciąg, choć!) / / / / iPhone: (zacytowana w dokumentacji klasy UIDevice) / / zwraca ciąg wartości mieszania utworzone z wielu sprzętu identyfikuje.
|
|
|
162 |
Zapewniona jest unikatowy dla każdego urządzenia i nie może być związane z / do konta użytkownika.
|
|
|
163 |
/ / Windows Phone 7: zwraca wartość mieszania urządzenia + bieżący użytkownik, / / jeśli nie zdefiniowane przez użytkownika, identyfikator guid jest generowany i będzie trwać do czasu odinstalowania aplikacji / / Tizen: zwraca urządzenia IMEI (International Mobile Equipment Identity lub IMEI jest liczbą / / unikatowe dla każdego telefonu komórkowego GSM i UMTS.
|
|
|
164 |
var deviceID = device.uuid;
|
|
|
165 |
|
|
|
166 |
|
|
|
167 |
### iOS dziwactwo
|
|
|
168 |
|
|
|
169 |
`uuid`Na iOS nie jest przypisany do urządzenia, ale różni się dla każdej aplikacji, dla każdej instalacji. Zmienia się jeśli możesz usunąć i ponownie zainstalować aplikację, a ewentualnie także po aktualizacji iOS czy nawet uaktualnienia aplikacji dla wersji (widoczny w iOS 5.1). `uuid`Jest nie wiarygodne wartości.
|
|
|
170 |
|
|
|
171 |
### Windows Phone 7 i 8 dziwactwa
|
|
|
172 |
|
|
|
173 |
`uuid`Dla Windows Phone 7 wymaga uprawnień `ID_CAP_IDENTITY_DEVICE` . Microsoft będzie prawdopodobnie potępiać ten wkrótce. Jeśli funkcja nie jest dostępna, aplikacja generuje trwałe identyfikator guid, który jest utrzymywany przez czas trwania instalacji aplikacji na urządzeniu.
|
|
|
174 |
|
|
|
175 |
## device.version
|
|
|
176 |
|
|
|
177 |
Pobierz wersję systemu operacyjnego.
|
|
|
178 |
|
|
|
179 |
var string = device.version;
|
|
|
180 |
|
|
|
181 |
|
|
|
182 |
### Obsługiwane platformy
|
|
|
183 |
|
|
|
184 |
* Android 2.1 +
|
|
|
185 |
* BlackBerry 10
|
|
|
186 |
* Przeglądarka
|
|
|
187 |
* iOS
|
|
|
188 |
* Tizen
|
|
|
189 |
* Windows Phone 7 i 8
|
|
|
190 |
* Windows 8
|
|
|
191 |
|
|
|
192 |
### Szybki przykład
|
|
|
193 |
|
|
|
194 |
// Android: Froyo OS would return "2.2"
|
|
|
195 |
// Eclair OS would return "2.1", "2.0.1", or "2.0"
|
|
|
196 |
// Version can also return update level "2.1-update1"
|
|
|
197 |
//
|
|
|
198 |
// BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
|
|
|
199 |
//
|
|
|
200 |
// Browser: Returns version number for the browser
|
|
|
201 |
//
|
|
|
202 |
// iPhone: iOS 3.2 returns "3.2"
|
|
|
203 |
//
|
|
|
204 |
// Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
|
|
|
205 |
// Tizen: returns "TIZEN_20120425_2"
|
|
|
206 |
var deviceVersion = device.version;
|