Identifying the capabilities of ip phone clients, X-ciscoipphonemodelname, X-ciscoipphonedisplay – Cisco OL-20949-01 User Manual
Page 75
6-7
Cisco Unified IP Phone Services Application Development Notes
OL-20949-01
Chapter 6 HTTP Requests and Header Settings
Identifying the Capabilities of IP Phone Clients
If 'charset' is not specified, the phones will use the default encoding for the currently configured user
locale. So to avoid possible problems where the phone's default encoding may NOT be ISO-8859-1, the
web server should explicitly set the Content-Type charset (which must match one of the Accept-Charset
values specified by the phone).
Identifying the Capabilities of IP Phone Clients
XML services are supported on many Cisco Unified IP Phones, so web application servers must identify
the capabilities of the requesting IP phone to optimize the content returned to the phone. For example,
if the requesting phone is a Cisco Unified IP Phone 7960, which cannot support color PNG images, the
application server must be able to identify this and return a gray scale CIP image instead.
The IP phone client request to send the relevant information from the IP phone to the web server
application includes three (3) HTTP headers:
•
•
•
x-CiscoIPPhoneModelName
This Cisco-proprietary header contains the Cisco manufacturing Model Name of the device, which can
typically be found by going to Settings > Model Information, but varies between different models.
Some examples of manufacturing Model Names are CP-7960, CP-7960G, CP-7940G, CP-7905G, and
CP-7970G.
x-CiscoIPPhoneDisplay
This Cisco-proprietary header contains the display capabilities of the requesting device with the
following four parameters (listed in the order in which they appear):
•
Width (in pixels)
•
Height (in pixels)
•
Color depth (in bits)
•
A single character indicating whether the display is color (''C'') or gray scale (''G'')
These parameters get separated by commas as shown in the following example of a
Cisco Unified IP Phone 7970 header:
x-CiscoIPPhoneDisplay: 298, 168, 12, C
Note
The pixel resolutions advertised by the device define the area of the display accessible by the phone
services; not the actual resolution of the display.