Cisco OL-20949-01 User Manual
Page 33
3-15
Cisco Unified IP Phone Services Application Development Notes
OL-20949-01
Chapter 3 CiscoIPPhone XML Objects
XML Object Definitions
The Status object cannot be closed or cleared by the user (for example, by pressing Services) because
the Status object is only present on the Call plane. In order to clear the object, the phone must execute
the Init:AppStatus URI. This would typically occur as the result of an application server pushing an
Execute object to the phone that contains the Init:AppStatus URI.
Note
The CiscoIPPhoneStatus object can only be pushed (HTTP POST) to the phone; it cannot be pulled
(HTTP GET).
The CiscoIPPhoneStatus object can be refreshed or replaced at any time. It is not necessary to clear an
existing Status object before sending a new Status object. The new object simply replaces the old object.
shows the CiscoIPPhoneStatus object that contains the following visual elements:
•
106 x 21 graphics area for displaying CIP images (same image format as CiscoIPPhoneImage)
•
Seedable, free-running timer (optional)
•
Single-line text area (optional)
Figure 3-8
IconMenu on a CiscoIPPhoneStatus Sample
Definition
<CiscoIPPhoneStatus>
<Text>This is the text area</Text>
<Timer>Timer seed value in seconds</Timer>
<LocationX>Horizontal alignment</LocationX>
<LocationY>Vertical alignment</LocationY>
<Width>Pixel width of graphic</Width>
<Height>Pixel height of graphic</Height>
<Depth>Color depth in bits</Depth>
<Data>Hex binary image data</Data>
</CiscoIPPhoneStatus>
Note
The 6900 series IP phones does not display the Title and Prompt menu fields at the same time.
If both Title and Prompt fields are defined at the same time, then these phones display only the
Prompt field.
Dynamic Sizing of the Application Status Window
You can enable applications to dynamically adjust their window sizes based on the displayed content.
The minimum size requirements limit the windows size so that it is a large enough size to stand out from
the Overview content. For example, using a smaller window for an application allows more content from
the Overview to be displayed. Sizing the window occurs upon the reception of a CiscoIPPhoneStatus or
CiscoIPPhoneStatusFile object with its associated PNG file.