ExtendBacklightDuration fscommand2 command

ExtendBacklightDuration

Extends the duration of a backlight for a specified period of time.

If the duration is greater than zero, this command specifies the amount of time in seconds (maximum of 60 seconds) that the backlight should be kept on. If the time elapses without an additional call to this command, the backlight behavior reverts to the default duration. If duration is zero, the backlight behavior immediately reverts to the default behavior.

Note: This feature is system dependent. For example, some systems limit the total duration that the backlight can be extended.

Note: This command is not supported for BREW devices.

Command

Parameters

Value Returned

ExtendBacklightDuration

duration The backlight duration, in seconds. Maximum value of 60 seconds.

-1: Not supported.

0: An error occurred, and the operation could not be completed.

1: Success.

Availability

Flash Lite 2.0

Example

The following example extends the duration of the backlight for 45 seconds:

status = FSCommand2("ExtendBacklightDuration", 45)