Bussola

Ottiene la direzione che il dispositivo sta puntando.

Metodi

• compass.getCurrentHeading
• compass.watchHeading
• compass.clearWatch
• compass.watchHeadingFilter (obsoleto)
• compass.clearWatchFilter (obsoleto)

Argomenti

• compassSuccess
• compassError
• compassOptions
• compassHeading

La funzionalità di accesso

A partire dalla versione 3.0, Cordova implementa le API a livello di dispositivo come plugin. Utilizzare la CLI plugin comando, descritto in Command-Line Interface, aggiungere o rimuovere questa funzionalità per un progetto:

    $ cordova plugin add org.apache.cordova.device-orientation
    $ cordova plugin ls
    [ 'org.apache.cordova.device-orientation' ]
    $ cordova plugin rm org.apache.cordova.device-orientation

Questi comandi si applicano a tutte le piattaforme mirate, ma modificano le impostazioni di configurazione specifiche della piattaforma descritte di seguito:

• Android (inapp/res/xml/config.xml)

  <feature name="Compass">
      <param name="android-package" value="org.apache.cordova.CompassListener" />
  </feature>
  

• iOS (inconfig.xml)

  <feature name="Compass">
      <param name="ios-package" value="CDVLocation" />
  </feature>
  

• Windows Phone (inProperties/WPAppManifest.xml)

  <Capabilities>
      <Capability Name="ID_CAP_SENSORS" />
  </Capabilities>
  

  Riferimento: il manifesto dell'applicazione per Windows Phone

Alcune piattaforme possono supportare questa funzionalità senza richiedere alcuna configurazione speciale. Vedere Supporto piattaforma nella sezione panoramica.