Return-Path: X-Original-To: apmail-incubator-callback-commits-archive@minotaur.apache.org Delivered-To: apmail-incubator-callback-commits-archive@minotaur.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id B3C63BD0B for ; Fri, 20 Jan 2012 19:56:33 +0000 (UTC) Received: (qmail 54758 invoked by uid 500); 20 Jan 2012 19:56:33 -0000 Delivered-To: apmail-incubator-callback-commits-archive@incubator.apache.org Received: (qmail 54733 invoked by uid 500); 20 Jan 2012 19:56:33 -0000 Mailing-List: contact callback-commits-help@incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: callback-dev@incubator.apache.org Delivered-To: mailing list callback-commits@incubator.apache.org Received: (qmail 54726 invoked by uid 99); 20 Jan 2012 19:56:33 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 20 Jan 2012 19:56:33 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED,T_FILL_THIS_FORM_SHORT X-Spam-Check-By: apache.org Received: from [140.211.11.114] (HELO tyr.zones.apache.org) (140.211.11.114) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 20 Jan 2012 19:56:24 +0000 Received: by tyr.zones.apache.org (Postfix, from userid 65534) id 0FE0E3189F8; Fri, 20 Jan 2012 19:56:00 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: filmaj@apache.org To: callback-commits@incubator.apache.org X-Mailer: ASF-Git Admin Mailer Subject: [2/32] git commit: Add French 1.3.0 translation Message-Id: <20120120195601.0FE0E3189F8@tyr.zones.apache.org> Date: Fri, 20 Jan 2012 19:56:00 +0000 (UTC) X-Virus-Checked: Checked by ClamAV on apache.org Add French 1.3.0 translation Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/commit/5dbc479b Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/tree/5dbc479b Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/diff/5dbc479b Branch: refs/heads/master Commit: 5dbc479b83fd7a720755067ad1074df82d2e85f7 Parents: e6403d7 Author: Alan Allegret Authored: Fri Jan 6 19:46:51 2012 -0800 Committer: Alan Allegret Committed: Fri Jan 6 19:46:51 2012 -0800 ---------------------------------------------------------------------- docs/fr/1.3.0/config.json | 170 ++++++++ docs/fr/1.3.0/index.md | 64 +++ .../accelerometer/acceleration/acceleration.md | 85 ++++ .../accelerometer/accelerometer.clearWatch.md | 91 +++++ .../accelerometer.getCurrentAcceleration.md | 86 +++++ .../1.3.0/phonegap/accelerometer/accelerometer.md | 23 ++ .../accelerometer.watchAcceleration.md | 115 ++++++ .../accelerometer/parameters/accelerometerError.md | 8 + .../parameters/accelerometerOptions.md | 9 + .../parameters/accelerometerSuccess.md | 23 ++ docs/fr/1.3.0/phonegap/camera/camera.getPicture.md | 171 +++++++++ docs/fr/1.3.0/phonegap/camera/camera.md | 9 + .../1.3.0/phonegap/camera/parameter/cameraError.md | 13 + .../phonegap/camera/parameter/cameraOptions.md | 90 +++++ .../phonegap/camera/parameter/cameraSuccess.md | 23 ++ .../1.3.0/phonegap/compass/compass.clearWatch.md | 89 +++++ .../phonegap/compass/compass.clearWatchFilter.md | 87 +++++ .../phonegap/compass/compass.getCurrentHeading.md | 75 ++++ docs/fr/1.3.0/phonegap/compass/compass.md | 21 + .../1.3.0/phonegap/compass/compass.watchHeading.md | 106 +++++ .../phonegap/compass/compass.watchHeadingFilter.md | 103 +++++ .../phonegap/compass/compassError/compassError.md | 21 + .../phonegap/compass/parameters/compassError.md | 11 + .../phonegap/compass/parameters/compassHeading.md | 30 ++ .../phonegap/compass/parameters/compassOptions.md | 18 + .../phonegap/compass/parameters/compassSuccess.md | 21 + docs/fr/1.3.0/phonegap/connection/connection.md | 23 ++ .../1.3.0/phonegap/connection/connection.type.md | 81 ++++ docs/fr/1.3.0/phonegap/contacts/Contact/contact.md | 202 ++++++++++ .../contacts/ContactAddress/contactaddress.md | 144 +++++++ .../phonegap/contacts/ContactError/contactError.md | 26 ++ .../phonegap/contacts/ContactField/contactfield.md | 121 ++++++ .../ContactFindOptions/contactfindoptions.md | 93 +++++ .../phonegap/contacts/ContactName/contactname.md | 118 ++++++ .../ContactOrganization/contactorganization.md | 131 +++++++ docs/fr/1.3.0/phonegap/contacts/contacts.create.md | 57 +++ docs/fr/1.3.0/phonegap/contacts/contacts.find.md | 96 +++++ docs/fr/1.3.0/phonegap/contacts/contacts.md | 29 ++ .../phonegap/contacts/parameters/contactError.md | 8 + .../phonegap/contacts/parameters/contactFields.md | 6 + .../contacts/parameters/contactFindOptions.md | 16 + .../phonegap/contacts/parameters/contactSuccess.md | 21 + docs/fr/1.3.0/phonegap/device/device.md | 23 ++ docs/fr/1.3.0/phonegap/device/device.name.md | 79 ++++ docs/fr/1.3.0/phonegap/device/device.phonegap.md | 60 +++ docs/fr/1.3.0/phonegap/device/device.platform.md | 70 ++++ docs/fr/1.3.0/phonegap/device/device.uuid.md | 71 ++++ docs/fr/1.3.0/phonegap/device/device.version.md | 63 +++ docs/fr/1.3.0/phonegap/events/events.backbutton.md | 67 ++++ .../phonegap/events/events.batterycritical.md | 74 ++++ docs/fr/1.3.0/phonegap/events/events.batterylow.md | 74 ++++ .../1.3.0/phonegap/events/events.batterystatus.md | 74 ++++ .../fr/1.3.0/phonegap/events/events.deviceready.md | 92 +++++ .../1.3.0/phonegap/events/events.endcallbutton.md | 66 ++++ docs/fr/1.3.0/phonegap/events/events.md | 24 ++ docs/fr/1.3.0/phonegap/events/events.menubutton.md | 67 ++++ docs/fr/1.3.0/phonegap/events/events.offline.md | 71 ++++ docs/fr/1.3.0/phonegap/events/events.online.md | 71 ++++ docs/fr/1.3.0/phonegap/events/events.pause.md | 71 ++++ docs/fr/1.3.0/phonegap/events/events.resume.md | 67 ++++ .../1.3.0/phonegap/events/events.searchbutton.md | 66 ++++ .../phonegap/events/events.startcallbutton.md | 66 ++++ .../phonegap/events/events.volumedownbutton.md | 66 ++++ .../1.3.0/phonegap/events/events.volumeupbutton.md | 66 ++++ .../phonegap/file/directoryentry/directoryentry.md | 298 +++++++++++++++ .../file/directoryreader/directoryreader.md | 47 +++ docs/fr/1.3.0/phonegap/file/file.md | 23 ++ docs/fr/1.3.0/phonegap/file/fileentry/fileentry.md | 242 ++++++++++++ docs/fr/1.3.0/phonegap/file/fileerror/fileerror.md | 30 ++ docs/fr/1.3.0/phonegap/file/fileobj/fileobj.md | 26 ++ .../1.3.0/phonegap/file/filereader/filereader.md | 177 +++++++++ .../1.3.0/phonegap/file/filesystem/filesystem.md | 72 ++++ .../phonegap/file/filetransfer/filetransfer.md | 148 +++++++ .../file/filetransfererror/filetransfererror.md | 21 + .../file/fileuploadoptions/fileuploadoptions.md | 19 + .../file/fileuploadresult/fileuploadresult.md | 21 + .../1.3.0/phonegap/file/filewriter/filewriter.md | 175 +++++++++ docs/fr/1.3.0/phonegap/file/flags/flags.md | 27 ++ .../file/localfilesystem/localfilesystem.md | 90 +++++ docs/fr/1.3.0/phonegap/file/metadata/metadata.md | 32 ++ .../geolocation/Coordinates/coordinates.md | 105 +++++ .../phonegap/geolocation/Position/position.md | 111 ++++++ .../geolocation/PositionError/positionError.md | 23 ++ .../phonegap/geolocation/geolocation.clearWatch.md | 95 +++++ .../geolocation/geolocation.getCurrentPosition.md | 105 +++++ docs/fr/1.3.0/phonegap/geolocation/geolocation.md | 29 ++ .../geolocation/geolocation.watchPosition.md | 109 ++++++ .../geolocation/parameters/geolocation.options.md | 22 + .../geolocation/parameters/geolocationError.md | 13 + .../geolocation/parameters/geolocationSuccess.md | 27 ++ .../1.3.0/phonegap/media/MediaError/mediaError.md | 25 ++ .../1.3.0/phonegap/media/Parameters/mediaError.md | 13 + docs/fr/1.3.0/phonegap/media/capture/CaptureCB.md | 25 ++ .../1.3.0/phonegap/media/capture/CaptureError.md | 18 + .../1.3.0/phonegap/media/capture/CaptureErrorCB.md | 21 + .../phonegap/media/capture/ConfigurationData.md | 43 ++ .../media/capture/MediaFile.getFormatData.md | 34 ++ docs/fr/1.3.0/phonegap/media/capture/MediaFile.md | 18 + .../1.3.0/phonegap/media/capture/MediaFileData.md | 43 ++ docs/fr/1.3.0/phonegap/media/capture/capture.md | 56 +++ .../1.3.0/phonegap/media/capture/captureAudio.md | 116 ++++++ .../phonegap/media/capture/captureAudioOptions.md | 37 ++ .../1.3.0/phonegap/media/capture/captureImage.md | 108 ++++++ .../phonegap/media/capture/captureImageOptions.md | 34 ++ .../1.3.0/phonegap/media/capture/captureVideo.md | 111 ++++++ .../phonegap/media/capture/captureVideoOptions.md | 40 ++ .../phonegap/media/media.getCurrentPosition.md | 152 ++++++++ docs/fr/1.3.0/phonegap/media/media.getDuration.md | 144 +++++++ docs/fr/1.3.0/phonegap/media/media.md | 44 +++ docs/fr/1.3.0/phonegap/media/media.pause.md | 149 +++++++ docs/fr/1.3.0/phonegap/media/media.play.md | 145 +++++++ docs/fr/1.3.0/phonegap/media/media.release.md | 133 +++++++ docs/fr/1.3.0/phonegap/media/media.seekTo.md | 131 +++++++ docs/fr/1.3.0/phonegap/media/media.startRecord.md | 117 ++++++ docs/fr/1.3.0/phonegap/media/media.stop.md | 148 +++++++ docs/fr/1.3.0/phonegap/media/media.stopRecord.md | 119 ++++++ .../phonegap/notification/notification.alert.md | 94 +++++ .../phonegap/notification/notification.beep.md | 95 +++++ .../phonegap/notification/notification.confirm.md | 92 +++++ .../fr/1.3.0/phonegap/notification/notification.md | 12 + .../phonegap/notification/notification.vibrate.md | 85 ++++ .../fr/1.3.0/phonegap/storage/database/database.md | 104 +++++ .../phonegap/storage/localstorage/localstorage.md | 91 +++++ .../phonegap/storage/parameters/display_name.md | 4 + docs/fr/1.3.0/phonegap/storage/parameters/name.md | 4 + docs/fr/1.3.0/phonegap/storage/parameters/size.md | 4 + .../1.3.0/phonegap/storage/parameters/version.md | 4 + .../fr/1.3.0/phonegap/storage/sqlerror/sqlerror.md | 28 ++ .../phonegap/storage/sqlresultset/sqlresultset.md | 115 ++++++ .../storage/sqlresultsetlist/sqlresultsetlist.md | 116 ++++++ .../storage/sqltransaction/sqltransaction.md | 93 +++++ docs/fr/1.3.0/phonegap/storage/storage.md | 29 ++ .../1.3.0/phonegap/storage/storage.opendatabase.md | 54 +++ 133 files changed, 9317 insertions(+), 0 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/config.json ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/config.json b/docs/fr/1.3.0/config.json new file mode 100644 index 0000000..98c21b3 --- /dev/null +++ b/docs/fr/1.3.0/config.json @@ -0,0 +1,170 @@ +{ + "language": "Français", + "merge": { + "accelerometer.md": [ + "phonegap/accelerometer/accelerometer.md", + "phonegap/accelerometer/accelerometer.getCurrentAcceleration.md", + "phonegap/accelerometer/accelerometer.watchAcceleration.md", + "phonegap/accelerometer/accelerometer.clearWatch.md", + "phonegap/accelerometer/acceleration/acceleration.md", + "phonegap/accelerometer/parameters/accelerometerSuccess.md", + "phonegap/accelerometer/parameters/accelerometerError.md", + "phonegap/accelerometer/parameters/accelerometerOptions.md" + ], + "camera.md": [ + "phonegap/camera/camera.md", + "phonegap/camera/camera.getPicture.md", + "phonegap/camera/parameter/cameraSuccess.md", + "phonegap/camera/parameter/cameraError.md", + "phonegap/camera/parameter/cameraOptions.md" + ], + "capture.md": [ + "phonegap/media/capture/capture.md", + "phonegap/media/capture/captureAudio.md", + "phonegap/media/capture/captureAudioOptions.md", + "phonegap/media/capture/captureImage.md", + "phonegap/media/capture/captureImageOptions.md", + "phonegap/media/capture/captureVideo.md", + "phonegap/media/capture/captureVideoOptions.md", + "phonegap/media/capture/CaptureError.md", + "phonegap/media/capture/CaptureCB.md", + "phonegap/media/capture/CaptureErrorCB.md", + "phonegap/media/capture/ConfigurationData.md", + "phonegap/media/capture/MediaFile.md", + "phonegap/media/capture/MediaFile.getFormatData.md", + "phonegap/media/capture/MediaFileData.md" + ], + "compass.md": [ + "phonegap/compass/compass.md", + "phonegap/compass/compass.getCurrentHeading.md", + "phonegap/compass/compass.watchHeading.md", + "phonegap/compass/compass.clearWatch.md", + "phonegap/compass/compass.watchHeadingFilter.md", + "phonegap/compass/compass.clearWatchFilter.md", + "phonegap/compass/parameters/compassSuccess.md", + "phonegap/compass/parameters/compassError.md", + "phonegap/compass/parameters/compassOptions.md", + "phonegap/compass/parameters/compassHeading.md", + "phonegap/compass/compassError/compassError.md" + ], + "contacts.md": [ + "phonegap/contacts/contacts.md", + "phonegap/contacts/contacts.create.md", + "phonegap/contacts/contacts.find.md", + "phonegap/contacts/Contact/contact.md", + "phonegap/contacts/ContactAddress/contactaddress.md", + "phonegap/contacts/ContactField/contactfield.md", + "phonegap/contacts/ContactFindOptions/contactfindoptions.md", + "phonegap/contacts/ContactName/contactname.md", + "phonegap/contacts/ContactOrganization/contactorganization.md", + "phonegap/contacts/ContactError/contactError.md", + "phonegap/contacts/parameters/contactSuccess.md", + "phonegap/contacts/parameters/contactError.md", + "phonegap/contacts/parameters/contactFields.md", + "phonegap/contacts/parameters/contactFindOptions.md" + ], + "device.md": [ + "phonegap/device/device.md", + "phonegap/device/device.name.md", + "phonegap/device/device.phonegap.md", + "phonegap/device/device.platform.md", + "phonegap/device/device.uuid.md", + "phonegap/device/device.version.md" + ], + "events.md": [ + "phonegap/events/events.md", + "phonegap/events/events.deviceready.md", + "phonegap/events/events.pause.md", + "phonegap/events/events.resume.md", + "phonegap/events/events.online.md", + "phonegap/events/events.offline.md", + "phonegap/events/events.backbutton.md", + "phonegap/events/events.batterycritical.md", + "phonegap/events/events.batterylow.md", + "phonegap/events/events.batterystatus.md", + "phonegap/events/events.menubutton.md", + "phonegap/events/events.searchbutton.md", + "phonegap/events/events.startcallbutton.md", + "phonegap/events/events.endcallbutton.md", + "phonegap/events/events.volumedownbutton.md", + "phonegap/events/events.volumeupbutton.md" + ], + "file.md": [ + "phonegap/file/file.md", + "phonegap/file/fileobj/fileobj.md", + "phonegap/file/filereader/filereader.md", + "phonegap/file/filewriter/filewriter.md", + "phonegap/file/filesystem/filesystem.md", + "phonegap/file/fileentry/fileentry.md", + "phonegap/file/directoryentry/directoryentry.md", + "phonegap/file/directoryreader/directoryreader.md", + "phonegap/file/filetransfer/filetransfer.md", + "phonegap/file/fileuploadoptions/fileuploadoptions.md", + "phonegap/file/fileuploadresult/fileuploadresult.md", + "phonegap/file/flags/flags.md", + "phonegap/file/localfilesystem/localfilesystem.md", + "phonegap/file/metadata/metadata.md", + "phonegap/file/fileerror/fileerror.md", + "phonegap/file/filetransfererror/filetransfererror.md" + ], + "geolocation.md": [ + "phonegap/geolocation/geolocation.md", + "phonegap/geolocation/geolocation.getCurrentPosition.md", + "phonegap/geolocation/geolocation.watchPosition.md", + "phonegap/geolocation/geolocation.clearWatch.md", + "phonegap/geolocation/Coordinates/coordinates.md", + "phonegap/geolocation/Position/position.md", + "phonegap/geolocation/PositionError/positionError.md", + "phonegap/geolocation/parameters/geolocationSuccess.md", + "phonegap/geolocation/parameters/geolocationError.md", + "phonegap/geolocation/parameters/geolocation.options.md" + ], + "media.md": [ + "phonegap/media/media.md", + "phonegap/media/media.getCurrentPosition.md", + "phonegap/media/media.getDuration.md", + "phonegap/media/media.pause.md", + "phonegap/media/media.play.md", + "phonegap/media/media.release.md", + "phonegap/media/media.seekTo.md", + "phonegap/media/media.startRecord.md", + "phonegap/media/media.stop.md", + "phonegap/media/media.stopRecord.md", + "phonegap/media/MediaError/mediaError.md", + "phonegap/media/Parameters/mediaError.md" + ], + "network.md": [ + "phonegap/network/network.md", + "phonegap/network/network.isReachable.md", + "phonegap/network/NetworkStatus/NetworkStatus.md", + "phonegap/network/parameters/reachableCallback.md", + "phonegap/network/parameters/reachableHostname.md", + "phonegap/network/parameters/reachableOptions.md" + ], + "connection.md": [ + "phonegap/connection/connection.md", + "phonegap/connection/connection.type.md" + ], + "notification.md": [ + "phonegap/notification/notification.md", + "phonegap/notification/notification.alert.md", + "phonegap/notification/notification.confirm.md", + "phonegap/notification/notification.beep.md", + "phonegap/notification/notification.vibrate.md" + ], + "storage.md": [ + "phonegap/storage/storage.md", + "phonegap/storage/storage.opendatabase.md", + "phonegap/storage/parameters/name.md", + "phonegap/storage/parameters/version.md", + "phonegap/storage/parameters/display_name.md", + "phonegap/storage/parameters/size.md", + "phonegap/storage/database/database.md", + "phonegap/storage/sqltransaction/sqltransaction.md", + "phonegap/storage/sqlresultset/sqlresultset.md", + "phonegap/storage/sqlresultsetlist/sqlresultsetlist.md", + "phonegap/storage/sqlerror/sqlerror.md", + "phonegap/storage/localstorage/localstorage.md" + ] + } +} http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/index.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/index.md b/docs/fr/1.3.0/index.md new file mode 100644 index 0000000..1ddc8d4 --- /dev/null +++ b/docs/fr/1.3.0/index.md @@ -0,0 +1,64 @@ +
+

