michael@0: <!---
michael@0:     Licensed to the Apache Software Foundation (ASF) under one
michael@0:     or more contributor license agreements.  See the NOTICE file
michael@0:     distributed with this work for additional information
michael@0:     regarding copyright ownership.  The ASF licenses this file
michael@0:     to you under the Apache License, Version 2.0 (the
michael@0:     "License"); you may not use this file except in compliance
michael@0:     with the License.  You may obtain a copy of the License at
michael@0: 
michael@0:       http://www.apache.org/licenses/LICENSE-2.0
michael@0: 
michael@0:     Unless required by applicable law or agreed to in writing,
michael@0:     software distributed under the License is distributed on an
michael@0:     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
michael@0:     KIND, either express or implied.  See the License for the
michael@0:     specific language governing permissions and limitations
michael@0:     under the License.
michael@0: -->
michael@0: 
michael@0: # org.apache.cordova.device
michael@0: 
michael@0: Dieses 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.
michael@0: 
michael@0:     document.addEventListener("deviceready", onDeviceReady, false);
michael@0:     function onDeviceReady() {
michael@0:         console.log(device.cordova);
michael@0:     }
michael@0:     
michael@0: 
michael@0: ## Installation
michael@0: 
michael@0:     cordova plugin add org.apache.cordova.device
michael@0:     
michael@0: 
michael@0: ## Eigenschaften
michael@0: 
michael@0: *   device.cordova
michael@0: *   device.model
michael@0: *   device.platform
michael@0: *   device.uuid
michael@0: *   device.version
michael@0: 
michael@0: ## device.cordova
michael@0: 
michael@0: Rufen Sie die Version von Cordova, die auf dem Gerät ausgeführt.
michael@0: 
michael@0: ### Unterstützte Plattformen
michael@0: 
michael@0: *   Amazon Fire OS
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Browser
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 und 8
michael@0: *   Windows 8
michael@0: 
michael@0: ## device.model
michael@0: 
michael@0: Die `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.
michael@0: 
michael@0: ### Unterstützte Plattformen
michael@0: 
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Browser
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 und 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Kurzes Beispiel
michael@0: 
michael@0:     // Android:    Nexus One       returns "Passion" (Nexus One code name)
michael@0:     //             Motorola Droid  returns "voles"
michael@0:     // BlackBerry: Torch 9800      returns "9800"
michael@0:     // Browser:    Google Chrome   returns "Chrome"
michael@0:     //             Safari          returns "Safari"
michael@0:     // 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;
michael@0:     
michael@0: 
michael@0: ### Android Eigenarten
michael@0: 
michael@0: *   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`.
michael@0: 
michael@0:  [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
michael@0:  [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
michael@0: 
michael@0: ### Tizen Macken
michael@0: 
michael@0: *   Gibt z. B. das Gerätemodell von dem Kreditor zugeordnet,`TIZEN`
michael@0: 
michael@0: ### Windows Phone 7 und 8 Eigenarten
michael@0: 
michael@0: *   Gibt das vom Hersteller angegebenen Gerätemodell zurück. Beispielsweise gibt der Samsung-Fokus`SGH-i917`.
michael@0: 
michael@0: ## device.platform
michael@0: 
michael@0: Name des Betriebssystems des Geräts zu erhalten.
michael@0: 
michael@0:     var string = device.platform;
michael@0:     
michael@0: 
michael@0: ### Unterstützte Plattformen
michael@0: 
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   Browser4
michael@0: *   Firefox OS
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 und 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Kurzes Beispiel
michael@0: 
michael@0:     // Depending on the device, a few examples are:
michael@0:     //   - "Android"
michael@0:     //   - "BlackBerry 10"
michael@0:     //   - Browser:         returns "MacIntel" on Mac
michael@0:     //                      returns "Win32" on Windows
michael@0:     //   - "iOS"
michael@0:     //   - "WinCE"
michael@0:     //   - "Tizen"
michael@0:     var devicePlatform = device.platform;
michael@0:     
michael@0: 
michael@0: ### Windows Phone 7 Macken
michael@0: 
michael@0: Windows Phone 7 Geräte melden die Plattform als`WinCE`.
michael@0: 
michael@0: ### Windows Phone 8 Macken
michael@0: 
michael@0: Windows Phone 8 Geräte melden die Plattform als`Win32NT`.
michael@0: 
michael@0: ## device.uuid
michael@0: 
michael@0: Des Geräts Universally Unique Identifier ([UUID][3] zu erhalten).
michael@0: 
michael@0:  [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
michael@0: 
michael@0:     var string = device.uuid;
michael@0:     
michael@0: 
michael@0: ### Beschreibung
michael@0: 
michael@0: Die Details wie eine UUID generiert wird werden vom Gerätehersteller und beziehen sich auf die Plattform oder das Modell des Geräts.
michael@0: 
michael@0: ### Unterstützte Plattformen
michael@0: 
michael@0: *   Android
michael@0: *   BlackBerry 10
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 und 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Kurzes Beispiel
michael@0: 
michael@0:     / / 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.
michael@0:     / / Es ist gewährleistet, dass für jedes Gerät eindeutig sein und kann nicht gebunden werden / / an den Benutzer weitergeleitet.
michael@0:     / / 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.
michael@0:     var deviceID = device.uuid;
michael@0:     
michael@0: 
michael@0: ### iOS Quirk
michael@0: 
michael@0: Die `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.
michael@0: 
michael@0: ### Windows Phone 7 und 8 Eigenarten
michael@0: 
michael@0: Die `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.
michael@0: 
michael@0: ## device.version
michael@0: 
michael@0: Version des Betriebssystems zu erhalten.
michael@0: 
michael@0:     var string = device.version;
michael@0:     
michael@0: 
michael@0: ### Unterstützte Plattformen
michael@0: 
michael@0: *   Android 2.1 +
michael@0: *   BlackBerry 10
michael@0: *   Browser
michael@0: *   iOS
michael@0: *   Tizen
michael@0: *   Windows Phone 7 und 8
michael@0: *   Windows 8
michael@0: 
michael@0: ### Kurzes Beispiel
michael@0: 
michael@0:     // Android:    Froyo OS would return "2.2"
michael@0:     //             Eclair OS would return "2.1", "2.0.1", or "2.0"
michael@0:     //             Version can also return update level "2.1-update1"
michael@0:     //
michael@0:     // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
michael@0:     //
michael@0:     // Browser:    Returns version number for the browser
michael@0:     //
michael@0:     // iPhone:     iOS 3.2 returns "3.2"
michael@0:     //
michael@0:     // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
michael@0:     // Tizen: returns "TIZEN_20120425_2"
michael@0:     var deviceVersion = device.version;