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# cordova-plugin-device
 21
 22Ten 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 cordova-plugin-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
 45Pobierz 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
100Uzyskać 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
131Urządzenia Windows Phone 7 raport platformy jako`WinCE`.
132
133### Windows Phone 8 dziwactwa
134
135Urządzenia Windows Phone 8 raport platformy jako`Win32NT`.
136
137## device.uuid
138
139Się 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
148Szczegół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
177Pobierz 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;