Documentation de l'API

+
    +
  • +

    Accelerometer

    + Profitez de l'accéléromètre de l'appareil. +
    • +
  • +

    Camera

    + Prenez des photos grâce à l'appareil photo du mobile. +
    • +
  • +

    Capture

    + Profitez des fonctionnalités de capture audio, image et vidéo du mobile. +
    • +
  • +

    Compass

    + Obtenez la direction vers laquelle pointe l'appareil. +
    • +
  • +

    Connection

    + Vérifiez l'état du réseau et les informations du réseau mobile. +
    • +
  • +

    Contacts

    + Accédez au carnet d'adresses du mobile. +
    • +
  • +

    Device

    + Récoltez les caractéristiques de l'appareil. +
    • +
  • +

    Events

    + Traitez les évènements natifs du mobile depuis le JavaScript. +
    • +
  • +

    File

    + Accédez au système de fichiers de l'appareil en JavaScript. +
    • +
  • +

    Geolocation

    + Géolocalisez l'utilisateur de votre application. +
    • +
  • +

    Media

    + Enregistrez et lisez des fichiers audio. +
    • +
  • +

    Notification

    + Utilisez les alertes visuelles et sonores du mobile ainsi que son vibreur. +
    • +
  • +

    Storage

    + Exploitez les solutions de stockage de données de l'appareil. +
    • +
