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
 22Ce plugin définit un global `device` objet qui décrit le matériel et les logiciels de l'appareil. Bien que l'objet est dans la portée globale, il n'est pas disponible jusqu'après la `deviceready` événement.
 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## Propriétés
 36
 37*   device.cordova
 38*   device.model
 39*   device.platform
 40*   device.uuid
 41*   device.version
 42
 43## device.cordova
 44
 45Retourne la version de Cordova en cours d'exécution sur l'appareil.
 46
 47### Plates-formes prises en charge
 48
 49*   Amazon Fire OS
 50*   Android
 51*   BlackBerry 10
 52*   Navigateur
 53*   Firefox OS
 54*   iOS
 55*   Paciarelli
 56*   Windows Phone 7 et 8
 57*   Windows 8
 58
 59## device.model
 60
 61L'objet `device.model` retourne le nom du modèle de l'appareil/produit. Cette valeur est définie par le fabricant du périphérique et peut varier entre les différentes versions d'un même produit.
 62
 63### Plates-formes prises en charge
 64
 65*   Android
 66*   BlackBerry 10
 67*   Navigateur
 68*   iOS
 69*   Paciarelli
 70*   Windows Phone 7 et 8
 71*   Windows 8
 72
 73### Petit exemple
 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. Voir http://theiphonewiki.com/wiki/index.php?title=Models
 81    //
 82    var model = device.model;
 83    
 84
 85### Quirks Android
 86
 87*   Retourne le [nom du produit][1] au lieu du [nom du modèle][2], ce qui équivaut souvent au nom de code de production. Par exemple, `Passion` pour le Nexus One et `voles` pour le Motorola Droid.
 88
 89 [1]: http://developer.android.com/reference/android/os/Build.html#PRODUCT
 90 [2]: http://developer.android.com/reference/android/os/Build.html#MODEL
 91
 92### Bizarreries de paciarelli
 93
 94*   Retourne le modèle du dispositif, assigné par le vendeur, par exemple `TIZEN`
 95
 96### Windows Phone 7 et 8 Quirks
 97
 98*   Retourne le modèle de l'appareil spécifié par le fabricant. Par exemple `SGH-i917` pour le Samsung Focus.
 99
100## device.platform
101
102Obtenir le nom de système d'exploitation de l'appareil.
103
104    var string = device.platform;
105    
106
107### Plates-formes prises en charge
108
109*   Android
110*   BlackBerry 10
111*   Browser4
112*   Firefox OS
113*   iOS
114*   Paciarelli
115*   Windows Phone 7 et 8
116*   Windows 8
117
118### Petit exemple
119
120    // Depending on the device, a few examples are:
121    //   - "Android"
122    //   - "BlackBerry 10"
123    //   - Browser:         returns "MacIntel" on Mac
124    //                      returns "Win32" on Windows
125    //   - "iOS"
126    //   - "WinCE"
127    //   - "Tizen"
128    var devicePlatform = device.platform;
129    
130
131### Windows Phone 7 Quirks
132
133Appareils Windows Phone 7 rapport de la plate-forme comme`WinCE`.
134
135### Notes au sujet de Windows Phone 8
136
137Appareils Windows Phone 8 rapport de la plate-forme comme`Win32NT`.
138
139## device.uuid
140
141Obtenir Universally Unique Identifier de l'appareil ([UUID][3]).
142
143 [3]: http://en.wikipedia.org/wiki/Universally_Unique_Identifier
144
145    var string = device.uuid;
146    
147
148### Description
149
150Les détails de comment un UUID généré sont déterminées par le fabricant du périphérique et sont spécifiques à la plate-forme ou le modèle de l'appareil.
151
152### Plates-formes prises en charge
153
154*   Android
155*   BlackBerry 10
156*   iOS
157*   Paciarelli
158*   Windows Phone 7 et 8
159*   Windows 8
160
161### Petit exemple
162
163    // Android : retourne un nombre entier 64-bit aléatoire (sous la forme d'une chaîne de caractères, encore !)
164    // Ce nombre entier est généré lors du premier démarrage de l'appareil
165    //
166    // BlackBerry : retourne le numéro PIN de l'appareil
167    // Il s'agit d'un nombre entier unique à neuf chiffres (sous la forme d'une chaîne de caractères cependant !)
168    //
169    // iPhone : (copié depuis la documentation de la classe UIDevice)
170    // Retourne une chaîne de caractères générée à partir de plusieurs caractéristiques matérielles.
171    / / Il est garanti pour être unique pour chaque appareil et ne peut pas être lié / / pour le compte d'utilisateur.
172    // Windows Phone 7 : retourne un hashage généré à partir de appareil+utilisateur actuel,
173    // si aucun utilisateur n'est défini, un guid est généré persistera jusqu'à ce que l'application soit désinstallée
174    // Tizen : retourne le numéro IMEI (International Mobile Equipment Identity) de l'appareil, ce numéro est
175    // unique pour chaque téléphone GSM et UMTS.
176    var deviceID = device.uuid;
177    
178
179### Spécificités iOS
180
181Le `uuid` sur iOS n'est pas propre à un périphérique, mais varie pour chaque application, pour chaque installation. Elle change si vous supprimez, puis réinstallez l'application, et éventuellement aussi quand vous mettre à jour d'iOS, ou même mettre à jour le soft par version (apparent dans iOS 5.1). Le `uuid` n'est pas une valeur fiable.
182
183### Windows Phone 7 et 8 Quirks
184
185Le `uuid` pour Windows Phone 7 requiert l'autorisation `ID_CAP_IDENTITY_DEVICE` . Microsoft va probablement bientôt obsolète de cette propriété. Si la capacité n'est pas disponible, l'application génère un guid persistant qui est maintenu pendant toute la durée de l'installation de l'application sur le périphérique.
186
187## device.version
188
189Téléchargez la version de système d'exploitation.
190
191    var string = device.version;
192    
193
194### Plates-formes prises en charge
195
196*   Android 2.1+
197*   BlackBerry 10
198*   Navigateur
199*   iOS
200*   Paciarelli
201*   Windows Phone 7 et 8
202*   Windows 8
203
204### Petit exemple
205
206    // Android:    Froyo OS would return "2.2"
207    //             Eclair OS would return "2.1", "2.0.1", or "2.0"
208    //             Version can also return update level "2.1-update1"
209    //
210    // BlackBerry: Torch 9800 using OS 6.0 would return "6.0.0.600"
211    //
212    // Browser:    Returns version number for the browser
213    //
214    // iPhone:     iOS 3.2 returns "3.2"
215    //
216    // Windows Phone 7: returns current OS version number, ex. on Mango returns 7.10.7720
217    // Tizen: returns "TIZEN_20120425_2"
218    var deviceVersion = device.version;