Device Module

RhoElements 2.x API

Overview

The Device Module controls device functions.

Syntax

device (Module) <META> Syntax

<META HTTP-Equiv="Device" content="[method]">

Device JavaScript Object Syntax:
By default the JavaScript Object 'device' will exist on the current page and can be used to interact directly with the device.
To Invoke device methods via JavaScript use the following syntax: device.method();

e.g. device.suspend();

To set multiple EMML parameters / events on a single line use the following syntax: device.setEMML("[Your EMML Tags]");

e.g. device.setEMML("suspend");

## Methods Items listed in this section indicate methods or, in some cases, indicate parameters which will be retrieved.
Name Description Default Value
suspend puts the device into suspend mode Not in suspend mode
powerOff puts the device into power off mode. In this mode the device will draw no power. Only supported on SB1. Not in Power Off mode
wake Wakes the device from suspend mode wake mode
calibrate Carries out the screen calibration routine Not calibrating

Multi Instance

When multiple RhoElememts applications are running the following considerations should be made: Only the application with Focus will have the ability to control device functions.

Remarks

Interaction with Unattended Method of the Push Module

The Suspend functionality is incompatible with the unattended functionality of the push module and they should not be used together.

wake Method

The wake functionality can be used along with Push module. For eg: in the push detected event the user can call the wake method to wake the device. Please note that the Enterprise Tablet opens in Lock Screen mode if wake method is used and the screen stays active until the user swicthes it off and hence this method consumes more battery power.

Requirements

RhoElements Version1.0.0 or above
Supported DevicesAll supported devices.
Minimum RequirementsNone.
PersistenceImmediate - These methods are actioned immediately.

HTML/JavaScript Examples

The following example put the device into suspend mode:

<META HTTP-Equiv="Device" Content="Suspend">

The following example wakes the device from Suspend mode:

<META HTTP-Equiv="Device" Content="wake">