Dispositivo
Il
device
oggetto descrive il dispositivo hardware e software.
Proprietà
- device.model
- Device.Cordova
- Device
- Device.UUID
- Device.Version
- device.name
Portata variabile
Poiché device
viene assegnato il window
dell'oggetto, è implicitamente in ambito globale.
// These reference the same `device`
var phoneModel = window.device.model;
var phoneModel = device.model;
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
$ cordova plugin ls
[ 'org.apache.cordova.device' ]
$ cordova plugin rm org.apache.cordova.device
Questi comandi si applicano a tutte le piattaforme mirate, ma modificano le impostazioni di configurazione specifiche della piattaforma descritte di seguito:
Android
(in app/res/xml/config.xml) <feature name="Device"> <param name="android-package" value="org.apache.cordova.Device" /> </feature> (in app/AndroidManifest.xml) <uses-permission android:name="android.permission.READ_PHONE_STATE" />
BlackBerry WebWorks
(in www/plugins.xml) <feature name="Device"> <param name="blackberry-package" value="org.apache.cordova.device.Device" /> </feature> (in www/config.xml) <feature id="blackberry.app" required="true" version="1.0.0.0" /> <rim:permissions> <rim:permit>read_device_identifying_information</rim:permit> </rim:permissions>
Windows Phone (in
Properties/WPAppManifest.xml
)<Capabilities> <Capability Name="ID_CAP_WEBBROWSERCOMPONENT" /> <Capability Name="ID_CAP_IDENTITY_DEVICE" /> <Capability Name="ID_CAP_IDENTITY_USER" /> </Capabilities>
Riferimento: il manifesto dell'applicazione per Windows Phone
Tizen (in
config.xml
)<feature name="http://tizen.org/api/systeminfo" required="true"/>
Riferimento: il manifesto dell'applicazione per applicazione Web Tizen
Alcune piattaforme possono supportare questa funzionalità senza richiedere alcuna configurazione speciale. Vedere Supporto piattaforma nella sezione panoramica.