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