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
 22Dieses Plugin definiert eine globale `device` -Objekt, das des Geräts Hard- und Software beschreibt. Das Objekt im globalen Gültigkeitsbereich ist es zwar nicht verfügbar bis nach dem `deviceready` Ereignis.
 23
 24    document.addEventListener("deviceready", onDeviceReady, false);
 25    function onDeviceReady() {
 26        console.log(device.cordova);
 27    }
 28    
 29
 30## Installation
 31
 32    cordova plugin add cordova-plugin-device
 33    
 34
 35## Eigenschaften
 36
 37*   device.cordova
 38*   device.model
 39*   device.platform
 40*   device.uuid
 41*   device.version
 42
 43## device.cordova
 44
 45Rufen Sie die Version von Cordova, die auf dem Gerät ausgeführt.
 46
 47### Unterstützte Plattformen
 48
 49*   Amazon Fire OS
 50*   Android
 51*   BlackBerry 10
 52*   Browser
 53*   Firefox OS
 54*   iOS
 55*   Tizen
 56*   Windows Phone 7 und 8
 57*   Windows 8
 58
 59## device.model
 60
 61Die `device.model` gibt den Namen der Modell- oder des Geräts zurück. Der Wert wird vom Gerätehersteller festgelegt und kann zwischen den Versionen des gleichen Produkts unterschiedlich sein.
 62
 63### Unterstützte Plattformen
 64
 65*   Android
 66*   BlackBerry 10
 67*   Browser
 68*   iOS
 69*   Tizen
 70*   Windows Phone 7 und 8
 71*   Windows 8
 72
 73### Kurzes Beispiel
 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. Finden Sie unter http://theiphonewiki.com/wiki/index.php?title=Models / / Var-Modell = device.model;
 81    
 82
 83### Android Eigenarten
 84
 85*   Ruft den [Produktname][1] anstelle des [Modellnamens][2], das ist oft der Codename für die Produktion. Beispielsweise das Nexus One gibt `Passion` , und Motorola Droid gibt`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### Tizen Macken
 91
 92*   Gibt z. B. das Gerätemodell von dem Kreditor zugeordnet,`TIZEN`
 93
 94### Windows Phone 7 und 8 Eigenarten
 95
 96*   Gibt das vom Hersteller angegebenen Gerätemodell zurück. Beispielsweise gibt der Samsung-Fokus`SGH-i917`.
 97
 98## device.platform
 99
100Name des Betriebssystems des Geräts zu erhalten.
101
102    var string = device.platform;
103    
104
105### Unterstützte Plattformen
106
107*   Android
108*   BlackBerry 10
109*   Browser4
110*   Firefox OS
111*   iOS
112*   Tizen
113*   Windows Phone 7 und 8
114*   Windows 8
115
116### Kurzes Beispiel
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### Windows Phone 7 Macken
130
131Windows Phone 7 Geräte melden die Plattform als`WinCE`.
132
133### Windows Phone 8 Macken
134
135Windows Phone 8 Geräte melden die Plattform als`Win32NT`.
136
137## device.uuid
138
139Des Geräts Universally Unique Identifier ([UUID][3] zu erhalten).
140
141 [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
142
143    var string = device.uuid;
144    
145
146### Beschreibung
147
148Die Details wie eine UUID generiert wird werden vom Gerätehersteller und beziehen sich auf die Plattform oder das Modell des Geräts.
149
150### Unterstützte Plattformen
151
152*   Android
153*   BlackBerry 10
154*   iOS
155*   Tizen
156*   Windows Phone 7 und 8
157*   Windows 8
158
159### Kurzes Beispiel
160
161    / / Android: wird eine zufällige 64-Bit-Ganzzahl (als Zeichenfolge, wieder!) / / die ganze Zahl wird beim ersten Start des Geräts erzeugt / / / / BlackBerry: gibt die PIN-Nummer des Gerätes / / Dies ist eine neunstellige eindeutige Ganzzahl (als String, obwohl!) / / / / iPhone: (paraphrasiert aus der Dokumentation zur UIDevice-Klasse) / / liefert eine Reihe von Hash-Werte, die aus mehreren Hardware erstellt identifiziert.
162    / / Es ist gewährleistet, dass für jedes Gerät eindeutig sein und kann nicht gebunden werden / / an den Benutzer weitergeleitet.
163    / / Windows Phone 7: gibt einen Hash des Gerät + aktueller Benutzer, / / wenn der Benutzer nicht definiert ist, eine Guid generiert und wird weiter bestehen, bis die app deinstalliert wird / / Tizen: gibt das Gerät IMEI (International Mobile Equipment Identity oder IMEI ist eine Zahl / / einzigartig für jedes GSM- und UMTS-Handy.
164    var deviceID = device.uuid;
165    
166
167### iOS Quirk
168
169Die `uuid` auf iOS ist nicht eindeutig zu einem Gerät, aber für jede Anwendung, für jede Installation variiert. Es ändert sich, wenn Sie löschen und neu die app installieren, und möglicherweise auch beim iOS zu aktualisieren, oder auch ein Upgrade möglich die app pro Version (scheinbaren in iOS 5.1). Die `uuid` ist kein zuverlässiger Wert.
170
171### Windows Phone 7 und 8 Eigenarten
172
173Die `uuid` für Windows Phone 7 die Berechtigung erfordert `ID_CAP_IDENTITY_DEVICE` . Microsoft wird diese Eigenschaft wahrscheinlich bald abzuschaffen. Wenn die Funktion nicht verfügbar ist, generiert die Anwendung eine persistente Guid, die für die Dauer der Installation der Anwendung auf dem Gerät gewährleistet ist.
174
175## device.version
176
177Version des Betriebssystems zu erhalten.
178
179    var string = device.version;
180    
181
182### Unterstützte Plattformen
183
184*   Android 2.1 +
185*   BlackBerry 10
186*   Browser
187*   iOS
188*   Tizen
189*   Windows Phone 7 und 8
190*   Windows 8
191
192### Kurzes Beispiel
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;