tree: e630256803b52a26e7b16e2c92e2650b579f09ee [path history] [tgz]
  1. index.md
  2. README.md
doc/fr/README.md

cordova-plugin-device-orientation

Build Status

Ce plugin permet d‘accéder à la boussole de l’appareil. La boussole est un capteur qui détecte la direction ou la position que l‘appareil est pointé, généralement par le haut de l’appareil. Il mesure la position en degrés de 0 à 359.99, où 0 est vers le Nord.

Accès se fait par un global navigator.compass objet.

Bien que l‘objet est attaché à la portée globale navigator , il n’est pas disponible jusqu'après la deviceready événement.

document.addEventListener (« deviceready », onDeviceReady, false) ;
function onDeviceReady() {console.log(navigator.compass);}

Installation

cordova plugin add cordova-plugin-device-orientation

Plates-formes supportées

  • Amazon Fire OS
  • Android
  • BlackBerry 10
  • Navigateur
  • Firefox OS
  • iOS
  • Paciarelli
  • Windows Phone 7 et 8 (s'il est disponible dans le matériel)
  • Windows 8

Méthodes

  • navigator.compass.getCurrentHeading
  • navigator.compass.watchHeading
  • navigator.compass.clearWatch

navigator.compass.getCurrentHeading

Téléchargez la cours de la boussole. La boussole est renvoyé via un CompassHeading s‘opposer à l’aide de la compassSuccess fonction de rappel.

navigator.compass.getCurrentHeading (compassSuccess, compassError) ;

Exemple

function onSuccess(heading) {alert (' intitulé: "+ heading.magneticHeading);} ;

function onError(error) {alert ('CompassError: ' + error.code);} ;

navigator.compass.getCurrentHeading (onSuccess, onError) ;

navigator.compass.watchHeading

Obtient la position actuelle de l'appareil à intervalle régulier. Chaque fois que le titre est récupéré, la headingSuccess fonction de rappel est exécutée.

Le code retourné montre fait référence à l‘intervalle montre boussole. La montre ID peut être utilisé avec navigator.compass.clearWatch d’arrêter de regarder le navigator.compass.

var watchID = navigator.compass.watchHeading (compassSuccess, compassError, [compassOptions]) ;

compassOptionspeut contenir les clés suivantes :

  • fréquence : la fréquence de récupération de la boussole en millisecondes. (Nombre) (Par défaut : 100)
  • filtre: le changement en degrés nécessaires pour lancer un rappel de succès watchHeading. Lorsque cette valeur est définie, la fréquence est ignoré. (Nombre)

Exemple

function onSuccess(heading) {var element = document.getElementById('heading') ;
    element.innerHTML = "intitulé:" + heading.magneticHeading ;
};

function onError(compassError) {alert (' erreur de boussole: "+ compassError.code);} ;

options de var = {
    frequency: 3000
} ; Mise à jour chaque 3 secondes var watchID = navigator.compass.watchHeading (onSuccess, onError, options) ;

Bizarreries navigateur

Valeurs pour la rubrique actuelle sont générés au hasard afin de simuler la boussole.

Notes au sujet d'iOS

Seul watchHeading peut être en effet à un moment donné dans l‘iOS. Si un watchHeading utilise un filtre, appeler getCurrentHeading ou watchHeading utilise la valeur existante de filtre pour spécifier des changements de position. En regardant les changements de position avec un filtre est plus efficace qu’avec des intervalles de temps.

Amazon Fire OS Quirks

  • filtern'est pas pris en charge.

Quirks Android

  • Pas de support pourfilter.

Firefox OS Quirks

  • Pas de support pourfilter.

Bizarreries de paciarelli

  • Pas de support pourfilter.

Notes au sujet de Windows Phone 7 et 8

  • Pas de support pourfilter.

navigator.compass.clearWatch

Arrêter de regarder la boussole référencée par le paramètre ID de montre.

navigator.compass.clearWatch(watchID) ;
  • watchID: l'ID retourné parnavigator.compass.watchHeading.

Exemple

var watchID = navigator.compass.watchHeading (onSuccess, onError, options) ;

... plus tard... navigator.compass.clearWatch(watchID) ;

CompassHeading

A CompassHeading objet est retourné à la compassSuccess fonction de rappel.

Propriétés

  • magneticHeading: la position en degrés de 0-359,99 à un instant donné. (Nombre)

  • trueHeading: la position par rapport au pôle Nord géographique en degrés 0-359,99 à un instant donné. Une valeur négative indique que le cap vrai ne peut être déterminée. (Nombre)

  • headingAccuracy: la déviation en degrés entre la direction signalée et la véritable direction. (Nombre)

  • horodatage: l'heure à laquelle cette direction a été déterminée. (millisecondes)

Amazon Fire OS Quirks

  • trueHeadingn'est pas pris en charge, mais la même valeur que les rapportsmagneticHeading

  • headingAccuracyest toujours 0 car il n'y a pas de différence entre la magneticHeading ettrueHeading

Quirks Android

  • La trueHeading propriété n'est pas pris en charge, mais la même valeur que des rapportsmagneticHeading.

  • La headingAccuracy propriété est toujours 0 car il n'y a pas de différence entre la magneticHeading ettrueHeading.

Firefox OS Quirks

  • La trueHeading propriété n'est pas pris en charge, mais la même valeur que des rapportsmagneticHeading.

  • La headingAccuracy propriété est toujours 0 car il n'y a pas de différence entre la magneticHeading ettrueHeading.

Notes au sujet d'iOS

  • La trueHeading propriété est retournée uniquement pour les services de localisation activées vianavigator.geolocation.watchLocation().

CompassError

A CompassError objet est retourné à la compassError fonction de rappel lorsqu'une erreur survient.

Propriétés

  • code: l‘un des codes d’erreur prédéfinis énumérés ci-dessous.

Constantes

  • CompassError.COMPASS_INTERNAL_ERR
  • CompassError.COMPASS_NOT_SUPPORTED