Display Manager

EMDK For Xamarin - 2.0

Overview

The DisplayMgr provides control of the display screen on the device. At present, the only option is to configure the timeout value after which the display turns off to conserve battery power. Future versions of the DisplayMgr may provide control of other aspects of the display screen.

Main Functionality

  • Set the Display Screen Timeout Interval
  • Enable or Disable Screen Shot usage

Set the Screen Off Timeout Interval

This parm will allow you to set the timeout interval for the device's screen. When there are no device user interactions (e.g. touch panel or key activations) within the specified time interval, then the display screen of the device will automatically turn off. Setting this interval to a lower amount of time will help to conserve power on the device, at the expense of potentially reduced convenience for the device user.

Note: The underlying Android display system only supports the selection of a fixed set of values for the display screen timeout, determined by the values supported by the System Settings Menu. This parm can only set the actual display screen timeout to one of those supported values (listed in the table below). Specifying a value that is less than the smallest value shown in the table or greater than the largest value shown in the table will cause no change to be made to the current display screen timeout interval and will cause an error to be returned in the Result XML document. Specifying a value between two supported values shown in the table will cause the closest value to the requested value to be selected, with no error returned in the Result XML document.

Parm Name: TimeoutInterval

Option Name Description Requires
0 Do not cThis value (or the absence of this parm from the XML) will not cause any changes to the current display screen timeout interval.

MX: 4.3+

Android API Level: 1+

15 15 seconds after Display Timeout This value will cause the display screen to timeout after 15 seconds with no device user interactions

MX: 4.3+

Android API Level: 1+

30 30 seconds after Display Timeout This value will cause the display screen to timeout after 30 seconds with no device user interactions.

MX: 4.3+

Android API Level: 1+

60 1 minute after Display Timeout This value will cause the display screen to timeout after 1 minute with no device user interactions.

MX: 4.3+

Android API Level: 1+

120 2 minutes after Display Timeout This value will cause the display screen to timeout after 2 minutes with no device user interactions.

MX: 4.3+

Android API Level: 1+

300 5 minutes after Display Timeout This value will cause the display screen to timeout after 5 minutes with no device user interactions.

MX: 4.3+

Android API Level: 1+

600 10 minutes after Display Timeout This value will cause the display screen to timeout after 10 minutes with no device user interactions.

MX: 4.3+

Android API Level: 1+

1800 30 minutes after Display Timeout This value will cause the display screen to timeout after half an hour with no device user interactions.

MX: 4.3+

Android API Level: 1+

Screen Shot Usage

This parm will allow you to set the timeout interval for the device's screen. When there are no device user interactions (e.g. touch panel or key activations) within the specified time interval, then the display screen of the device will automatically turn off. Setting this interval to a lower amount of time will help to conserve power on the device, at the expense of potentially reduced convenience for the device user.

Note: The underlying Android display system only supports the selection of a fixed set of values for the display screen timeout, determined by the values supported by the System Settings Menu. This parm can only set the actual display screen timeout to one of those supported values (listed in the table below). Specifying a value that is less than the smallest value shown in the table or greater than the largest value shown in the table will cause no change to be made to the current display screen timeout interval and will cause an error to be returned in the Result XML document. Specifying a value between two supported values shown in the table will cause the closest value to the requested value to be selected, with no error returned in the Result XML document.

Parm Name: ScreenShotUsage

Option Name Description Requires
0 Do Nothing This value (or the absence of this parm from the XML) will not cause any changes to the current behavior.

OSX: 3.6,4.5 ONLY

NOT IN OSX: 4.0 - 4.4

MX: 5.0+

1 Enable This value will enable the ability to use the Android screen capture feature.

OSX: 3.6,4.5 ONLY

NOT IN OSX: 4.0 - 4.4

MX: 5.0+

2 Disable This value will disable the ability to use the Android screen capture feature.

OSX: 3.6,4.5 ONLY

NOT IN OSX: 4.0 - 4.4

MX: 5.0+