Return-Path: X-Original-To: apmail-cordova-commits-archive@www.apache.org Delivered-To: apmail-cordova-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 9024811435 for ; Mon, 7 Jul 2014 17:50:17 +0000 (UTC) Received: (qmail 20115 invoked by uid 500); 7 Jul 2014 17:50:17 -0000 Delivered-To: apmail-cordova-commits-archive@cordova.apache.org Received: (qmail 20019 invoked by uid 500); 7 Jul 2014 17:50:17 -0000 Mailing-List: contact commits-help@cordova.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cordova.apache.org Delivered-To: mailing list commits@cordova.apache.org Received: (qmail 19990 invoked by uid 99); 7 Jul 2014 17:50:17 -0000 Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 07 Jul 2014 17:50:17 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id 309389A7EE0; Mon, 7 Jul 2014 17:50:17 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: ldeluca@apache.org To: commits@cordova.apache.org Date: Mon, 07 Jul 2014 17:50:18 -0000 Message-Id: <562b3ce88b4349379a9cd94b2e6c5245@git.apache.org> In-Reply-To: <6088f88466944d959a3905074b5273a7@git.apache.org> References: <6088f88466944d959a3905074b5273a7@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [2/7] git commit: Lisa testing pulling in plugins for plugin: cordova-plugin-device-motion Lisa testing pulling in plugins for plugin: cordova-plugin-device-motion Project: http://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion/repo Commit: http://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion/commit/033239ca Tree: http://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion/tree/033239ca Diff: http://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion/diff/033239ca Branch: refs/heads/master Commit: 033239ca1fcb8f64e73a749eb7c0d71bcfc9a636 Parents: f8220e6 Author: ldeluca Authored: Thu Feb 27 11:14:31 2014 -0500 Committer: ldeluca Committed: Thu Feb 27 11:14:31 2014 -0500 ---------------------------------------------------------------------- doc/fr/index.md | 145 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 145 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion/blob/033239ca/doc/fr/index.md ---------------------------------------------------------------------- diff --git a/doc/fr/index.md b/doc/fr/index.md new file mode 100644 index 0000000..f8142d2 --- /dev/null +++ b/doc/fr/index.md @@ -0,0 +1,145 @@ + + +# org.apache.cordova.device-motion + +Ce plugin permet d'accéder à l'accéléromètre de l'appareil. L'accéléromètre est un capteur de mouvement qui détecte la modification (*delta*) en mouvement par rapport à l'orientation actuelle de l'appareil, en trois dimensions le long de l'axe *x*, *y*et *z* . + +## Installation + + cordova plugin add org.apache.cordova.device-motion + + +## Plates-formes prises en charge + +* Amazon Fire OS +* Android +* BlackBerry 10 +* iOS +* Paciarelli +* Windows Phone 7 et 8 +* Windows 8 + +## Méthodes + +* navigator.accelerometer.getCurrentAcceleration +* navigator.accelerometer.watchAcceleration +* navigator.accelerometer.clearWatch + +## Objets + +* Acceleration + +## navigator.accelerometer.getCurrentAcceleration + +Renvoie l'accélération en cours sur les axes *x*, *y*et *z* . + +Ces valeurs d'accélération sont retournées à la fonction callback `accelerometerSuccess`. + + navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError); + + +### Exemple + + function onSuccess(acceleration) { + alert('Acceleration X: ' + acceleration.x + '\n' + + 'Acceleration Y: ' + acceleration.y + '\n' + + 'Acceleration Z: ' + acceleration.z + '\n' + + 'Timestamp: ' + acceleration.timestamp + '\n'); + }; + + function onError() { + alert('onError!'); + }; + + navigator.accelerometer.getCurrentAcceleration(onSuccess, onError); + + +### iOS Quirks + +* iOS ne permet pas d'obtenir l'accélération en cours à un instant donné. + +* Vous devez observer l'accélération et capturer ses données à un intervalle de temps donné. + +* De ce fait, la fonction `getCurrentAcceleration` renvoie la dernière valeur retournée par un appel à `watchAccelerometer`. + +## navigator.accelerometer.watchAcceleration + +Récupère le dispositif actuel de `Acceleration` à intervalle régulier, l'exécution de la `accelerometerSuccess` fonction de rappel chaque fois. Spécifiez l'intervalle, en millisecondes, via le `acceleratorOptions` de l'objet `frequency` paramètre. + +Le retourné regarder ID références intervalle de surveillance de l'accéléromètre et peut être utilisé avec `navigator.accelerometer.clearWatch` d'arrêter de regarder l'accéléromètre. + + var watchID = navigator.accelerometer.watchAcceleration(accelerometerSuccess, + accelerometerError, + [accelerometerOptions]); + + +* **accelerometerOptions**: Un objet avec les clés facultatives suivantes : + * **frequency**: Fréquence de récupération de l'`Acceleration` en millisecondes. *(Number)* (Défaut : 10000) + +### Exemple + + function onSuccess(acceleration) { + alert('Acceleration X: ' + acceleration.x + '\n' + + 'Acceleration Y: ' + acceleration.y + '\n' + + 'Acceleration Z: ' + acceleration.z + '\n' + + 'Timestamp: ' + acceleration.timestamp + '\n'); + }; + + function onError() { + alert('onError!'); + }; + + var options = { frequency: 3000 }; // Update every 3 seconds + + var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options); + + +### iOS Quirks + +L'API appelle la fonction de callback de succès à l'intervalle demandé mais restreint l'éventail des demandes à l'appareil entre 40ms et 1000ms. Par exemple, si vous demandez un intervalle de 3 secondes, (3000ms), l'API demande des données de l'appareil toutes les 1 seconde, mais exécute seulement le callback de succès toutes les 3 secondes. + +## navigator.accelerometer.clearWatch + +Arrêter la surveillance du `Acceleration` référencée par le paramètre `watchID`. + + navigator.accelerometer.clearWatch(watchID); + + +* **watchID**: l'ID retourné par`navigator.accelerometer.watchAcceleration`. + +### Exemple + + var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options); + + // ... later on ... + + navigator.accelerometer.clearWatch(watchID); + + +## Accélération + +Contient les données `Accelerometer` capturées à un moment donné dans le temps. Valeurs d'accélération comprennent l'effet de la pesanteur (9,81 m/s ^ 2), de sorte que lorsqu'un périphérique se trouve plat et face vers le haut, *x*, *y*, et *z* valeurs retournées doivent être `` , `` , et`9.81`. + +### Propriétés + +* **x**: Valeur de l'accélération sur l'axe des x. (en m/s^2) *(Number)* +* **y**: Valeur de l'accélération sur l'axe des y. (en m/s^2) *(Number)* +* **y**: Valeur de l'accélération sur l'axe des z. (en m/s^2) *(Number)* +* **timestamp**: Date de création en millisecondes. *(DOMTimeStamp)* \ No newline at end of file