You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

202 lines
6.8 KiB

8 years ago
  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. # cordova-plugin-device
  20. [![Build Status](https://travis-ci.org/apache/cordova-plugin-device.svg?branch=master)](https://travis-ci.org/apache/cordova-plugin-device)
  21. 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.
  22. document.addEventListener("deviceready", onDeviceReady, false);
  23. function onDeviceReady() {
  24. console.log(device.cordova);
  25. }
  26. ## Installation
  27. cordova plugin add cordova-plugin-device
  28. ## Eigenschaften
  29. * device.cordova
  30. * device.model
  31. * device.platform
  32. * device.uuid
  33. * device.version
  34. ## device.cordova
  35. Rufen Sie die Version von Cordova, die auf dem Gerät ausgeführt.
  36. ### Unterstützte Plattformen
  37. * Amazon Fire OS
  38. * Android
  39. * BlackBerry 10
  40. * Browser
  41. * Firefox OS
  42. * iOS
  43. * Tizen
  44. * Windows Phone 7 und 8
  45. * Windows 8
  46. ## device.model
  47. 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.
  48. ### Unterstützte Plattformen
  49. * Android
  50. * BlackBerry 10
  51. * Browser
  52. * iOS
  53. * Tizen
  54. * Windows Phone 7 und 8
  55. * Windows 8
  56. ### Kurzes Beispiel
  57. // Android: Nexus One returns "Passion" (Nexus One code name)
  58. // Motorola Droid returns "voles"
  59. // BlackBerry: Torch 9800 returns "9800"
  60. // Browser: Google Chrome returns "Chrome"
  61. // Safari returns "Safari"
  62. // 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;
  63. ### Android Eigenarten
  64. * 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`.
  65. ### Tizen Macken
  66. * Gibt z. B. das Gerätemodell von dem Kreditor zugeordnet,`TIZEN`
  67. ### Windows Phone 7 und 8 Eigenarten
  68. * Gibt das vom Hersteller angegebenen Gerätemodell zurück. Beispielsweise gibt der Samsung-Fokus`SGH-i917`.
  69. ## device.platform
  70. Name des Betriebssystems des Geräts zu erhalten.
  71. var string = device.platform;
  72. ### Unterstützte Plattformen
  73. * Android
  74. * BlackBerry 10
  75. * Browser4
  76. * Firefox OS
  77. * iOS
  78. * Tizen
  79. * Windows Phone 7 und 8
  80. * Windows 8
  81. ### Kurzes Beispiel
  82. // Depending on the device, a few examples are:
  83. // - "Android"
  84. // - "BlackBerry 10"
  85. // - Browser: returns "MacIntel" on Mac
  86. // returns "Win32" on Windows
  87. // - "iOS"
  88. // - "WinCE"
  89. // - "Tizen"
  90. var devicePlatform = device.platform;
  91. ### Windows Phone 7 Macken
  92. Windows Phone 7 Geräte melden die Plattform als`WinCE`.
  93. ### Windows Phone 8 Macken
  94. Windows Phone 8 Geräte melden die Plattform als`Win32NT`.
  95. ## device.uuid
  96. Des Geräts Universally Unique Identifier ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier) zu erhalten).
  97. var string = device.uuid;
  98. ### Beschreibung
  99. Die Details wie eine UUID generiert wird werden vom Gerätehersteller und beziehen sich auf die Plattform oder das Modell des Geräts.
  100. ### Unterstützte Plattformen
  101. * Android
  102. * BlackBerry 10
  103. * iOS
  104. * Tizen
  105. * Windows Phone 7 und 8
  106. * Windows 8
  107. ### Kurzes Beispiel
  108. / / 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.
  109. / / Es ist gewährleistet, dass für jedes Gerät eindeutig sein und kann nicht gebunden werden / / an den Benutzer weitergeleitet.
  110. / / 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.
  111. var deviceID = device.uuid;
  112. ### iOS Quirk
  113. 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.
  114. ### Windows Phone 7 und 8 Eigenarten
  115. 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.
  116. ## device.version
  117. Version des Betriebssystems zu erhalten.
  118. var string = device.version;
  119. ### Unterstützte Plattformen
  120. * Android 2.1 +
  121. * BlackBerry 10
  122. * Browser
  123. * iOS
  124. * Tizen
  125. * Windows Phone 7 und 8
  126. * Windows 8
  127. ### Kurzes Beispiel
  128. // Android: Froyo OS would return "2.2"
  129. // Eclair OS would return "2.1", "2.0.1", or "2.0"
  130. // Version can also return update level "2.1-update1"
  131. //
  132. // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
  133. //
  134. // Browser: Returns version number for the browser
  135. //
  136. // iPhone: iOS 3.2 returns "3.2"
  137. //
  138. // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
  139. // Tizen: returns "TIZEN_20120425_2"
  140. var deviceVersion = device.version;