- Overview
- The Command-line Interface
- Platform Guides
- The config.xml File
- Embedding WebViews
- Plugin Development Guide
- Privacy Guide
- Whitelist Guide
- Accelerometer
- Camera
- Capture
- Compass
- Connection
- Contacts
- Device
- Events
- File
- Geolocation
- Globalization
- InAppBrowser
- Media
- Notification
- Splashscreen
- Storage
Device
The
device
object describes the device's hardware and software.
Properties
Variable Scope
Since device
is assigned to the window
object, it is implicitly in the global scope.
// These reference the same `device`
var phoneModel = window.device.model;
var phoneModel = device.model;
Accessing the Feature
As of version 3.0, Cordova implements device-level APIs as plugins.
Use the CLI's plugin
command, described in The Command-line
Interface, to add or remove this feature for a project:
$ cordova plugin add org.apache.cordova.device
$ cordova plugin ls
[ 'org.apache.cordova.device' ]
$ cordova plugin rm org.apache.cordova.device
These commands apply to all targeted platforms, but modify the platform-specific configuration settings described below:
Android
(in app/res/xml/config.xml) <feature name="Device"> <param name="android-package" value="org.apache.cordova.device.Device" /> </feature>
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>
Reference: Application Manifest for Windows Phone
Tizen (in
config.xml
)<feature name="http://tizen.org/api/systeminfo" required="true"/>
Reference: Application Manifest for Tizen Web Application
Some platforms may support this feature without requiring any special configuration. See Platform Support in the Overview section.