1<!--
  2# license: 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
 22[![Build Status](https://travis-ci.org/apache/cordova-plugin-device.svg?branch=master)](https://travis-ci.org/apache/cordova-plugin-device)
 23
 24Dieses 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.
 25
 26    document.addEventListener("deviceready", onDeviceReady, false);
 27    function onDeviceReady() {
 28        console.log(device.cordova);
 29    }
 30    
 31
 32## Installation
 33
 34    cordova plugin add cordova-plugin-device
 35    
 36
 37## Eigenschaften
 38
 39  * device.cordova
 40  * device.model
 41  * device.platform
 42  * device.uuid
 43  * device.version
 44
 45## device.cordova
 46
 47Rufen Sie die Version von Cordova, die auf dem Gerät ausgeführt.
 48
 49### Unterstützte Plattformen
 50
 51  * Amazon Fire OS
 52  * Android
 53  * BlackBerry 10
 54  * Browser
 55  * Firefox OS
 56  * iOS
 57  * Tizen
 58  * Windows Phone 7 und 8
 59  * Windows 8
 60
 61## device.model
 62
 63Die `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.
 64
 65### Unterstützte Plattformen
 66
 67  * Android
 68  * BlackBerry 10
 69  * Browser
 70  * iOS
 71  * Tizen
 72  * Windows Phone 7 und 8
 73  * Windows 8
 74
 75### Kurzes Beispiel
 76
 77    // Android:    Nexus One       returns "Passion" (Nexus One code name)
 78    //             Motorola Droid  returns "voles"
 79    // BlackBerry: Torch 9800      returns "9800"
 80    // Browser:    Google Chrome   returns "Chrome"
 81    //             Safari          returns "Safari"
 82    // 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;
 83    
 84
 85### Android Eigenarten
 86
 87  * Ruft den [Produktname](http://developer.android.com/reference/android/os/Build.html#PRODUCT) anstelle des [Modellnamens](http://developer.android.com/reference/android/os/Build.html#MODEL), das ist oft der Codename für die Produktion. Beispielsweise das Nexus One gibt `Passion` , und Motorola Droid gibt`voles`.
 88
 89### Tizen Macken
 90
 91  * Gibt z. B. das Gerätemodell von dem Kreditor zugeordnet,`TIZEN`
 92
 93### Windows Phone 7 und 8 Eigenarten
 94
 95  * Gibt das vom Hersteller angegebenen Gerätemodell zurück. Beispielsweise gibt der Samsung-Fokus`SGH-i917`.
 96
 97## device.platform
 98
 99Name des Betriebssystems des Geräts zu erhalten.
100
101    var string = device.platform;
102    
103
104### Unterstützte Plattformen
105
106  * Android
107  * BlackBerry 10
108  * Browser4
109  * Firefox OS
110  * iOS
111  * Tizen
112  * Windows Phone 7 und 8
113  * Windows 8
114
115### Kurzes Beispiel
116
117    // Depending on the device, a few examples are:
118    //   - "Android"
119    //   - "BlackBerry 10"
120    //   - Browser:         returns "MacIntel" on Mac
121    //                      returns "Win32" on Windows
122    //   - "iOS"
123    //   - "WinCE"
124    //   - "Tizen"
125    var devicePlatform = device.platform;
126    
127
128### Windows Phone 7 Macken
129
130Windows Phone 7 Geräte melden die Plattform als`WinCE`.
131
132### Windows Phone 8 Macken
133
134Windows Phone 8 Geräte melden die Plattform als`Win32NT`.
135
136## device.uuid
137
138Des Geräts Universally Unique Identifier ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier) zu erhalten).
139
140    var string = device.uuid;
141    
142
143### Beschreibung
144
145Die Details wie eine UUID generiert wird werden vom Gerätehersteller und beziehen sich auf die Plattform oder das Modell des Geräts.
146
147### Unterstützte Plattformen
148
149  * Android
150  * BlackBerry 10
151  * iOS
152  * Tizen
153  * Windows Phone 7 und 8
154  * Windows 8
155
156### Kurzes Beispiel
157
158    / / 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.
159    / / Es ist gewährleistet, dass für jedes Gerät eindeutig sein und kann nicht gebunden werden / / an den Benutzer weitergeleitet.
160    / / 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.
161    var deviceID = device.uuid;
162    
163
164### iOS Quirk
165
166Die `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.
167
168### Windows Phone 7 und 8 Eigenarten
169
170Die `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.
171
172## device.version
173
174Version des Betriebssystems zu erhalten.
175
176    var string = device.version;
177    
178
179### Unterstützte Plattformen
180
181  * Android 2.1 +
182  * BlackBerry 10
183  * Browser
184  * iOS
185  * Tizen
186  * Windows Phone 7 und 8
187  * Windows 8
188
189### Kurzes Beispiel
190
191    // Android:    Froyo OS would return "2.2"
192    //             Eclair OS would return "2.1", "2.0.1", or "2.0"
193    //             Version can also return update level "2.1-update1"
194    //
195    // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
196    //
197    // Browser:    Returns version number for the browser
198    //
199    // iPhone:     iOS 3.2 returns "3.2"
200    //
201    // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
202    // Tizen: returns "TIZEN_20120425_2"
203    var deviceVersion = device.version;