+

Guides

+
    +
  • +

    Index

    + Index complet de la documentation PhoneGap. +
    • +
+
\ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/accelerometer/acceleration/acceleration.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/accelerometer/acceleration/acceleration.md b/docs/fr/1.3.0/phonegap/accelerometer/acceleration/acceleration.md new file mode 100644 index 0000000..1a68458 --- /dev/null +++ b/docs/fr/1.3.0/phonegap/accelerometer/acceleration/acceleration.md @@ -0,0 +1,85 @@ +Acceleration +============ + +Contient les données de l'accéléromètre enregistrées à un instant donné. + +Propriétés +---------- + +- __x:__ Quantité de mouvement sur l'axe x. Intervalle [0, 1] (`Number`) +- __y:__ Quantité de mouvement sur l'axe y. Intervalle [0, 1] (`Number`) +- __z:__ Quantité de mouvement sur l'axe z. Intervalle [0, 1] (`Number`) +- __timestamp:__ Date d'enregistrement de ces données en millisecondes. (`DOMTimeStamp`) + +Description +----------- + +Cet objet est créé et rempli par PhoneGap, puis renvoyé par une méthode d'`Accelerometer`. + +Plateformes supportées +---------------------- + +- Android +- BlackBerry WebWorks (OS 5.0 et plus récent) +- iPhone +- Windows Phone 7 ( Mango ) + +Exemple rapide +-------------- + + 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); + +Exemple complet +--------------- + + + + + Exemple Accelerometer + + + + + +

