Display; Xml Displayable Object Uris; Softkey; Softkey Querystringparam - Cisco OL-18696-01 Development Manual

XML Displayable Object URIs

•
•

Display

The Display URI is available only on those Cisco Unified IP Phones that have a color backlight on the
phone display, including the Cisco Unified IP Phone 7970G and 7971G-GE. Using the Display URI, you
can control how long the backlight remains on or off.
Note, however, that other administrator-controlled or user-indicated display settings take precedence
over the Display URI. As such, various phone states (such as phone startup, incoming and active calls,
or other user input states) override the Display URI settings.
URI Format
Display:State:Interval
Where
State = whether the phone display is turned on or off or set to default to return the display to its specified
state.
Interval = duration (in minutes) in which the phone state remains in the specified state (unless activated
by automated or user input). Value must be an integer ranging from 0-1440 minutes. If the value is set
to 0, the display remains in the indicated state indefinitely (unless activated by automated or user input).
For example:
•
•
•
•
XML Displayable Object URIs
These sections describe the XML displayable object URIs:
•
•

SoftKey

You can execute native softkey functionality when the phone executes a Softkey URI. The SoftKey URI
allows developers to customize softkey names and layout in the Services and Directories windows while
retaining the functionality that the softkeys provide.
Softkey URIs work in menu items and in softkey items in the XML objects for which they natively occur
on the phone.
Note The Softkey URI is not supported in the Execute object.
Cisco Unified IP Phone Services Application Development Notes
4-4
Key:AppMenu
Key:Hold
turns the phone display off for 1 hour (60 minutes).
Display:Off:60
turns the phone display on for 10 minutes.
Display:On:10
turns off the display off until activated.
Display:Off:0
returns the display to its specified state for that time.
Display:Default
SoftKey
QueryStringParam
Chapter 4 Internal URI Features
OL-18696-01