The title of each API section below contains a link that will take you directly to the appropriate section of the intel.xdk
API documentation.
Note that the APIs listed below augment the standard Cordova APIs, both APIs can and should be used in your application. In some cases there is overlap between the Cordova APIs and the intel.xdk APIs; in that case, we recommend you use the Cordova API first and then use the intel.xdk API when the Cordova API either does not provide the desired functionality or provides inadequate functionality. Do not mix overlapping APIs within your application; in other words, use only the Cordova accelerometer API or the intel.xdk
accelerometer API in your app, do not use both in the same app. This overlap between two similar device APIs exists for historical reasons and is not recommended for normal use.
APIs marked as "pending" in the notes section are still under development or have not been fully tested. APIs marked as "removed" are not present in the Cordova build system but may still exist in the standard "Intel XDK" build containers and may also be supported by the Emulator tab within the Intel XDK (see this list of APIs that are not supported by the Emulator).
To include these APIs as part of your application you must include a reference to "cordova.js
" in your index.html
file. In your Cordova build configuration file you also need to include a reference to each plugin required by the API(s) you are using by "value" and "name" where "value" is the title of each API section below (e.g., intel.xdk.accelerometer
) and "name" is the last segment of that title (e.g., accelerometer
), unless indicated otherwise. See Using the Intel XDK "Cordova for *" Build Option for detailed information.
intel.xdk.base
The properties in this plugin are useful for writing device-dependent code fragments. In addition to the properties provided here, there are two methods and one event included with this plugin, they are the "bare minimum" required to get your Cordova container up and running quickly. Note that the methods and events included in this plugin have equivalents in the core Cordova plugins, which are recommended for new applications. The methods and events are provided here to support existing XDK applications and to minimize application permission requirements (this plugin requires no special permission).
API Object | API Type | Notes |
---|---|---|
intel.xdk.device.hideSplashScreen | method | |
intel.xdk.device.showSplashScreen | method | |
intel.xdk.app | property | |
intel.xdk.isamazon | property | |
intel.xdk.ischrome | property | |
intel.xdk.isfacebook | property | |
intel.xdk.isgoogle | property | |
intel.xdk.isintel | property | |
intel.xdk.ismozilla | property | |
intel.xdk.isnative | property | |
intel.xdk.isnook | property | |
intel.xdk.isphone | property | |
intel.xdk.istablet | property | |
intel.xdk.istest | property | |
intel.xdk.isweb | property | |
intel.xdk.iswin8 | property | |
intel.xdk.iswp8 | property | |
intel.xdk.isxdk | property | |
intel.xdk.jsVersion | property | |
intel.xdk.webRoot | property | |
intel.xdk.device.ready | event |
intel.xdk.accelerometer
For reading the device accelerometer.
API Object | API Type | Notes |
---|---|---|
intel.xdk.accelerometer.clearWatch | method | |
intel.xdk.accelerometer.getCurrentAcceleration | method | |
intel.xdk.accelerometer.watchAcceleration | method |
intel.xdk.audio
For playing and recording audio elements.
API Object | API Type | Notes |
---|---|---|
intel.xdk.audio.startPlaying | method | undocumented |
intel.xdk.audio.stopPlaying | method | undocumented |
intel.xdk.audio.pausePlaying | method | undocumented |
intel.xdk.audio.continuePlaying | method | undocumented |
intel.xdk.audio.stopRecording | method | undocumented |
intel.xdk.audio.pauseRecording | method | undocumented, compatibility placeholder |
intel.xdk.audio.startRecording | method | undocumented |
intel.xdk.audio.addSound | method | undocumented, compatibility placeholder |
intel.xdk.audio.continueRecording | method | undocumented, compatibility placeholder |
intel.xdk.audio.deleteRecording | method | undocumented |
intel.xdk.audio.clearRecordings | method | undocumented |
intel.xdk.audio.getRecordingList | method | undocumented |
intel.xdk.audio.getRecordingURL | method | undocumented |
intel.xdk.audio.play.stop | event | undocumented |
intel.xdk.audio.play.start | event | undocumented |
intel.xdk.audio.play.pause | event | undocumented |
intel.xdk.audio.play.busy | event | undocumented |
intel.xdk.audio.play.error | event | undocumented |
intel.xdk.audio.play.continue | event | undocumented |
intel.xdk.audio.record.removed | event | undocumented |
intel.xdk.audio.record.notRemoved | event | undocumented |
intel.xdk.audio.record.clear | event | undocumented |
intel.xdk.audio.continue.notsupported | event | undocumented, compatibility placeholder |
intel.xdk.audio.pause.notsupported | event | undocumented, compatibility placeholder |
intel.xdk.audio.record.start | event | undocumented |
intel.xdk.audio.record.busy | event | undocumented |
intel.xdk.audio.record.error | event | undocumented |
intel.xdk.audio.record.stop | event | undocumented |
intel.xdk.cache
For persistent caching of data between application sessions.
API Object | API Type | Notes |
---|---|---|
intel.xdk.cache.addToMediaCache | method | |
intel.xdk.cache.addToMediaCacheExt | method | |
intel.xdk.cache.clearAllCookies | method | |
intel.xdk.cache.clearMediaCache | method | |
intel.xdk.cache.getCookie | method | |
intel.xdk.cache.getCookieList | method | |
intel.xdk.cache.getMediaCacheList | method | |
intel.xdk.cache.getMediaCacheLocalURL | method | pending |
intel.xdk.cache.getMediaCacheRelativePath | method | pending, undocumented |
intel.xdk.cache.removeCookie | method | |
intel.xdk.cache.removeFromMediaCache | method | |
intel.xdk.cache.setCookie | method | |
intel.xdk.cache.media.add | event | |
intel.xdk.cache.media.clear | event | |
intel.xdk.cache.media.remove | event | |
intel.xdk.cache.media.update | event |
intel.xdk.camera
For capturing images with the camera and accessing those images.
API Object | API Type | Notes |
---|---|---|
intel.xdk.camera.clearPictures | method | |
intel.xdk.camera.deletePicture | method | |
intel.xdk.camera.getPictureList | method | |
intel.xdk.camera.getPictureURL | method | |
intel.xdk.camera.importPicture | method | |
intel.xdk.camera.takeFrontPicture | method | pending, undocumented, identical to takePicture |
intel.xdk.camera.takePicture | method | |
intel.xdk.camera.picture.add | event | |
intel.xdk.camera.picture.busy | event | |
intel.xdk.camera.picture.cancel | event | |
intel.xdk.camera.picture.clear | event | |
intel.xdk.camera.picture.remove | event |
intel.xdk.contacts
For access to the on-device contacts database.
API Object | API Type | Notes |
---|---|---|
intel.xdk.contacts.addContact | method | |
intel.xdk.contacts.chooseContact | method | |
intel.xdk.contacts.editContact | method | |
intel.xdk.contacts.getContactData | method | |
intel.xdk.contacts.getContactList | method | |
intel.xdk.contacts.getContacts | method | |
intel.xdk.contacts.removeContact | method | |
intel.xdk.contacts.add | event | |
intel.xdk.contacts.busy | event | |
intel.xdk.contacts.choose | event | |
intel.xdk.contacts.edit | event | |
intel.xdk.contacts.get | event | |
intel.xdk.contacts.remove | event |
intel.xdk.device
Configure the device and/or retrieve information pertinent to the device.
API Object | API Type | Notes |
---|---|---|
intel.xdk.device.addRemoteScript | method | |
intel.xdk.device.addVirtualPage | method | |
intel.xdk.device.closeRemoteSite | method | |
intel.xdk.device.copyToClipboard | method | |
intel.xdk.device.getRemoteData | method | |
intel.xdk.device.getRemoteDataExt | method | |
intel.xdk.device.getRemoteDataWithID | method | |
intel.xdk.device.hideStatusBar | method | |
intel.xdk.device.launchExternal | method | |
intel.xdk.device.mainViewExecute | method | |
intel.xdk.device.managePower | method | |
intel.xdk.device.removeVirtualPage | method | |
intel.xdk.device.scanBarcode | method | |
intel.xdk.device.sendEmail | method | |
intel.xdk.device.sendSMS | method | |
intel.xdk.device.setAutoRotate | method | |
intel.xdk.device.setBasicAuthentication | method | |
intel.xdk.device.setRotateOrientation | method | |
intel.xdk.device.showRemoteSite | method | |
intel.xdk.device.showRemoteSiteExt | method | |
intel.xdk.device.updateConnection | method | |
intel.xdk.device.connection | property | |
intel.xdk.device.hasCaching | property | |
intel.xdk.device.hasStreaming | property | |
intel.xdk.device.initialOrientation | property | |
intel.xdk.device.lastStation | property | |
intel.xdk.device.model | property | |
intel.xdk.device.orientation | property | |
intel.xdk.device.osversion | property | |
intel.xdk.device.phonegapversion | property | |
intel.xdk.device.platform | property | |
intel.xdk.device.queryString | property | |
intel.xdk.device.uuid | property | |
intel.xdk.device.barcode.scan | event | |
intel.xdk.device.connection.update | event | |
intel.xdk.device.continue | event | |
intel.xdk.device.hardware.back | event | |
intel.xdk.device.orientation.change | event | |
intel.xdk.device.pause | event | |
intel.xdk.device.remote.block | event | |
intel.xdk.device.remote.close | event | |
intel.xdk.device.remote.data | event | |
intel.xdk.device.resume | event | |
intel.xdk.device.suspend | event |
intel.xdk.display
For controlling aspects of the device's display.
API Object | API Type | Notes |
---|---|---|
intel.xdk.display.lockViewportWindow | method | pending |
intel.xdk.display.startAR | method | pending |
intel.xdk.display.stopAR | method | pending |
intel.xdk.display.useViewport | method | pending |
intel.xdk.display.window.landheight | property | pending |
intel.xdk.display.window.landwidth | property | pending |
intel.xdk.display.window.portheight | property | pending |
intel.xdk.display.window.portwidth | property | pending |
intel.xdk.facebook
For access to an end-user's Facebook account.
API Object | API Type | Notes |
---|---|---|
intel.xdk.facebook.enableFrictionlessRequests | method | |
intel.xdk.facebook.login | method | |
intel.xdk.facebook.logout | method | |
intel.xdk.facebook.requestWithGraphAPI | method | |
intel.xdk.facebook.requestWithRestAPI | method | deprecated, performs a null action |
intel.xdk.facebook.showAppRequestDialog | method | |
intel.xdk.facebook.showNewsFeedDialog | method | |
intel.xdk.facebook.busy | event | |
intel.xdk.facebook.dialog.complete | event | |
intel.xdk.facebook.dialog.fail | event | |
intel.xdk.facebook.login | event | |
intel.xdk.facebook.logout | event | |
intel.xdk.facebook.request.response | event | |
intel.xdk.facebook.session.invalidate | event |
intel.xdk.file
For uploading files to an appropriately configured server.
API Object | API Type | Notes |
---|---|---|
intel.xdk.file.cancelUpload | method | |
intel.xdk.file.uploadToServer | method | |
intel.xdk.file.upload | event | |
intel.xdk.file.upload.busy | event | |
intel.xdk.file.upload.cancel | event |
intel.xdk.geolocation
For access to the device location tracking hardware.
API Object | API Type | Notes |
---|---|---|
intel.xdk.geolocation.clearWatch | method | |
intel.xdk.geolocation.getCurrentPosition | method | |
intel.xdk.geolocation.watchPosition | method |
intel.xdk.multitouch
To enable device multi-touch features on Android devices.
API Object | API Type | Notes |
---|---|---|
intel.xdk.multitouch.enable | method | pending |
intel.xdk.notification
Provides device-specific alerts.
API Object | API Type | Notes |
---|---|---|
intel.xdk.notification.alert | method | |
intel.xdk.notification.beep | method | |
intel.xdk.notification.confirm | method | |
intel.xdk.notification.hideBusyIndicator | method | |
intel.xdk.notification.showBusyIndicator | method | |
intel.xdk.notification.vibrate | method | |
intel.xdk.notification.confirm | event | undocumented |
intel.xdk.notification.confirm.busy | event | undocumented |
intel.xdk.player
For playing audio and video media files and streams.
API Object | API Type | Notes |
---|---|---|
intel.xdk.player.setAudioVolume | method | undocumented |
intel.xdk.player.clearAudioCurrentTimeWatch | method | |
intel.xdk.player.loadSound | method | |
intel.xdk.player.playPodcast | method | pending |
intel.xdk.player.playSound | method | |
intel.xdk.player.setAudioCurrentTime | method | |
intel.xdk.player.startAudio | method | |
intel.xdk.player.startShoutcast | method | pending |
intel.xdk.player.stopAudio | method | |
intel.xdk.player.toggleAudio | method | |
intel.xdk.player.unloadAllSounds | method | |
intel.xdk.player.unloadSound | method | |
intel.xdk.player.volume | method | pending |
intel.xdk.player.watchAudioCurrentTime | method | |
intel.xdk.player.audioInfo.currentTime | property | |
intel.xdk.player.audioInfo.duration | property | |
intel.xdk.player.audio.busy | event | |
intel.xdk.player.audio.currenttime.set | event | |
intel.xdk.player.audio.error | event | |
intel.xdk.player.audio.start | event | |
intel.xdk.player.audio.stop | event | |
intel.xdk.player.audio.volume.set | event | undocumented |
intel.xdk.player.sound.load | event | undocumented |
intel.xdk.player.sound.unload | event | undocumented |
intel.xdk.player.podcast.busy | event | pending |
intel.xdk.player.podcast.error | event | pending |
intel.xdk.player.podcast.start | event | pending |
intel.xdk.player.podcast.stop | event | pending |
intel.xdk.player.shoutcast.busy | event | pending |
intel.xdk.player.shoutcast.error | event | pending |
intel.xdk.player.shoutcast.pause | event | pending |
intel.xdk.player.shoutcast.play | event | pending |
intel.xdk.player.shoutcast.start | event | pending |
intel.xdk.player.shoutcast.stop | event | pending |
intel.xdk.player.sound.error | event | pending, iOS only |