Exemple

+

getCurrentAcceleration

+ + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.clearWatch.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.clearWatch.md b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.clearWatch.md new file mode 100644 index 0000000..82d0e0a --- /dev/null +++ b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.clearWatch.md @@ -0,0 +1,91 @@ +accelerometer.clearWatch +======================== + +Arrête les appels successifs à l'accéléromètre suite à un appel de `accelerometer.watchAcceleration` et référencés par le paramètre watchID. + + navigator.accelerometer.clearWatch(watchID); + +- __watchID__: Le watchID retourné par `accelerometer.watchAcceleration`. + +Plateformes supportées +---------------------- + +- Android +- BlackBerry WebWorks (OS 5.0 et plus récent) +- iPhone + +Exemple rapide +-------------- + + var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options); + + // ... plus tard ... + + navigator.accelerometer.clearWatch(watchID); + +Exemple complet +--------------- + + + + + Exemple Accelerometer + + + + + +
En attente de l'accéléromètre...
+ + + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.getCurrentAcceleration.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.getCurrentAcceleration.md b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.getCurrentAcceleration.md new file mode 100644 index 0000000..0881d7a --- /dev/null +++ b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.getCurrentAcceleration.md @@ -0,0 +1,86 @@ +accelerometer.getCurrentAcceleration +==================================== + +Lance une récupération ponctuelle des données courantes de l'accéléromètre selon les axes x, y et z. + + navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError); + +Description +----------- + +L'accéléromètre est un capteur de mouvement qui mesure l'accélération linéaire de l'appareil selon 3 axes orthogonaux x, y et z. Il détecte ainsi les mouvements en 3D de l'appareil selon ces axes. + +Un objet `Acceleration` est renvoyé, et la fonction de callback `accelerometerSuccess` est invoquée avec cet objet en argument. + +Plateformes supportées +---------------------- + +- Android +- BlackBerry WebWorks (OS 5.0 et plus récent) +- iPhone + +Exemple rapide +-------------- + + 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); + +Exemple complet +--------------- + + + + + Exemple Accelerometer + + + + + +

Exemple

+

getCurrentAcceleration

