Phone API Reference - Core - digium.setLedState
- Kelli Higdon
- Lorne Gaetz (Unlicensed)
Desk Phone API features described in this section are deprecated and supported only on the following models: D40, d45, d50, d60, d62, d65, d70
digium.setLedState
Description
This function can be used to change the state of one of the phone's LED lights.
Basic Example:
digium.setLedState(parameters); |
This function can be used to change the state of one of the phone's LED lights. An app can only control LEDs when it is in the foreground; once it goes into the background, the phone gui will return all LEDs to its default behavior. When an app sets its first LED, all other LEDs will be turned off. The app is then responsible for all LED settings until it is backgrounded. When an app returns to the foreground, it will need to set the LEDs to its desired state again (generally in its onforeground handler).
Parameters
Name | Required | Type | Default | Description |
|---|---|---|---|---|
name | Yes | string |
| The name of the LED to target. Possible values are as follows:
|
color | Yes | string |
| Which color to activate for the LED. Possible choices are green, red and amber. |
state | Yes | string |
| Which state the LED should be set as. Possible options are:
|