+ + + +Singularités iPhone +------------------- + +- Pour l'iPhone, cela n'a pas de sens de récupérer de manière ponctuelle les données de l'accéléromètre. Vous devez forcément lancer une écoute de l'accéléromètre et récupérer les données à intervalles réguliers. + - Ainsi, la fonction `getCurrentAcceleration` vous retournera simplement les dernières données retournées par un appel à `watchAccelerometer` de PhoneGap. http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.md b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.md new file mode 100644 index 0000000..1338b50 --- /dev/null +++ b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.md @@ -0,0 +1,23 @@ +Accelerometer +============= + +> Récupère les mouvements de l'appareil selon les axes x, y et z. + +Méthodes +-------- + +- accelerometer.getCurrentAcceleration +- accelerometer.watchAcceleration +- accelerometer.clearWatch + +Arguments +--------- + +- accelerometerSuccess +- accelerometerError +- accelerometerOptions + +Objects (Lecture seule) +----------------------- + +- Acceleration \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.watchAcceleration.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.watchAcceleration.md b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.watchAcceleration.md new file mode 100644 index 0000000..2c6ed3f --- /dev/null +++ b/docs/fr/1.3.0/phonegap/accelerometer/accelerometer.watchAcceleration.md @@ -0,0 +1,115 @@ +accelerometer.watchAcceleration +=============================== + +Lance à intervalles réguliers une récupération des données de l'accéléromètre. + + var watchID = navigator.accelerometer.watchAcceleration(accelerometerSuccess, + accelerometerError, + [accelerometerOptions]); + +Description +----------- + +L'accéléromètre est un capteur de mouvement qui mesure l'accélération linéaire de l'appareil selon 3 axes orthogonaux x, y et z. Il détecte ainsi les mouvements en 3D de l'appareil selon ces axes. + +La fonction `accelerometer.watchAcceleration` lance à intervalles réguliers une récupération des données de l'accéléromètre. A chaque fois, objet `Acceleration` est renvoyé, et la fonction de callback `accelerometerSuccess` est invoquée avec cet objet en argument. Il est possible de spécifier en millisecondes l'intervalle de temps entre chaque récupération grâce au paramètre `frequency` de l'objet `acceleratorOptions`. + +Le watchID retourné par `accelerometer.watchAcceleration` référence "l'écoute" de l'accéléromètre mise en place de cette manière. Ce watchID peut être utilisé avec `accelerometer.clearWatch` pour arrêter l'écoute. + +Plateformes supportées +---------------------- + +- Android +- BlackBerry WebWorks (OS 5.0 et plus récent) +- iPhone + + +Exemple rapide +-------------- + + 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 }; // Récupération toutes les 3 secondes + + var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options); + +Exemple complet +--------------- + + + + + Exemple Accelerometer + + + + + +
En attente de l'accéléromètre...
+ + + +Singularités iPhone +------------------- + +- Aux intervalles demandées, PhoneGap fera appel au callback `accelerometerSuccess` avec en argument un objet `Acceleration` rempli. Cependant, PhoneGap respecte un minimum de 40ms et un maximum de 1000ms pour les appels à l'accéléromètre de l'appareil. + - Par exemple, si vous choisissez un intervalle de 3 secondes (3000ms), PhoneGap utilisera un intervalle de 1 seconde avec l'appareil mais fera appel au callback `accelerometerSuccess` au bout de 3 secondes. http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerError.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerError.md b/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerError.md new file mode 100644 index 0000000..a5c5673 --- /dev/null +++ b/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerError.md @@ -0,0 +1,8 @@ +accelerometerError +================== + +Fonction de callback en cas d'échec lors d'appels de fonctions d'`Accelerometer`. + + function() { + // Gérer l'erreur + } \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerOptions.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerOptions.md b/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerOptions.md new file mode 100644 index 0000000..9cd435b --- /dev/null +++ b/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerOptions.md @@ -0,0 +1,9 @@ +accelerometerOptions +==================== + +Paramètre facultatif permettant de personnaliser la récupération des données de l'accéléromètre. + +Options +------- + +- __frequency:__ Fréquence de récupération des données d'`Acceleration` en millisecondes. _(Number)_ (Par défault: 10000) \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerSuccess.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerSuccess.md b/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerSuccess.md new file mode 100644 index 0000000..5d76bd8 --- /dev/null +++ b/docs/fr/1.3.0/phonegap/accelerometer/parameters/accelerometerSuccess.md @@ -0,0 +1,23 @@ +accelerometerSuccess +==================== + +Fonction de callback en cas de succès lors d'appels de fonctions d'`Accelerometer`, reçoit en entrée un objet Acceleration. + + function(acceleration) { + // Faire quelquechose + } + +Paramètres +---------- + +- __acceleration:__ Objet Acceleration rempli avec les dernières données de l'accéléromètre. (Acceleration) + +Exemple +------- + + function onSuccess(acceleration) { + alert('Acceleration X: ' + acceleration.x + '\n' + + 'Acceleration Y: ' + acceleration.y + '\n' + + 'Acceleration Z: ' + acceleration.z + '\n' + + 'Timestamp: ' + acceleration.timestamp + '\n'); + }; \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/camera/camera.getPicture.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/camera/camera.getPicture.md b/docs/fr/1.3.0/phonegap/camera/camera.getPicture.md new file mode 100644 index 0000000..41e540a --- /dev/null +++ b/docs/fr/1.3.0/phonegap/camera/camera.getPicture.md @@ -0,0 +1,171 @@ +camera.getPicture +================= + +Prend un cliché grâce à l'application appareil photo du mobile ou retrouve un cliché existant dans l'album. L'image est retournée sous forme de chaîne de caractères (`String`) encodée en Base64 ou sous forme d'URI de fichier image. + + navigator.camera.getPicture( cameraSuccess, cameraError, [ cameraOptions ] ); + +Description +----------- + +La fonction `camera.getPicture` ouvre l'application appareil photo par défaut du mobile pour que l'utilisateur puisse prendre un cliché (si `Camera.sourceType = Camera.PictureSourceType.CAMERA`, qui est la valeur par défaut). Une fois la photo prise, l'application appareil photo se ferme et votre application reprend la main. + +Si `Camera.sourceType = Camera.PictureSourceType.PHOTOLIBRARY` ou `Camera.PictureSourceType.SAVEDPHOTOALBUM`, alors une fenêtre de choix de photo apparaît, et l'utilisateur peut sélectionner une photo de l'album. + +La valeur résultat sera envoyée à la fonction `cameraSuccess`, dans l'un des formats suivants, selon les `cameraOptions` que vous avez choisis : + +- Une chaîne de caractères `String` contenant l'image encodée en Base64 (par défaut). +- Une chaîne de caractères `String` contenant l'URI de l'image dans le stockage local. + +Vous pouvez faire ce que vous voulez de l'image encodée en Base64 ou de l'URI, par exemple : + +- Afficher l'image à l'aide d'une balise `` _(voir l'exemple ci-dessous)_ +- Sauvegarder les données localement (`LocalStorage`, [Lawnchair](http://brianleroux.github.com/lawnchair/), etc.) +- Envoyer les données vers un serveur distant + +Remarque : La qualité des images prises à l'aide de l'appareil photo des mobiles récents est très bonne. _Chiffrer de telles images en Base64 a posé des soucis de mémoire sur quelques-uns de ces mobiles (iPhone 4, BlackBerry Torch 9800)._ Par conséquent, il est fortement conseillé d'utiliser FILE_URI comme valeur de 'Camera.destinationType'. + +Plateformes supportées +---------------------- + +- Android +- Blackberry WebWorks (OS 5.0 et plus récent) +- iPhone +- Windows Phone 7 ( Mango ) + +Exemple rapide +-------------- + +Prendre une photo et récupérer l'image encodée en Base64 : + + navigator.camera.getPicture(onSuccess, onFail, { quality: 50 }); + + function onSuccess(imageData) { + var image = document.getElementById('monImage'); + image.src = "data:image/jpeg;base64," + imageData; + } + + function onFail(message) { + alert('Echec car : ' + message); + } + +Prendre une photo et récupérer l'URI du fichier image: + + navigator.camera.getPicture(onSuccess, onFail, { quality: 50, + destinationType: Camera.DestinationType.FILE_URI }); + + function onSuccess(imageURI) { + var image = document.getElementById('monImage'); + image.src = imageURI; + } + + function onFail(message) { + alert('Echec car : ' + message); + } + + +Exemple complet +--------------- + + + + + Prise de photo + + + + + +
+
+
+
+ + + + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/camera/camera.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/camera/camera.md b/docs/fr/1.3.0/phonegap/camera/camera.md new file mode 100644 index 0000000..870e22d --- /dev/null +++ b/docs/fr/1.3.0/phonegap/camera/camera.md @@ -0,0 +1,9 @@ +Camera +====== + +> L'objet `camera` donne accès à l'application appareil photo par défaut du mobile. + +Méthodes +-------- + +- camera.getPicture \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/camera/parameter/cameraError.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/camera/parameter/cameraError.md b/docs/fr/1.3.0/phonegap/camera/parameter/cameraError.md new file mode 100644 index 0000000..cea201b --- /dev/null +++ b/docs/fr/1.3.0/phonegap/camera/parameter/cameraError.md @@ -0,0 +1,13 @@ +cameraError +=========== + +Fonction de callback en cas d'échec, fournit un message d'erreur. + + function(message) { + // Afficher un message d'erreur parlant + } + +Paramètres +---------- + +- __message:__ Le message fourni par le code natif du mobile. (`String`) \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/camera/parameter/cameraOptions.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/camera/parameter/cameraOptions.md b/docs/fr/1.3.0/phonegap/camera/parameter/cameraOptions.md new file mode 100644 index 0000000..4c36c52 --- /dev/null +++ b/docs/fr/1.3.0/phonegap/camera/parameter/cameraOptions.md @@ -0,0 +1,90 @@ +cameraOptions +============= + +Paramètres facultatifs permettant de personnaliser les propriétés de `Camera`. + + { quality : 75, + destinationType : Camera.DestinationType.DATA_URL, + sourceType : Camera.PictureSourceType.CAMERA, + allowEdit : true, + encodingType: Camera.EncodingType.JPEG, + targetWidth: 100, + targetHeight: 100 }; + +Options +------- + +- __quality:__ Qualité des images sauvegardées. L'intervalle est [0, 100]. (`Number`) + +- __destinationType:__ Type de retour de l'image. Défini dans navigator.camera.DestinationType (`Number`) + + Camera.DestinationType = { + DATA_URL : 0, // Retourner une image sous forme de flux encodé en Base64 + FILE_URI : 1 // Retourner une URI de fichier image + }; + +- __sourceType:__ Source de l'image. Défini dans nagivator.camera.PictureSourceType (`Number`) + + Camera.PictureSourceType = { + PHOTOLIBRARY : 0, + CAMERA : 1, + SAVEDPHOTOALBUM : 2 + }; + +- __allowEdit:__ Autoriser une édition simple de l'image avant sa sélection. (`Boolean`) + +- __EncodingType:__ Format du fichier image retrouné. Défini dans navigator.camera.EncodingType (`Number`) + + Camera.EncodingType = { + JPEG : 0, // Retourner une image au format JPEG + PNG : 1 // Retourner une image au format PNG + }; + +- __targetWidth:__ Largeur en pixels de l'image. Doit être utilisé conjointement avec targetHeight. Les proportions de l'image sont maintenues. (`Number`) +- __targetHeight:__ Hauteur en pixels de l'image. Doit être utilisé conjointement avec targetWidth. Les proportions de l'image sont maintenues. (`Number`) + +- __MediaType:__ Type de média sélectionnable. Marche uniquement lorsque PictureSourceType vaut PHOTOLIBRARY ou SAVEDPHOTOALBUM. Défini dans nagivator.camera.MediaType (`Number`) + + Camera.MediaType = { + PICTURE: 0, // autorise la sélection d'images fixes uniquement. VALEUR PAR DÉFAUT. Le retour se fera sous la forme définie par DestinationType + VIDEO: 1, // autorise la sélection de vidéos uniquement, LE RETOUR SE FERA TOUJOURS SOUS LA FORME FILE_URI + ALLMEDIA : 2 // autorise la sélection de tout type de média +}; + +Singularités Android +-------------------- + +- Le paramètre `allowEdit` est ignoré. +- Camera.PictureSourceType.PHOTOLIBRARY et Camera.PictureSourceType.SAVEDPHOTOALBUM affichent tous deux le même album photo. +- Camera.EncodingType n'est pas supporté. + +Singularités BlackBerry +----------------------- + +- Le paramètre `quality` est ignoré. +- Le paramètre `sourceType` est ignoré. +- Le paramètre `allowEdit` est ignoré. +- L'application doit avoir la permission "key injection" pour pouvoir fermer l'application appareil photo une fois le cliché pris. +- L'utilisation de grandes tailles d'image peut entraîner l'impossibilité de chiffrer ces dernières sur les mobiles récents équipés d'un appareil photo à haute résolution (par exemple Torch 9800). +- Camera.MediaType n'est pas supporté. + +Singularités Palm +----------------- + +- Le paramètre `quality` est ignoré. +- Le paramètre `sourceType` est ignoré. +- Le paramètre `allowEdit` est ignoré. +- Camera.MediaType n'est pas supporté. + +Singularités iPhone +------------------- + +- Fixez `quality` à moins de 50 pour éviter les problèmes de mémoire sur certains mobiles. +- Lorsque `destinationType.FILE_URI` est utilisé, les photos sont stockées dans le dossier temporaire de l'application. +- Le contenu du dossier temporaire de l'application est effacé lorsque l'application se ferme. Les développeurs peuvent également purger ce dossier temporaire grâce aux APIs navigator.fileMgr si la taille de l'espace de stockage devient problématique. + +Singularités Windows Phone 7 +---------------------------- + +- Le paramètre `allowEdit` est ignoré. + \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/camera/parameter/cameraSuccess.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/camera/parameter/cameraSuccess.md b/docs/fr/1.3.0/phonegap/camera/parameter/cameraSuccess.md new file mode 100644 index 0000000..3618e3a --- /dev/null +++ b/docs/fr/1.3.0/phonegap/camera/parameter/cameraSuccess.md @@ -0,0 +1,23 @@ +cameraSuccess +============= + +Fonction de callback en cas de succès, fournit les données de l'image. + + function(imageData) { + // Faire quelque chose avec l'image + } + +Paramètres +---------- + +- __imageData:__ Flux encodé en Base64 de l'image, OU une URI de fichier image, selon `cameraOptions`. (`String`) + +Exemple +------- + + // Afficher l'image + // + function cameraCallback(imageData) { + var image = document.getElementById('monImage'); + image.src = "data:image/jpeg;base64," + imageData; + } \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/compass/compass.clearWatch.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/compass/compass.clearWatch.md b/docs/fr/1.3.0/phonegap/compass/compass.clearWatch.md new file mode 100644 index 0000000..e31e3a3 --- /dev/null +++ b/docs/fr/1.3.0/phonegap/compass/compass.clearWatch.md @@ -0,0 +1,89 @@ +compass.clearWatch +======================== + +Arrête la surveillance de boussole mise en place via `compass.watchHeading` et référencée par watchID. + + navigator.compass.clearWatch(watchID); + +- __watchID__: Le watchID renvoyé par `compass.watchHeading`. + +Plateformes supportées +---------------------- + +- Android +- iPhone +- Windows Phone 7 ( Mango ) si boussole présente dans le mobile + +Exemple rapide +-------------- + + var watchID = navigator.compass.watchHeading(onSuccess, onError, options); + + // ... plus tard ... + + navigator.compass.clearWatch(watchID); + +Exemple complet +--------------- + + + + + Exemple Compass + + + + + +
Attente de la boussole...
+ + + + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/compass/compass.clearWatchFilter.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/compass/compass.clearWatchFilter.md b/docs/fr/1.3.0/phonegap/compass/compass.clearWatchFilter.md new file mode 100644 index 0000000..a71915d --- /dev/null +++ b/docs/fr/1.3.0/phonegap/compass/compass.clearWatchFilter.md @@ -0,0 +1,87 @@ +compass.clearWatchFilter +======================== + +Arrête la surveillance de boussole mise en place via `compass.watchHeadingFilter` et référencée par watchID. + + navigator.compass.clearWatchFilter(watchID); + +- __watchID__: Le watchID renvoyé par `compass.watchHeadingFilter`. + +Plateformes supportées +---------------------- + +- iPhone + +Exemple rapide +-------------- + + var watchID = navigator.compass.watchHeadingFilter(onSuccess, onError, options); + + // ... plus tard ... + + navigator.compass.clearWatchFilter(watchID); + +Exemple complet +--------------- + + + + + Exemple Compass + + + + + +
Attente de la boussole...
+ + + + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/compass/compass.getCurrentHeading.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/compass/compass.getCurrentHeading.md b/docs/fr/1.3.0/phonegap/compass/compass.getCurrentHeading.md new file mode 100644 index 0000000..727d5b3 --- /dev/null +++ b/docs/fr/1.3.0/phonegap/compass/compass.getCurrentHeading.md @@ -0,0 +1,75 @@ +compass.getCurrentHeading +========================= + +Récupère la direction courante de la boussole. + + navigator.compass.getCurrentHeading(compassSuccess, compassError, compassOptions); + +Description +----------- + +La boussole est un capteur capable d'indiquer la direction, ou cap, dans laquelle le mobile est orienté. Il mesure le cap en degrés, de 0 à 359,99. + +La direction de la boussole est renvoyée via un objet CompassHeading passé à la fonction de callback `compassSuccess`. + +Plateformes supportées +---------------------- + +- Android +- iPhone +- Windows Phone 7 ( Mango ) si boussole présente dans le mobile + +Exemple rapide +-------------- + + function onSuccess(heading) { + alert('Cap : ' + heading.magneticHeading); + }; + + function onError(error) { + alert('Erreur de la boussole : ' error.code); + }; + + navigator.compass.getCurrentHeading(onSuccess, onError); + +Exemple complet +--------------- + + + + + Exemple Compass + + + + + +

Exemple

+

getCurrentHeading

+ + + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/compass/compass.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/compass/compass.md b/docs/fr/1.3.0/phonegap/compass/compass.md new file mode 100644 index 0000000..f7647d7 --- /dev/null +++ b/docs/fr/1.3.0/phonegap/compass/compass.md @@ -0,0 +1,21 @@ +Compass +======= + +> Récupère la direction dans laquelle pointe le mobile. + +Méthodes +-------- + +- compass.getCurrentHeading +- compass.watchHeading +- compass.clearWatch +- compass.watchHeadingFilter +- compass.clearWatchFilter + +Arguments +--------- + +- compassSuccess +- compassError +- compassOptions +- compassHeading http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/compass/compass.watchHeading.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/compass/compass.watchHeading.md b/docs/fr/1.3.0/phonegap/compass/compass.watchHeading.md new file mode 100644 index 0000000..3b795db --- /dev/null +++ b/docs/fr/1.3.0/phonegap/compass/compass.watchHeading.md @@ -0,0 +1,106 @@ +compass.watchHeading +==================== + +À intervalles réguliers, récupère la direction en degrés qu'indique la boussole. + + var watchID = navigator.compass.watchHeading(compassSuccess, compassError, [compassOptions]); + +Description +----------- + +La boussole est un capteur capable d'indiquer la direction, ou cap, dans laquelle le mobile est orienté. Il mesure le cap en degrés, de 0 à 359,99. + +La fonction `compass.watchHeading` lance à intervalles réguliers la récupération du cap courant qu'indique la boussole de l'appareil. A chaque fois que le cap est récupéré, la fonction de callback `headingSuccess` est exécutée avec un nouvel objet `CompassHeading`. +L'intervalle de temps entre chaque récupération est indiqué en millisecondes grâce au paramètre `frequency` de l'objet `compassOptions`. + +Le watchID retourné par `compass.watchHeading` référence "l'écoute" de la boussole mise en place de cette manière. Ce watchID peut être utilisé avec `compass.clearWatch` pour arrêter cette écoute. + +Plateformes supportées +---------------------- + +- Android +- iPhone +- Windows Phone 7 ( Mango ) si boussole présente dans le mobile + + +Exemple rapide +-------------- + + function onSuccess(heading) { + var element = document.getElementById('heading'); + element.innerHTML = 'Cap : ' + heading.magneticHeading; + }; + + function onError(compassError) { + alert('Erreur de la boussole : ' + compassError.code); + }; + + var options = { frequency: 3000 }; // Récupération toutes les 3 secondes + + var watchID = navigator.compass.watchHeading(onSuccess, onError, options); + +Exemple complet +--------------- + + + + + Exemple Compass + + + + + +
Attente de la boussole...
+ + + + + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/compass/compass.watchHeadingFilter.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/compass/compass.watchHeadingFilter.md b/docs/fr/1.3.0/phonegap/compass/compass.watchHeadingFilter.md new file mode 100644 index 0000000..ae9aa04 --- /dev/null +++ b/docs/fr/1.3.0/phonegap/compass/compass.watchHeadingFilter.md @@ -0,0 +1,103 @@ +compass.watchHeadingFilter +========================== + +Récupère la direction en degrés qu'indique la boussole quand celle-ci change d'au moins un certain nombre de degrés. + + var watchID = navigator.compass.watchHeadingFilter(compassSuccess, compassError, compassOptions); + +Description +----------- + +La boussole est un capteur capable d'indiquer la direction, ou cap, dans laquelle le mobile est orienté. Il mesure le cap en degrés, de 0 à 359,99. + +La fonction `compass.watchHeadingFilter` récupère le cap courant qu'indique la boussole de l'appareil quand celle-ci change d'au moins un certain nombre de degrés, ou seuil. A chaque fois que le changement de cap dépasse le seuil précisé, la fonction de callback `headingSuccess` est exécutée avec un nouvel objet `CompassHeading`. +Le seuil est indiqué en degrés grâce au paramètre `filter` de l'objet `compassOptions`. + +Le watchID retourné par `compass.watchHeading` référence "l'écoute" de la boussole mise en place de cette manière. Ce watchID peut être utilisé avec `compass.clearWatch` pour arrêter cette écoute. Un seul watchHeadingFilter ne peut être actif à la fois. Si un watchHeadingFilter est actif, appeler getCurrentHeading ou watchHeading utilisera la valeur du seuil existant. Sur iOS, cette méthode est plus performante que `compass.watchFilter` étant donné le mécanisme qu'utilise iOS pour surveiller les changements de direction de la boussole. + +Plateformes supportées +---------------------- + +- iPhone + + +Exemple rapide +-------------- + + function onSuccess(heading) { + var element = document.getElementById('heading'); + element.innerHTML = 'Cap : ' + heading.magneticHeading; + }; + + function onError(compassError) { + alert('Erreur de la boussole : ' + compassError.code); + }; + + var options = { filter: 10 }; // Être notifié dès que la boussole détecte un changement de cap de 10 degrés ou plus + + var watchID = navigator.compass.watchHeadingFilter(onSuccess, onError, options); + +Exemple complet +--------------- + + + + + Exemple Compass + + + + + +
Attente de la boussole...
+ + + + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/compass/compassError/compassError.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/compass/compassError/compassError.md b/docs/fr/1.3.0/phonegap/compass/compassError/compassError.md new file mode 100644 index 0000000..e3fffbf --- /dev/null +++ b/docs/fr/1.3.0/phonegap/compass/compassError/compassError.md @@ -0,0 +1,21 @@ +CompassError +========== + +Un objet `CompassError` est passé à la fonction de callback `compassError` lorsqu'une erreur survient. + +Propriétés +---------- + +- __code:__ Un des codes d'erreur prédéfinis listés ci-dessous. + +Constantes +---------- +- `CompassError.COMPASS_INTERNAL_ERR` +- `CompassError.COMPASS_NOT_SUPPORTED` + +Description +----------- + +L'objet `CompassError` est renvoyé à l'utilisateur en tant qu'argument d'appel de la fonction de callback `compassError` lorsqu'une erreur survient. + + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/compass/parameters/compassError.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/compass/parameters/compassError.md b/docs/fr/1.3.0/phonegap/compass/parameters/compassError.md new file mode 100644 index 0000000..160a41e --- /dev/null +++ b/docs/fr/1.3.0/phonegap/compass/parameters/compassError.md @@ -0,0 +1,11 @@ +compassError +========== + +Fonction de callback onError pour les fonctions de `Compass`. + +Exemple +------- + +function(CompassError) { + // Gérer l'erreur +} http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/compass/parameters/compassHeading.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/compass/parameters/compassHeading.md b/docs/fr/1.3.0/phonegap/compass/parameters/compassHeading.md new file mode 100644 index 0000000..26c4a0a --- /dev/null +++ b/docs/fr/1.3.0/phonegap/compass/parameters/compassHeading.md @@ -0,0 +1,30 @@ +compassHeading +========== + +Un objet `CompassHeading` est passé à la fonction de callback `compassSuccess` lorsqu'un cap est retrouvé depuis la boussole. + +Propriétés +---------- +- __magneticHeading:__ La direction relative au pôle nord magnétique exprimée en degrés, entre 0 et 359.99, pour un instant donné. _(Number)_ +- __trueHeading:__ La direction relative au pôle nord géographique exprimée en degrés, entre 0 et 359.99, pour un instant donné. Une valeur négative indique que la direction n'a pas pu être déterminée. _(Number)_ +- __headingAccuracy:__ La déviation en degrés entre le `magneticHeading` et le `trueHeading` mesurés. _(Number)_ +- __timestamp:__ La date en milliseconde à laquelle la mesure a été effectuée. _(milliseconds)_ + +Description +----------- + +L'objet `CompassHeading` est renvoyé à l'utilisateur en tant qu'argument d'appel de la fonction de callback `compassSuccess`. + +Singularités Android +-------------------- +- `trueHeading` n'est pas supporté. Il contiendra la même valeur que `magneticHeading`. +- `headingAccuracy` vaudra toujours 0 puisqu'il n'y a pas de différence entre `magneticHeading` et `trueHeading` sous Android. + +Singularités iOS +---------------- +- `trueHeading` est renvoyé uniquement lorsque les services de géolocalisation sont activés via `navigator.geolocation.watchLocation()`. +- Pour les mobiles iOS > 4, si le mobile est tourné et que l'application prend en compte l'orientation du mobile, la direction sera renvoyée pour prendre en compte la nouvelle orientation. + +Singularités Windows Phone 7 +---------------------------- +- Seule la valeur `trueHeading` sera renvoyée, il faut savoir que cette partie de PhoneGap a été très peu testée puisque peu de mobiles possèdent une boussole aujourd'hui. http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/compass/parameters/compassOptions.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/compass/parameters/compassOptions.md b/docs/fr/1.3.0/phonegap/compass/parameters/compassOptions.md new file mode 100644 index 0000000..6e1709b --- /dev/null +++ b/docs/fr/1.3.0/phonegap/compass/parameters/compassOptions.md @@ -0,0 +1,18 @@ +compassOptions +============== + +Paramètre facultatif permettant de personnaliser l'exploitation de la boussole. + +Options +------- + +- __frequency:__ A quelle fréquence en millisecondes récupérer la direction de la boussole. _(Number)_ (Par défaut: 100) +- __filter:__ Le seuil de changement de cap, en degrés, à partir duquel déclencher un appel à la fonction de callback onSuccess de `watchHeadingFilter`. _(Number)_ + +Singularités Android +-------------------- +- `filter` n'est pas supporté. + +Singularités Windows Phone 7 +---------------------------- +- `filter` n'est pas supporté. \ No newline at end of file http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/compass/parameters/compassSuccess.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/compass/parameters/compassSuccess.md b/docs/fr/1.3.0/phonegap/compass/parameters/compassSuccess.md new file mode 100644 index 0000000..3776f8c --- /dev/null +++ b/docs/fr/1.3.0/phonegap/compass/parameters/compassSuccess.md @@ -0,0 +1,21 @@ +compassSuccess +============== + +Fonction de callback onSuccess qui fournit les information de direction de la boussole au travers d'un objet `compassHeading`. + + function(heading) { + // Faire quelquechose + } + +Paramètres +---------- + + +- __heading:__ Les données de direction. _(compassHeading)_ + +Exemple +------- + + function onSuccess(heading) { + alert('Cap : ' + heading.magneticHeading); + }; http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/connection/connection.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/connection/connection.md b/docs/fr/1.3.0/phonegap/connection/connection.md new file mode 100644 index 0000000..723d4b7 --- /dev/null +++ b/docs/fr/1.3.0/phonegap/connection/connection.md @@ -0,0 +1,23 @@ +Connection +========== + +> L'objet `connection` donne accès aux informations de connexion réseau du mobile. + +Cet objet est disponible à partir de l'interface `navigator.network`. + +Propriétés +---------- + +- connection.type + +Constantes +---------- + +- `Connection.UNKNOWN` +- `Connection.ETHERNET` +- `Connection.WIFI` +- `Connection.CELL_2G` +- `Connection.CELL_3G` +- `Connection.CELL_4G` +- `Connection.NONE` + http://git-wip-us.apache.org/repos/asf/incubator-cordova-docs/blob/5dbc479b/docs/fr/1.3.0/phonegap/connection/connection.type.md ---------------------------------------------------------------------- diff --git a/docs/fr/1.3.0/phonegap/connection/connection.type.md b/docs/fr/1.3.0/phonegap/connection/connection.type.md new file mode 100644 index 0000000..55aed4d --- /dev/null +++ b/docs/fr/1.3.0/phonegap/connection/connection.type.md @@ -0,0 +1,81 @@ +connection.type +=================== + +Inspecte la connexion réseau utilisée. + +Description +----------- + +Cette propriété permet de déterminer rapidement quel est l'état de la connexion réseau du mobile, et de quel type de connexion il s'agit. + +Plateformes supportées +---------------------- + +- iOS +- Android +- BlackBerry WebWorks (OS 5.0 et plus récent) +- Windows Phone 7 ( Mango ) + +Exemple rapide +-------------- + + function checkConnection() { + var networkState = navigator.network.connection.type; + + var states = {}; + states[Connection.UNKNOWN] = 'Connexion inconnue'; + states[Connection.ETHERNET] = 'Connexion Ethernet'; + states[Connection.WIFI] = 'Connexion WiFi'; + states[Connection.CELL_2G] = 'Connexion cellulaire 2G'; + states[Connection.CELL_3G] = 'Connexion cellulaire 3G'; + states[Connection.CELL_4G] = 'Connexion cellulaire 4G'; + states[Connection.NONE] = 'Pas de connexion réseau'; + + alert('Type de connexion : ' + states[networkState]); + } + + checkConnection(); + + +Exemple complet +--------------- + + + + + Exemple navigator.network.connection.type + + + + + +

Une boîte de dialogue va afficher le type de connexion réseau.

+ +