Polycom Web Application Developer’s User Manual

Web Application Developer’s Guide Polycom Phones Running Polycom UC Software

UC Software 3.1.1 | October 2010 | 1725-17693-331 Rev. A

Trademark Information

POLYCOM®, the Polycom “Triangles” logo and the names and marks associated with Polycom’s products are trademarks and/or service marks of Polycom, Inc. and are registered and/or common law marks in the United States and various other countries. All other trademarks are property of their respective owners. No portion hereof may be reproduced or transmitted in any form or by any means, for any purpose other than the recipient’s personal use, without the express written permission of Polycom.

Patent Information

The accompanying product is protected by one or more U.S. and foreign patents and/or pending patent applications held by Polycom, Inc.

Disclaimer

Some countries, states, or provinces do not allow the exclusion or limitation of implied warranties or the limitation of incidental or consequential damages for certain products supplied to consumers, or the limitation of liability for personal injury, so the above limitations and exclusions may be limited in their application to you. When the implied warranties are not allowed to be excluded in their entirety, they will be limited to the duration of the applicable written warranty. This warranty gives you specific legal rights which may vary depending on local law.

4750 Willow Road Pleasanton, CA 94588-2708 USA

No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of Polycom, Inc. Under the law, reproducing includes translating into another language or format.

As between the parties, Polycom, Inc., retains title to and ownership of all proprietary rights with respect to the software contained within its products. The software is protected by United States copyright laws and international treaty provision. Therefore, you must treat the software like any other copyrighted material (e.g., a book or sound recording).

Every effort has been made to ensure that the information in this manual is accurate. Polycom, Inc., is not responsible for printing or clerical errors. Information in this document is subject to change without notice.

About This Guide

The Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX is for developers of applications which use the Web Server and the Microbrowser on SoundPoint IP and SoundStation IP phones and the Browser on the Polycom VVX phones.

The following related documents for SoundPoint IP/SoundStation IP/VVX phones are available:

• Quick Start Guides, which describe how to assemble the phones

• Quick User Guides, which describe the most basic features available on

the phones

• User Guides, which describe the basic and advanced features available on the phones

• Administrator’s Guide, which describes how to configure, customize, manage, and troubleshoot SoundPoint IP/SoundStation IP/VVX phone systems

• Technical Bulletins, which describe workarounds to existing issues and provide expanded descriptions and examples

• Release Notes, which describe the new and changed features and fixed problems in the latest version of the software

For support or service, please go to Polycom Technical Support at

http://www.polycom.com/support/voip/.

Polycom recommends that you record the phone model numbers, software (both the bootROM and SIP), and partner platform for future reference.

SoundPoint IP/SoundStation IP/VVX models: ___________________________

BootROM version: ________________________________________________

SIP Application version: ___________________________________________

Partner Platform: _________________________________________________

iii

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii

1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1

2 SoundPoint IP/SoundStation IP/VVX XML API Application

Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–1

What is the Microbrowser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–2

What is the Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–3

What is XHTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–4

How to Create Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–5

New Features in SIP 3.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–6

Programmable Soft Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–1

Telephone Integration URIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–4

Push Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–8

Telephony Notification Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–11

Phone State Polling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–16

API Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2–22

3 Application Development for the Microbrowser . . . . . . . . . 3–1

Supported XHTML Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–1

Basic Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–2

Link Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–3

Input Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–3

Image Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–6

Table Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–7

Meta Information Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–13

HTTP Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–14

Microbrowser User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–15

Launching the Microbrowser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–16

Navigation and Form Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–16

Idle Display Microbrowser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–17

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Developing an XHTML Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–17

Changing Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 3–18

Sample Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3–20

4 Application Development for the Browser . . . . . . . . . . . . . . 4–1

Supported Standards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–1

HTTP Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–2

Browser User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–3

Launching the Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–4

Navigation and Form Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–4

Idle Display Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–5

Setting Up the Polycom SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–5

Developing an XHTML Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–6

Changing Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–6

Sample Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4–8

5 Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–1

XML Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5–1

A Appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .A–1

Unsupported XHTML Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A–1

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Index–1

Overview

Polycom has two different application development environments, the one you choose depends on the phone model and software version running on the phone. This guide is intended to provide an overview of each development environment and example applications that will run in each environment.

This chapter provides an overview of the Web Server and the Microbrowser available on certain SoundPoint IP and SoundStation IP phones, and the Polycom VVX 1500 phone running SIP 3.1.3 or earlier. It also provides an overview of the Web Server and the Browser available on the Polycom VVX 1500 phone running SIP 3.2 or later.

Note

When SoundPoint IP 32x/33x is used in this guide, it includes the SoundPoint IP 320, 321, 330, 331, and 335 phones.

A comparison between the Microbrowser and the Browser is shown in the following table.

Microbrowser Browser

Supported On IP 32x/33x, IP 430,

IP 450, IP 550, IP 560, IP 650, IP 670, IP 6000, IP 7000, VVX 1500 (running SIP 3.1.3 or earlier)

XML API programmable soft keys,

telephone integration URIs, push requests, telephone notification events, phone state polling

Capabilities HTML 4.01

XHTML 1.0

VVX 1500 (running SIP

3.2.2 or later)

telephone integration URIs, push requests, telephone notification events, phone state polling

partial HTML 5.0 XHTML 1.1

1 - 1

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

This chapter contains information on:

• What is the Microbrowser

• What is the Browser

• What is XHTML

• How to Create Applications

• New Features in SIP 3.2

To develop an application that can run on the Web Server and the Microbrowser, refer to Application Development for the Microbrowser on page 3-1. To develop an application that can run on the Web Server and the Browser, refer to Application Development for the Browser on page 4-1.

To troubleshoot any problems with your applications, refer to

Troubleshooting on page 5-1.

What is the Microbrowser

The Microbrowser is like any Web browser—Microsoft Internet Explorer and Firefox, for example—but supports only a subset of XHTML features. It can connect to Web servers hosted in the Internet or intranet and download XHTML pages. The Microbrowser supports a limited number of XHTML 1.0 features—it does not have full Web browser functionality.

The Microbrowser downloads XHTML content from a Web server into the phone’s memory, then parses the content to identify XHTML tags and renders these tags onto the phone’s graphic display. The appearance of the rendered page depends on the graphical capabilities and display size of the device on which the browser is running. Complicated pages should be avoided on devices with very small displays.

The Microbrowser does not support scripting (such as JavaScript). All actions on data entered into forms is processed by the server using POST or GET methods.

The XHTML pages displayed on the Microbrowser can contain static or dynamic information.

Static XHTML. These pages are created using XHTML editors and hosted by the Web server. These pages are accessed from the Microbrowser (using HTTP protocol) by entering the URL to access the page. These XHTML pages are called static, because the information that is displayed is already coded into the XHTML pages. These pages do not include information that keeps changing or contact other services for update.

1 - 2

Overview

Dynamic XHTML. These pages involves dynamic information updates of XHTML pages by an application hosted on the Web server. The application residing on the Web server will get information from an intranet or through the Internet—data service providers like Yahoo, Exchange Server, Call Control Servers and other enterprise servers.

Users can launch the Microbrowser on a SoundPoint IP or SoundStation IP phone by pressing the Applications key or, if there isn’t one on the phone, it can be accessed through the Menu key by selecting Applications.

Note

As of SIP 2.2, the Services key and menu entry were renamed Applications, however the functionality remains the same.

The Microbrowser is supported on part of the phone’s total display area:

Microbrowser Screen

Phone T otal Screen Size

SoundPoint IP 32x/33x 102x33 pixels 88x12 pixels SoundPoint IP 430 184x64 pixels 134x31 pixels SoundPoint IP 450 256x116 pixels 171x72 pixels SoundPoint IP

550/560/650/670 SoundStation IP 6000 240x68 pixels 248x32 pixels SoundStation IP 7000 255x128 pixels 255x79 pixels Polycom VVX 1500 800x480 pixels 562x322 pixels

320x160 pixels 213x110 pixels

Size

For more information, refer to Application Development for the Microbrowser on page 3-1.

What is the Browser

The Browser is also like any other major web browser. It is based on the powerful and popular open source WebKit platform. The version can be found in the user agent string. (The user agent string can be seen in network captures in the User-Agent HTTP header.)

The Browser supports true Web 2.0 applications with the following features:

• XHTML 1.1

• HTML 4.01 with partial support for HTML 5

• CCS 2.1 with partial support for CCS 3.0

1 - 3

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

• SVG 1.1 (partial support)

• JavaScript

• XMLHttpRequest

• DOM

• HTTP 1.1

As noted previously, the Browser is only available today on the Polycom VVX 1500 phone. The interactive browser window takes up the phone’s full screen (800x480 pixels). The web content area is 800x395 pixels. The idle browser window is 610x360 pixels.

For more information, refer to Application Development for the Browser on page 4-1.

What is XHTML

XHTML is the abbreviation of eXtensible HyperText Markup Language.

XHTML 1.0 is a transformation of HTML into valid XML. The use of the stricter XML syntax makes parsing of XHTML much easier for small clients, but XHTML 1.0 was also the first step towards making HTML easily extensible. Moving to XML allowed the methods used to create XML extensions to apply to HTML as well. Step two occurred with XHTML 1.1, where XHTML was divided up into ‘modules’, where any features above and beyond a skeleton set were grouped into individual modules. User agent (UA) developers could then decide which extensions to support. A simple user agent can be considered a fully compliant user agent by supporting only the Basic module, whereas a more powerful browser can support all the official modules, as well as those developed by third parties.

Modularization is also intended to help content creators. As more and more devices become web-enabled, the number of platforms a content creator will be asked to support will become unreasonable. By dividing HTML up into different ‘building blocks’ content creators can supply a minimal version of their site for user agents that only support the Basic module, a moderate version of their site for user agents who support the additional modules, and a full version of their site for user agents that support the full range of the XHTML specification.

Finally the X in XHTML was intended to help people who wish to extend HTML. The use of XML brought a standard grammar with which they could define their extension, and the modularization meant that their extension would be just another module that a user agent developer or content creator could choose to support. Additionally, since XHTML pages should state what modules are required to accurately render them, the user agent software could dynamically load a ‘plug-in’ that it could use to render a module that was defined after the user agent had been originally released.

1 - 4

For more information, go to:

• HTML 4.0—http://www.w3.org/TR/html401

• HTML 5 —http://www.w3.org/TR/html5

• XHTML™ 1.0—http://www.w3.org/TR/xhtml1

• XHTML™ Basic—http://www.w3.org/TR/xhtml-basic

• XHTML™ 1.1—http://www.w3.org/TR/xhtml11

• XHTML Tables Module -

XHTML™2.0—http://www.w3.org/TR/2004/WD-xhtml2-20040722/m od-tables.html

For the purposes of this guide, it is assumed that you have experience in HTML and XHTML programming or access to someone who has such experience.

How to Create Applications

Overview

The Polycom Software Development Kit (SDK) application environment allows developers to create full-featured, context-aware applications using familiar web technologies such as AJAX, HTML, JavaScript, and CSS.

The Polycom SDK development environment is based on the popular open source WebKit developer toolset. Combined with an Integrated Development Environment (IDE) and Polycom’s rich set of XML APIs, the development of applications is easy and familiar. To develop widgets or rich, interactive applications, use the open source Web 2.0 technologies known as AJAX. These are the same technologies that allow the migration of web content out of the browser and into other environments. Using open source technologies decreases the development learning curve and increases compatibility between platforms and devices. Common IDE environments include Eclipse, NetBeans, and Microsoft Visual Studio; and form the basis for developing rich and interactive applications.

Microbrowser/Browser applications may be static in nature, but often involve two-way communication that incorporates user input, acknowledgement and interaction. The Polycom XML APIs and support interactive applications development, with access to the resources on the targeted phones.

You can design the following examples of applications:

• Text messaging application

• Company directory

• Stock ticker

Depending on the type and complexity of the application, you might use one of the following tools to assist with application development:

1 - 5

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

• Text editor

• XML editor

• Integrated Development Environment (IDE)

When designing applications, you might want to consider the following guidelines:

Note

These guidelines are for your information only. You are solely responsible for determining the suitability and applicability of this information to your needs.

1. Spend sufficient time designing the application by:

— Developing a conceptual design

— Describe all user-application interactions

— Plan for all user types

2. Create standardized applications to assist in:

— Lowering design time

— Speed up debugging

— Increasing usability

3. Promote consistent output and predictable user input.

4. Create a prototype application to test on sample users.

5. Thoroughly test your application before releasing to:

— Identify all user interface issues

— Verify that all error conditions are caught cleanly

For step-by-step instructions on how to develop an XHTML application that can be run on the Microbrowser of all SoundPoint IP and SoundStation IP phones, refer to Application Development for the Microbrowser on page 3-1. For step-by-step instructions on how to develop an XTML application that can be run on the Browser of the Polycom VVX 1500, refer to Application

Development for the Browser on page 4-1.

Note

Polycom is not responsible for troubleshooting any programming that you create for the Microbrowser and/or Browser.

New Features in SIP 3.2

The following new features were introduced in SIP 3.2.2:

• The Browser on the Polycom VVX 1500

— What is the Browser

1 - 6

Overview

The following existing sections were changed in SIP 3.2.0:

• Programmable Soft Keys on page 2-1

• Telephone Integration URIs on page 2-4

• Call Line Information on page 2-17

• HTTP Support on page 3-14

The Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family has been reorganized:

• SoundPoint IP/SoundStation IP/VVX XML API Application Interface is

now in a separate chapter, Chapter 2

• Application Development for the Microbrowser is now in a separate

chapter, Chapter 3

• Application Development for the Browser is in a new chapter, Chapter 4

1 - 7

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

1 - 8

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

There is XML API support for applications on the SoundPoint IP 32x/33x, 430, 450, 550, 560, 650, and 670 desktop phones, the SoundStation IP 6000 and 7000 conference phones, and the Polycom VVX 1500 phones.

The SoundPoint IP/SoundStation IP/VVX XML API is intended to provide developers with flexibility in developing applications on SoundPoint IP, SoundStation IP, and Polycom VVX 1500 phones, while tightly integrating into the phone’s telephony capabilities and functions. The XML API features are supported by the Microbrowser and Browser, except where noted.

This support includes:

• Programmable Soft Keys

• Telephone Integration URIs

• Push Requests

• Telephony Notification Events

• Phone State Polling

For a discussion of the security aspects of this API, refer to API Security on page 2-22.

Programmable Soft Keys

Note

The programmable soft key tag is not supported in the Browser on the Polycom VVX 1500. However, the same functionality can be created through HTML button tag:

The following programmable soft key tag is supported:

• <softkey>—Defines a soft key

2 - 1

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

The softkey element creates a soft key with a customizable label, position, and action. Users execute actions by pressing the soft key on their phone.

The soft keys are modified within the interactive Microbrowser only.

The following format is supported:

The following attributes are supported:

Attribute Value/s Description

index numeric, 1 to 8 Position of the soft key. name string Text displayed on soft key when

label string Text displayed on soft key. The

Softkey:Submit action is used. It is ignored for all other actions. Use in cases where more than one Softkey:Submit action appears on a page.

maximum length is 9 characters.

Note: If empty or absent, default action name is displayed.

action URI Supported actions (must be one of

those listed in the next table).

The supported actions are described in the following table:

Action Default Action Name Description

SoftKey:Home Home Moves to configured home page Softkey:Back Back Move to previous page SoftKey:Exit Exit Exits Microbrowser SoftKey:Cancel Cancel Cancel action SoftKey:Refresh Refresh Refreshes current page SoftKey:Fetch;

<URI> SoftKey:Reset Reset Clears all input fields in the form SoftKey:Submit Submit Submits the form Key:VolDown VolDown Decreases volume by 1 unit Key:VolUp VolUp Increases volume by 1 unit

Fetch Fetches the page from the given

URI

2 - 2

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

Action Default Action Name Description

Key:DoNotDisturb Do not disturb Enables Do Not Disturb feature Key:Headset Headset Enables use of microphone Key:Handsfree Hands-free Enables use of speaker Key:Messages Messages Open the Messages menu Key:Applications Applications Open the Applications menu Key:MicMute Mute Mutes the phone when the call

state Key:Directories Directories Open the Directories menu Key:Menu Menu Opens the main menu Key:Setup Setup Opens the main menu Settings

Depending on the browser state, a number of predefined soft keys exist:

Note

Action Predefined Soft Key

Browser Active—fetching pages or rendering data

Browser Stop—no longer active Home, Refresh, Back, Exit or

Edit Active—when entering text Home, A->a1, Back, Exit

The soft keys from the “Browser Active” and “Edit Active” soft key groups override any custom soft keys defined in the current XHTML.

The soft keys from the “Browser Stop” soft key group appear if no custom soft keys are defined.

The exact soft keys that appear vary between the SoundPoint IP and SoundStation IP phones.

Home, Refresh, Back, Stop

programmable soft key

The following should be noted with respect to softkey tags:

• All actions are case insensitive.

• If the soft key action name is empty, the soft key tag is ignored.

• The Reset and Submit soft key tags must exist inside the

<form>

tag that

they are to act upon.

• On the Polycom VVX 1500, the Reset and Submit soft key tags can exists inside a single form element. If there are multiple forms inside an XHTML document, the XHTML Submit and Reset input elements must be used.

2 - 3

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

• Indexes need not be sequential. A missing index will result in an empty space, no soft key displayed.

• An index greater than eight is ignored.

• By default, a Back soft key is placed on the graphic display (even if one is

not defined).

Note

The Back soft key will not appear when otherwise it will appear.

• When using more than one Submit soft key on page, use the name to distinguish between them.

For example, to create a simple page:

<html>

<p> Hello World! </p><br/>

</html>

Telephone Integration URIs

Internal URIs provide the interface to execute predefined actions on the phone. These actions are similar to the manual execution of key presses by the user.

There are three ways to execute an internal URI action:

• If the file sent to the phone contains only internal URI actions, the file content type must be “ internal URIs are executed in ascending order.

mb.main.autoBackKey

is set to 0;

application/x-com-polycom-spipx

”. The

2 - 4

• If an XHTML file will include internal URI, they must be defined in (and executed from) anchor tags, in the

hef=”Key:Setup”>Menu</a>

). When the user selects the anchor, the

attribute (for example,

href

action is processed and executed.

• Use one of the following soft key actions in anchor tags:

— SoftKey:Home

— SoftKey:Back

— SoftKey:Exit

— SoftKey:Cancel

— SoftKey:Refresh

Refer to Programmable Soft Keys on page 2-1.

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

Note

Internal URI actions contained in a file with content type

application/x-com-polycom-spipx

“

” can be executed only through a URL push.

The following format is supported:

ActionType:Action

where:

• ActionType is a type of key or action to execute (Key, Softkey, Tel, or Play)

• Action is the name of the action to be executed.

The supported internal URIs are described in the following table:

Action Type Action Description

Key Line1 to Line48 The Key URIs send the key press

DialPad0 to DialPad9 SoftKey1 to SoftKey5 DialPadStar DialPadPound VolDown

event to the phone. The phone processes this event as if the button had been physically pressed.

VolUp Headset Handsfree MicMute Menu Messages Applications Directories Setup ArrowUp ArrowDown ArrowLeft ArrowRight

2 - 5

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Action Type Action Description

Key (Continued) Backspace

DoNotDisturb Select Conference Transfer Redial Hold

SoftKey Back The SoftKey URIs send the soft

Cancel Exit Home Refresh

key press event to the phone. The phone processes this event as if the associated soft key had been physically pressed. These URIs function when the interactive Microbrowser is on the screen.

Note: The programmable soft key related URIs are not supported on the Browser on the Polycom VVX

1500.

Tel Number;LineIndex The Tel URI initiates a new call to

the specified number on the specified line. The line number is optional (the first available line is used). The digit map rules are followed (refer to “Digit Map” in the

Administrator’s Guide for the SoundPoint IP / SoundStation IP / VVX Family).

Note: The LineIndex value is case insensitive. The range of LineIndex is “Line1” to “Line48”.

Note: If the line corresponding to the LineIndex in the Tel action is busy, the existing call on that line is held and a call is placed to the number specified in the Tel URI on that given line.

2 - 6

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

Action Type Action Description

Play Play:<audiofile_path> Download and play the audio file.

The supported audio formats are G.711μ-law, G.711a-law, and Liner16.

The <audiofile_path> is the relative path on the application server, relative to

apps.push.serverRootURL

The supported maximum file size is determined by

res.finder.sizeLimit.

For G.711μ-law and G.711a-law files:

• Sample rate must be 8ksps with a sample size of 8. This is supported on all phones.

For Liner16 files:

• Sample size must 16 for all sample rates.

• Sample rate of 16ksps is supported on SoundPoint IP 32x/33x, 430, 450, 550, 560, 650, and 670, SoundStation IP 6000 and 7000, and Polycom VVX 1500 phones.

• Sample rate of 32ksps and 48 ksps is supported on SoundStation IP 6000 and 7000 and Polycom VVX 1500 phones.

• Sample rate of 8ksps and 44.1 ksps is supported on Polycom VVX 1500 phones.

Note: An error is logged if the file is too large to play.

The following should be noted with respect to internal URIs:

• The action name and key type are case insensitive.

• For non-XHTML content containing only internal URIs, the internal URIs

are executed in ascending order without any delay.

• If any URI is invalid and it is in a file of only internal URIs, the entire file is rejected.

2 - 7

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

• If any invalid URI is present in a XHTML file, the execution of that URI is ignored.

For example, to create a link that behaves as if you pressed the Do Not Disturb key:

<html>

<body> <br/> Click on the link to engage the DND feature

<a href="Key:DoNotDisturb">DNDSettings</a>

</body> <softkey index="1" label="Back" action="SoftKey:Back" /> <softkey index="2" label="Exit" action="SoftKey:Exit" />

</html>

For example, to place a call to “*50”:

<html>

</body>

</html>

Push Requests

A push request is defined as a request that you send to a remote site asking for data to be sent to you.

HTTP <URL> Push

The HTTP URL push allows you to send asynchronous relative URIs to a specific phone.

The following format is supported:

2 - 8

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

The following attributes are supported:

Attribute Value/s Description

Note

priority “critical” = Accept critical priority

push requests only “Normal” = accept normal priority push requests only

URI path string Any relative URI (or relative URI

This tag must be defined under a

Priority

Note: If attribute is absent, “normal” is used.

path) on the configured application server.

Note: Currently multiple URIs in a single push request are not supported.

root tag.

The following table describes when to use a specific priority:

Phone State Priority Description

Idle State Critical The phone will display push

request immediately.

Normal The phone will display push

request immediately.

Non-Idle State Critical The phone will display push

request immediately.

Normal The phone will keep push request

in push queue. Once the phone is idle, the push request will be displayed.

The following should be noted with respect to HTTP URI push:

• By default, a Back soft key is placed on the graphic display.

The Back soft key will not appear when

mb.main.autoBackKey

is set to 0;

otherwise it will appear.

• Push requests are displayed as “first-in-first-out”.

• Changes must be made in the sip.cfg configuration file to enable this

feature. For example, the

httpd.enabled

parameter must be set to 1 (default setting). Refer to Push Request Configuration Parameters on page

2-11.

2 - 9

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

• All HTTP requests are challenged through HTTP Digest Authentication.

• If the phone cannot fetch the content from the pushed URI, the request is

ignored.

For example, to push the display of soft keys that fetch pages:

<URL priority=”normal”>/examples/media.xhtml</URL>

</PolycomIPPhone>

where

<html>  Press any soft key to fetch the corresponding page <softkey index="1" label="Top News" action="SoftKey:Fetch;http://www.cbc.ca/news/world/top/> <softkey index="2" label="Weather "action="SoftKey:Fetch;http://www.theweathernetwork.com/canada/bc/burn aby/current/"/> <softkey index="4" label="Sports" action="SoftKey:Fetch;http://www.tsn.ca/topstory/"/> <softkey index="3" label="Back" action="SoftKey:Back"/> </html>

media.xhtml

is defined as follows:

HTML <Data> Push

The data push allows you to send messages in XHTML format to a specific phone.

The following format is supported:

The following attributes are supported:

2 - 10

Note

Attribute Value/s Description

priority “critical” = Accept critical priority

push requests only “Normal” = accept normal priority push requests only

text text in HTML format Text

This tag must be defined under a

Priority

Note: If attribute is absent, “normal” is used.

Note: The maximum file size is 1KB.

root tag.

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

For example, to push the display of an important message:

<Data priority=”critical”> <h1> Fire Drill at 2pm </h1> Please exit and congregate at your appropriate location outside </Data> </PolycomIPPhone>

The following should be noted with respect to HTTP data push:

• Changes must be made in the sip.cfg configuration file to enable this

feature. For example, the

httpd.enabled

parameter must be set to 1 (default setting). Refer to Push Request Configuration Parameters on page

2-11.

Push Request Configuration Parameters

The push request configuration parameters in sip.cfg must be set as follows to enable push requests:

• Set

apps.push.messageType

For example,

• Set

apps.push.serverRootURL

URL.

For example,

• Set

apps.push.username

For example,

The username and password are required to authenticate incoming push requests to the phone.

• Set

apps.push.password

For example,

Telephony Notification Events

The phone can be configured to send information to a specific URI if one of the following telephony notification events occurs:

• Incoming Call Event

• Outgoing Call Event

to the appropriate display priority.

apps.push.messageType

to the application server root relative

apps.push.serverRootURL

to the appropriate username.

apps.push.username

=bob

to the appropriate password.

apps.push.password

=1234

=/sampleapps

• Offhook Event

• Onhook Event

These events are XML data posted to web server by the phone’s Microbrowser or Browser.

2 - 11

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Changes must be made in the sip.cfg configuration file to enable this feature. Refer to Telephony Event Notification Configuration Parameters on page 2-16.

Incoming Call Event

The following format is supported:

</IncomingCallEvent>

The following attributes are supported:

Attribute Value/s Description

Phone IP IP address IP address of the phone.

For example, “172.24.128.160”

MACAddress MAC address MAC address of the phone.

For example, “0004f214b8e7”

CallingPartyName name The name displayed in phone's

"From" label in screen.

• If the line is registered and the call is initiated from that line, then the registered line display name of the calling party is shown. For example, “SoundPoint IP”

• If the line is not registered and the call is initiated from that line, then IP address of the calling party is shown. For example, “sip:172.24.128.160”

2 - 12

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

Attribute Value/s Description

CallingPartyNumber number The number displayed on the

phone.

• If the line is registered and the call is initiated from that line, the registered line number of the calling party is shown.

• If the line is not registered and the call is initiated using IP address from that line, the IP address of the calling party is shown.

CalledPartyName name • If the call is received by

registered line, the registered line display name of the called party is shown.

• If the call is received on a nonregistered line, the IP address of the called party is shown.

CalledPartyNumber number • If the call is received by

registered line, the registered line number of the called party is shown.

• If the call is received on a nonregistered line, the IP address of the called party is shown.

TimeStamp time The date and time that the event

occurred on the phone. For example,

“2008-07-11T13:19:53-08:00”

When the telephone notification URI is set and the incoming call event is enabled to gather information, the following example shows the transmitted data for a call between two registered lines:

</IncomingCallEvent>

</PolycomIPPhone>

2 - 13

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Outgoing Call Event

The following format is supported:

</OutgoingCallEvent>

The following attributes are supported:

Attribute Value/s Description

Phone IP IP address IP address of the phone.

MACAddress MAC address MAC address of the phone.

For example, “172.24.128.160”

For example, “0004f214b8e7”

CallingPartyName name • If the line is registered and the

call is initiated from that line, then the registered line display name of the calling party is shown.

• If the line is not registered and the call is initiated from that line, then IP address of the calling party is shown.

CallingPartyNumber number • If the line is registered and the

call is initiated from that line, the registered line number of the calling party is shown.

• If the line is not registered and the call is initiated using IP address from that line, the IP address of the calling party is shown.

CalledPartyName name The name displayed at phone’s

"To" name.

• If the call is received by registered line, the registered line display name of the called party is shown.

• If the call is received on a nonregistered line, the IP address of the called party is shown.

2 - 14

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

Attribute Value/s Description

CalledPartyNumber number The number displayed on the

phone.

• If the call is received by registered line, the registered line number of the called party is shown.

• If the call is received on a nonregistered line, the IP address of the called party is shown.

TimeStamp time The date and time that the event

occurred on the phone. For example,

“2008-07-11T13:19:53-08:00”

Offhook Event

The following format is supported:

</OffHookEvent>

The following attributes are supported:

Attribute Value/s Description

Phone IP IP address IP address of the phone.

For example, “172.24.128.160”

MACAddress MAC address MAC address of the phone.

For example, “0004f214b8e7”

TimeStamp time The date and time that the event

occurred on the phone. For example,

“2008-07-11T13:19:53-08:00”

Onhook Event

The following format is supported:

</OnHookEvent>

2 - 15

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

The following attributes are supported:

Attribute Value/s Description

Phone IP IP address IP address of the phone.

MACAddress MAC address MAC address of the phone.

TimeStamp time The date and time that the event

Telephony Event Notification Configuration Parameters

The telephone event notification configuration parameters in sip.cfg must be set as followed:

For example, “172.24.128.160”

For example, “0004f214b8e7”

occurred on the phone. For example,

“2008-07-11T13:19:53-08:00”

• Set

apps.telNotification.URL

to the location where notifications

should be sent.

For example,

apps.telNotification.URL

=http://172.24.128.85:8080

If this URL is set to Null, the notifications events will not be sent.

• Set

apps.telNotification.incomingEvent

to 1 or 0 (for Enable or

Disable respectively).

For example,

• Set

apps.telNotification.outgoingEvent

apps.telNotification.incomingEvent

to 1 or 0 (for Enable or

Disable respectively).

For example,

• Set

apps.telNotification.offhookEvent

apps.telNotification.outgoingEvent

to 1 or 0 (for Enable or

Disable respectively).

For example,

• Set

apps.telNotification.onhookEvent

apps.telNotification.offhookEvent

to 1 or 0 (for Enable or Disable

respectively).

For example,

apps.telNotification.onhookEvent

2 - 16

Phone State Polling

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

The phone can be configured to send the current state information toa specific URI upon receipt of an HTTP request. The following types of information can be sent:

• Call Line Information—The line registration and call state will be sent

upon receipt of an HTTP request to the call state handler (http://<Phone_IP>/polling/callstateHandler).

• Device Information—Device- specific information will be sent upon

receipt of an HTTP request to the device handler (http://<Phone_IP>/polling/deviceHandler).

• Network Configuration—Network-specific information will be sent upon

receipt of an HTTP request to the network handler (http://<Phone_IP>/polling/networkHandler).

Two HTTP transactions occur here:

• The application sends an HTTP request to a particular handler in the phone

• The Microbrowser or Browser posts the state, in XML format, to a preconfigured web server.

Changes must be made in the sip.cfg configuration file to enable this feature. Refer to Phone State Polling Configuration Parameters on page 2-22.

Call Line Information

The following format is supported:

<LineKeyNum> </LineKeyNum> <LineDirNum> </LineDirNum> <LineState>Active</LineState> <CallInfo>

</CallInfo>

</CallLineInfo>

Note

The

is not included.

block is included if and only if <LineState> is “Active”. Otherwise it

2 - 17

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

The following attributes are supported:

Attribute Value/s Description

LineKeyNum number Registered phone line key

LineDirNum number Registered line directory number.

number.

LineState Active,

Line state.

Inactive

CallState Outgoing call states:

Call state. Dialtone, Setup, RingBack

Incoming call states: Offering

Outgoing/Incoming call states: Connected, CallConference, CallHold, CallHeld, CallConfHold, CallConfHeld

Shared line states: CallRemoteActive

CallType Incoming, Outgoing Call type. UIAppearance

Index

string Call appearance index.

The call appearance index for the

active call is denoted by a *

character suffix.

CallingPartyName number If the line is registered, the value is

the registered line display name.

If the line is not registered, the

value is the IP address of the

calling party.

2 - 18

CallingPartyDirNum number If the line is registered, the value is

the registered line number.

If the line is not registered, the

value is the IP address of the

calling party.

CalledPartyName name If the line is registered, the value is

the registered line display name.

If the line is not registered, the

value is the IP address of the

called party.

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

Attribute Value/s Description

CalledPartyDirNum number If the line is registered, the value is

the registered line number.

If the line is not registered, the

value is the IP address of the

called party.

CallReference number An internal identifier for the call. CallDuration number in seconds Duration of the call in seconds.

When the phone state polling URL is set and the phone receives a Call Line Information Request, the following example shows the transmitted data:

<LineKeyNum>1</LineKeyNum> <LineDirNum>10</LineDirNum> <LineState>Connected</LineState> <CallInfo>

<CallState>Offering</CallState> <CallType>Incoming</CallType> <CalledPartyName>10</CalledPartyName> <CalledPartyNumber>10</CalledPartyNumber> <CallingPartyName>21</CallingPartyName> <CallingPartyNumber>21@172.24.128.61</CallingPartyNumber> <CallReference>0</CallReference> <CallDuration>0</CallDuration>

</CallInfo> </CallLineInfo> <CallLineInfo>

<LineState>NotConnected</LineState> </CallLineInfo> <CallLineInfo>

<LineState>NotConnected</LineState> </CallLineInfo>

</PolycomIPPhone>

2 - 19

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Device Information

The following format is supported:

</DeviceInformation>

The following attributes are supported:

Attribute Value/s Description

MACAddress MAC address MAC address of the phone. PhoneDN string List of all registsred lines, including

expansion modules, and their directory numbers delimited by commas.

For example, “Line1:1,Line2:2,Line3:3”

AppLoadID string Application load ID on the phone.

For example, “Tip 27-Feb-08 20:07”

BootROMID string BootROM on the phone.

For example, “4.1.0.0213”

ModelNumber string Phone’s model number.

For example, “SoundPoint IP 650”

TimeStamp time The date and time that the event

occurred on the phone.

2 - 20

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

Network Configuration

The following format is supported:

</Networkconfiguration>

The following attributes are supported:

Attribute Value/s Description

DHCPServer IP address DHCP server IP address. MACAddress MAC address MAC address of the phone. DNSSuffix host name DNS domain suffix. IPAddress IP address IP address of the phone. SubnetMask IP address IP address of the subnet. ProvServer IP address Provisioning server. DefaultRouter IP address IP address of default router (or IP

gateway).

DNSServer1 IP address Configured IP address of DNS

Server 1.

DNSServer2 IP address Configured IP address of DNS

Server 2. VLANID Null, 0 through 4094 Phone’s 802.1Q VLAN identifier. DHCPEnabled Yes, No If DHCP is enabled, set to “Yes”.

2 - 21

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Phone State Polling Configuration Parameters

The phone state polling configuration parameters in sip.cfg must be set as followed:

API Security

• Set

apps.statePolling.URL

to the location where requested information

should be sent.

For example,

apps.statePolling.URL

=http://172.24.128.85:8080

If this URL is set to Null, the requested information will not be sent.

• Set

apps.statePolling.username

For example,

apps.statePolling.username

to the appropriate username.

=bob

The username and password are required to authenticate incoming polling requests to the phone.

• Set

apps.statePolling.password

For example,

apps.statePolling.password

to the appropriate password.

=1234

With respect to the security of the SoundPoint IP/SoundStation IP/VVX XML API, the following should be noted:

• Authenticating remote control and monitoring—The execution of each of each HTTP GET/POST request requires an MD5 digest authentication. The execution of each HTTP PUSH request supports MD5 digest authentication as well as TLS and HTTPS. All pushed URLs are relative URLs with the root specified in the sip.cfg configuration file.

2 - 22

Note

• Achieving confidentiality of executed content—The phone’s HTTP client supports TLS, so any data retrieved from the URL can be protected. Make sure of the confidentiality of all traffic past the initial push request by specifying a root URL that uses https.

• Event reporting—The confidentiality of all events reported by the phone can be also be protected by TLS in the same way that push content is.

• Direct data push—When direct data push is enabled—disabled by default— small amounts of content (1KB) can be sent directly to the phone by the application server. The request will still be authenticated through HTTP digest, but all content will be in clear text on the network. Polycom recommends that you only use unencrypted data push for broadcast type alerts that do not pose any confidentiality risks.

Both

apps.push.username

push to be enabled.

and

apps.push.password

must be set for data

Application Development for the Microbrowser

This chapter presents an overview on how to develop an XHTML application that can be run on the Web Server and Microbrowser available on certain SoundPoint IP and SoundStation IP phones (refer to the table in Overview on page 1-1). It also describes the relevant configuration parameters that can be found in the sip.cfg configuration file.

This chapter contains information on:

• Supported XHTML Elements

• HTTP Support

• Microbrowser User Interface

• Developing an XHTML Application

To troubleshoot any problems with your applications, refer to

Troubleshooting on page 5-1.

Note

Polycom is not responsible for troubleshooting any programming that you create for the Microbrowser.

Supported XHTML Elements

The Microbrowser supports a subset of XHTML elements. Most are derived from HTML 4.01.

The supported elements and attributes are:

• Basic Tags

• Link Tags

• Input Tags

• Image Tags

3 - 1

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

• Table Tags

• Meta Information Tags

Unsupported elements and attributes are described in Unsupported XHTML

Elements on page A-1.

Basic Tags

The following basic tags are supported:

• <!DOCTYPE>—Defines the document type

• —Defines a comment

<!DOCTYPE>

The <!DOCTYPE> declaration should be the very first thing in your document, before the <html> tag. This tag tells the browser which XHTML specification the document uses. XHTML 1.0 specifies three XML document types: Strict, Transitional, and Frameset.

• XHTML Strict

— Use this DTD when you want clean markup, free of presentational

clutter.

For example, <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

• XHTML Transitional

— Use this DTD when you need to use XHTML's presentational features.

For example, <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

• XHTML Frameset

— Use this DTD when you want to use frames.

For example, <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">

XHTML 1.1 specifies one XML document type: Strict. For example, <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

3 - 2

This tag does not have any attributes.

Link Tags

Application Development for the Microbrowser

The comment tag is used to insert a comment in the source code. A comment will be ignored by the browser. You can use comments to explain your code, which can help you when you edit the source code at a later date.

This tag does not have any attributes.

The following link tag is supported:

• <a>—Defines an anchor

<a>

The <a> tag defines an anchor. An anchor can be used to create a link to

href

another document by using the

attribute.

The following attributes are supported:

Attribute Value/s Description

href URL (Ex:”

http://www.polycom.com”)

name section_name Names an anchor. Use this

The target URL of the link

Note: The Microbrowser supports both

http://

schemes as well as internal URIs. When a tel:// URL is selected, the phone switches to the telephony application and dials the number specified in the URL. Currently the number is dialed as-is, however, full support for tel:// URL parsing as specified in RFC 2806 will be available in a future release.

sip://

this time.

attribute to create a bookmark in a document.

In future versions of XHTML the name attribute will be replaced by the id attribute.

Note: This attribute is parsed, but not used.

and

tel://

URLs are not supported at

URL

3 - 3

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Input Tags

The following input tags are supported:

• <form>—Defines a form

• <input>—Defines an input field

Note

The Microbrowser supports both the GET and POST methods for submitting forms. Nesting forms within tables is supported. However, nesting of one form tag within another is not supported and may lead to unexpected results.

<form>

The form element creates a form for user input. A form can contain text fields, check boxes, radio buttons and more. Forms are used to pass user data to a specified URL.

The following attributes are supported:

Attribute Value/s Description

action URL

Ex: “http://www.google.com”

method get

post

A URL that defines where to send the data when the subm it butt on is pushed

The HTTP method for sending data to the action URL. Default is get.

method="get": This method sends the form contents in the URL: URL?name=value&name=value.

Note: If the form values contains non-ASCII characters or exceeds 100 characters you MUST use method="post".

method="post": This method sends the form contents in the body of the request.

3 - 4

name form_name Defines a unique name for the

form

Application Development for the Microbrowser

<input>

The <input> tag defines the start of an input field where the user can enter data. In XHTML the <input> tag must be properly closed.

The following attributes are supported:

Attribute Value/s Description

checked checked Indicates that the input element

should be checked when it first loads.

Note: Used with type="checkbox" and type="radio"

name field_name Defines a unique name for the

input element.

Note: This attribute is required with type="button", type="checkbox", type="file", type="hidden", type="image", type="password", type="text", and type="radio"

type checkbox

file hidden password radio reset submit text

value value For buttons, reset buttons and

Indicates the type of the input element. The default value is "text".

submit buttons: Defines the text on the button.

For image buttons: Defines the symbolic result of the field passed to a script.

For checkboxes and radio buttons: Defines the result of the input element when clicked. The result is sent to the form's action URL.

For hidden, password, and text fields: Defines the default value of the element.

Note: Cannot be used with type="file"

Note: This attribute is required with type="checkbox" and type="radio"

3 - 5

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Image Tags

The following image tag is supported:

• <img>—Defines an image

The Microbrowser supports images stored in uncompressed .bmp or in .jpg format.

• While all BMP bit depths will be displayed to the best of the phone’s ability, it is recommended that the image format most suitable for the target platform be chosen. For example:

— The SoundPoint IP 601 LCD supports four levels of grey, so a 16-color

BMP format would be most appropriate.

— The SoundPoint IP 670 LCD supports 12-bit color.

• JPEG images are supported on SoundPoint IP / SoundStation IP phones

except for SoundPoint IP 32x/33x, 430, 450, 550, 560, 650, and 670 desktop phones, SoundStation IP 6000 and 7000 conference phones.

Images can be scrolled up and down, however images that are too wide will be truncated.

Note

Various platforms have differing limits due to memory. There are also differing pixel limits for devices of differing pixel depth. A 1 bit per pixel image 160x80 requires only 1600 bytes. For a 24 bit picture, the memory requirement is 38400 bytes.

There are several limits depending on the source data (this involves the cache limits in configuration) and the display converted data, which is dependant on available RAM (and is limited in the code depending on platform).

<img>

The img element defines an image.

The "align", "border", "hspace", and "vspace" attributes of the image element are not supported in XHTML 1.0 Strict DTD.

The image is not scaled—up or down—when only one of “width” or "height" is used; however, scaling works when both are used together.

3 - 6

Application Development for the Microbrowser

The following attributes are supported:

Attribute Value/s Description

Tab le Tags

src URL

(Ex: “http://www.topxml.com/images/to pxml_site.gif”)

height Pixels (number, EX: “30” )

width Pixels (number, EX: “30” )

The following table tags are supported:

• <table>—Defines a table

• <caption>—Defines a table caption

• <th>—Defines a table header

• <tr>—Defines a table row

• <td>—Defines a table cell

• <thead>—Defines a table header

The URL of the image to display

Specifies the height of the image in pixel or percent.

Specifies the width of the image in pixel or percent.

Note

• <tbody>—Defines a table body

• <tfoot>—Defines a table footer

XHTML tables must be properly formatted (should include <tbody> and </tbody> tags).

<table>

The <table> tag defines a table. Inside a <table> tag you can put table headers, table rows, table cells, and other tables.

3 - 7

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

The following attributes are supported:

Attribute Value/s Description

align left

center right

border Pixels (number, EX: “30” ) Specifies the border width.

cellpaddingPixels (number, EX: “30” )

cellspacing Pixels (number, EX: “30” )

width %

Pixels (number, EX: “30” )

Aligns the table. Deprecated. Use styles instead.

Tip: Set border="0" to display tables with no borders!

Specifies the space between the cell walls and contents

Specifies the space between cells.

Specifies the width of the table

This element defines a table caption. The <caption> tag must be inserted immediately after the <table> tag. You can specify only one caption per table. Usually the caption will be centered above the table. The “align” attribute of the caption element is not supported in XHTML 1.0 Strict DTD.

The following attributes are supported:

3 - 8

Attribute Value/s Description

align left

right top bottom

id unique_name Defines a unique name

class class_rule

style_rule

title tooltip_text A text to display in a tool

style style_definition An inline style definition

How to align the caption. Deprecated. Use styles instead.

for the map tag. The class of the element

tip

Application Development for the Microbrowser

Attribute Value/s Description

dir ltr (left to right)

rtl (left to right)

lang language_code (Ex: EN,

deu/ger, hin)

xml:lang la nguage_code (Ex: EN,

deu/ger, hin)

Sets the text direction

Sets the language code

<th>

This tag defines a table header cell in a table. The text within the <th> element usually renders in bold. The “bgcolor”, “height”, “width”, and “nowrap” attributes of the <th> element are not supported in XHTML 1.0 Strict DTD.

The following attributes are supported:

Attribute Value/s Description

abbr abbr_text Specifies an abbreviated version

of the content in a cell

align left

right center justify char

Specifies the horizontal alignment of cell content

axis category_names Defines a name for a cell bgcolor rgb(x,x,x)

#xxxxxx colorname

char character Specifies which character to align

charoff Pixels (number, EX: “30” )

class class_rule

style_rule

colspan number Indicates the number of columns

dir ltr (left to right)

rtl (left to right)

Specifies the background color of the table cell. Deprecated. Use styles instead.

text on. Note: Only used if align="char"

Specifies the alignment offset to the first character to align on, in pixels or a percentage.

Note: Only used if align="char" The class of the element

this cell should span. Sets the text direction

3 - 9

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Attribute Value/s Description

headers header_cells'_id A space-separated list of cell IDs

height Pixels (number, EX: “30” ) Specifies the height of the table

id unique_name Defines a unique name for the

that supply header information for the cell. This attribute allows text-only browsers to render the header information for a given cell.

cell. Deprecated. Use styles instead.

map tag.

lang language_code (Ex: EN, deu/ger,

Sets the language code

hin)

nowrap now rap Whether to disable or enable

automatic text wrapping in this cell. Deprecated. Use styles instead.

rowspan number Indicates the number of rows this

cell should span. title tooltip_text A text to display in a tool tip scope col

colgroup row rowgroup

Specifies if this cell provides

header information for the rest of

the row that contains it (row), or for

the rest of the column (col), or for

the rest of the row group that

contains it (rowgroup), or for the

rest of the column group that

contains it style style_defi nition An inline style definition valign top

middle

Specifies the vertical alignment of

cell content

bottom baseline

3 - 10

width Pixels (number, EX: “30” )

xml:lang language_code (Ex: EN, deu/ger,

hin)

Specifies the width of the table cell

in pixels or a percentage.

Deprecated. Use styles instead.

Sets the language code

Application Development for the Microbrowser

<tr>

This tag defines a row in a table.

The following attributes are supported:

Attribute Value/s Description

align right

left center justify char

Defines the text alignment in cells.

<td>

This tag defines a cell in a table.

The following attributes are supported:

Attribute Value/s Description

align left

right center justify char

colspan number Indicates the number of columns

rowspan number Indicates the number of rows this

Specifies the horizontal alignment

of cell content

this cell should span.

cell should span.

Note

<thead>

This tag defines a table header. The< thead>, <tfoot> and <tbody> elements enable you to group rows in a table. When you create a table, you might want to have a header row, some rows with data, and a row with totals at bottom. This division enables browsers to support scrolling of table bodies independently of the table header and footer. When long tables are printed, the table header and footer information may be repeated on each page that contains table data.

The <thead> must have a <tr> tag inside. If you use the thead, tfoot and tbody elements, you must use every element. They should appear in this order: <thead>, <tfoot> and <tbody>, so that browsers can render the footer before receiving all the data. You must use these tags within the table element.

3 - 11

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

The following attributes are supported:

Attribute Value/s Description

align right

Defines the text alignment in cells.

left center justify char

char. character Specifies which character to align

text on.

Note: Only used if align="char" charoff Pixels (number, EX: “30” )

Specifies the alignment offset to

the first character to align on, in

pixels or a percentage.

Note: Only used if align="char" valign top

middle

Specifies the vertical text

alignment in cells

bottom baseline

id unique_name Defines a unique name for the

map tag. class class_rule

The class of the element

style_rule

title tooltip_text A text to display in a tool tip

3 - 12

style style_defi nition An inline style definition dir ltr (left to right)

Sets the text direction

rtl (left to right)

lang language_code (Ex: EN, deu/ger,

Sets the language code

hin)

xml:lang language_code (Ex: EN, deu/ger,

Sets the language code

hin)

Application Development for the Microbrowser

<tbody>

This tag defines a table body. The <thead>, < tfoot> and <tbody> elements enable you to group rows in a table.

The following attributes are supported:

Attribute Value/s Description

align right

left center

Defines the text alignment in cells.

<tfoot>

This tag defines a table footer. The <thead>, <tfoot> and <tbody> elements enable you to group rows in a table.

The following attributes are supported:

Attribute Value/s Description

align right

left center justify char

char. character Specifies which character to align

charoff Pixels (number, EX: “30” )

Defines the text alignment in cells.

text on.

Note: Only used if align="char"

Specifies the alignment offset to

the first character to align on, in

pixels or a percentage.

Note: Only used if align="char" valign top

middle bottom baseline

id unique_name Defines a unique name for the

class class_rule

style_rule title tooltip_text A text to display in a tool tip style style_defi nition An inline style definition

Specifies the vertical text alignment in cells

map tag. The class of the element

3 - 13

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Attribute Value/s Description

dir ltr (left to right)

lang language_code (Ex: EN, deu/ger,

xml:lang language_code (Ex: EN, deu/ger,

Meta Information Tags

The following meta information tags are supported:

• <head>—Defines information about the document

<head>

The head element can contain information about the document. The browser does not display the “head information” to the user. The following tag can be in the head section: <title>.

No attributes are supported.

Note

Sets the text direction

rtl (left to right)

Sets the language code

hin)

Sets the language code

hin)

Due to space constraints, there isn’t a static title bar at the top of the Microbrowser window, as there is in most other browsers. The title is displayed in large bold text in the first line of the page, and is scrolled off the screen as the focus is moved down the page.

HTTP Support

Note

3 - 14

The Microbrowser is a fully compliant HTTP/1.1 user agent:

• It supports:

— Cookies

Cookies are stored in the flash file system; they are preserved when the phone reboots or is reconfigured. Cookies are shared between the idle display Microbrowser and the main Microbrowser.

— Refresh headers

— HTTP proxies

— HTTPS over SSL/TLS

— Custom CA certificates

• There are the following exceptions:

SoundPoint IP 430

SoundPoint IP 650

SoundPoint IP 450

SoundStation IP 4000

— There is no sophisticated caching. The HTML cache refresh META tag

is not supported.

— Any images in the body of a document with the same URL are

assumed to be the same image. The image is loaded from the Microbrowser’s memory instead of making another request to the server.

— When a new page is requested, the Microbrowser’s internal memory

is cleared and all components of the new page are downloaded from the server.

For more information on CA certificates, refer to “Technical Bulletin 17877: Using Custom Certificates With SoundPoint IP Phones“at

http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_T echnical_Bulletins_pub.html .

Microbrowser User Interface

Application Development for the Microbrowser

Two instances of the Microbrowser may run concurrently:

• An instance with standard interactive user interface

3 - 15

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

SoundPoint IP 430

SoundPoint IP 450

SoundStation IP 7000SoundPoint IP 650

• An instance that does not support user input, but appears in a window on the idle display

Launching the Microbrowser

Navigation and Form Editing

The first time the Applications key is pressed, the main Microbrowser loads the home page specified in the Subsequent presses of the Applications key simply toggle between the Microbrowser and SIP telephony applications. The active page remains loaded in memory when you toggle.

Whenever there is an event in the telephony application that requires the user's attention, the telephony application is brought to the foreground automatically.

The Microbrowser can be displayed again by simply pushing the Applications key. While the Microbrowser application is not displayed, it is still active and pending transactions will complete in the background and be immediately visible when the browser is brought to the foreground.

The user navigates through pages by moving the focus among the focusable items with the up and down arrow keys. Focusable items include links, form elements, and buttons. The focus moves between all focusable items on a page in the order that they appear in the XHTML source, including tables. For newly displayed pages, the focus will automatically move to the first focusable item visible on the current page.

mb.main.home

configuration parameter.

3 - 16

Application Development for the Microbrowser

When the user has focused on a link that they would like to follow, or a form element they would like to toggle, they press the Select key. This will either generate a request for the linked page or toggle the selection of an element in the form. When the focus moves to fields which are editable, the user may simply enter text at will, then move the focus to the next selectable item when complete using the up and down arrow keys. If there is a large area of the page without a focusable element, the page is only scrolled by one screen for each push of the arrow key.

To submit form data, navigate to and select a submit button on the page or press the Submit soft key when available.

The Back soft key takes the user to the previous page viewed. The left arrow key performs a similar function unless the user is editing a text field. The Refresh and Home soft keys behave in the expected manner, reloading the current page and reloading to the phone's home page respectively.

Text is entered into text boxes using the dial pad through the same entry method used elsewhere on the phone. When editing text, a soft key allows the user to cycle through uppercase letter, lowercase letter or numeric entry modes. A Cancel soft key is available to undo the current edits.

Idle Display Microbrowser

The idle display Microbrowser is independent of the main Microbrowser, but is capable of rendering the same content. Its home page is configured via the

mb.idleDisplay.home

Microbrowser does not accept any user input and will only appear when the user has no phone calls in progress and the phone is in the idle user interface state. The idle display Microbrowser can update its content based on a configurable refresh timer or by honoring the value of the Refresh header.

configuration parameter. The idle display

Developing an XHTML Application

This section provides information on:

• Changing Configuration Parameters

• Sample Applications

3 - 17

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Changing Configuration Parameters

Create a new configuration file in the style of sip.cfg so that users will connect to your application when they press the Application key (or select the Application feature item).

Note

For more information on why to create another configuration file, refer to the “Configuration File Management on SoundPoint IP Phones” whitepaper at

www.polycom.com/support/voice/ .

To allow an application to be run from the Microbrowser:

1. Open a new configuration file in an XML editor.

2. Add the Microbrowser <mb> parameter.

3. Set

mb.proxy

to the address of the desired HTTP proxy to be used by the

Microbrowser.

For example,

mb.proxy=10.11.32.103:8080

where 10.11.32.103 is proxy server IP address and 8080 is the port number.

4. Set

mb.idleDisplay.home

to the URL used for Microbrowser idle

display home page.

For example,

mb.idleDisplay.home=http://10.11.32.128:8080/sampleapps/idle

5. Set

mb.idleDisplay.refresh

to the period in seconds between refreshes

of the idle display Microbrowser's content.

For example,

6. Set

mb.main.home

mb.idleDisplay.refresh=10

to the URL used for Microbrowser home page.

3 - 18

For example,

mb.main.home=http://10.11.32.128:8080/sampleapps/login

7. Set

mb.limits.nodes

to the maximum number of tags that the XML

parser will handle.

For example,

8. Set

mb.limits.cache

mb.limits.nodes= 256

to the maximum total size of objects (KB)

downloaded for each page (both XHTML and images).

For example,

mb.limits.cache= 200

9. (Optional.) If you are including HTTP URL push messages in your application, do the following:

a Set

apps.push.messageType

For example,

apps.push.messageType

to the appropriate display priority.

Application Development for the Microbrowser

b Set

apps.push.serverRootURL

to the application server root URL.

For example,

apps.push.serverRootURL

c Set

apps.push.username

For example,

apps.push.username

=http://172.24.128.85:8080/sampleapps

to the appropriate username.

=bob

The username and password are required to authenticate incoming push requests to the phone.

d Set

e Verify that

apps.push.password

For example,

apps.push.password

httpd.enabled

to the appropriate password.

=1234

is set to 1 (the web server is enabled).

10. (Optional.) If you are including telephone event notifications in your application, do the following:

a Set

apps.telNotification.URL

to the location where notifications

should be sent.

For example,

apps.telNotification.URL

=http://172.24.128.85:8080

If this URL is set to Null, the notifications events will not be sent.

b Set

apps.telNotification.incomingEvent

to 1 or 0 (for Enable or

Disable respectively).

For example,

c Set

apps.telNotification.outgoingEvent

apps.telNotification.incomingEvent

to 1 or 0 (for Enable or

Disable respectively).

For example,

d Set

apps.telNotification.offhookEvent

apps.telNotification.outgoingEvent

to 1 or 0 (for Enable or

Disable respectively).

For example,

e Set

apps.telNotification.onhookEvent

apps.telNotification.offhookEvent

to 1 or 0 (for Enable or

Disable respectively).

For example,

apps.telNotification.onhookEvent

11. (Optional.) If you are including phone state polling requests in your application, do the following:

a Set

apps.statePolling.URL

to the location where requested

information should be sent.

For example,

apps.statePolling.URL

=http://172.24.128.85:8080

If this URL is set to Null, the requested information will not be sent.

3 - 19

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Note

b Set

apps.statePolling.username

For example,

apps.statePolling.username

to the appropriate username.

=bob

The username and password are required to authenticate incoming polling requests to the phone.

c Set

Setting address to the user agent header field in all HTTP messages sent by the phone.

apps.statePolling.password

For example,

sec.tagSerialNo

apps.statePolling.password

in sip.cfg will cause the phone to append its MAC

to the appropriate password.

=****

12. Save your changes and close the XML editor.

13. Add the new file to the master configuration file’s CONFIG_FILES list in

the appropriate order. (The files are processed in the order listed—left to right. The parameter found first in the list of files will be the one that is effective.)

For more information on configuration parameters, refer to the latest Administrator’s Guide for the SoundPoint IP / SoundStation IP / VVX Family at

http://www.polycom.com/support/voicedocumentation/.

Sample Applications

This section presents three sample applications that you can use as a starting point for writing your own application.

• Static XHTML Application

• Dynamic XHTML Application

• SoundPoint IP/SoundStation IP/VVX XML API Application

Static XHTML Application

To develop a static XHTML application:

1. Create a

Sample.xhtml

page with static information to be displayed.

In this case, the static information will be "Hello World!".

<html> <head> <title>Sample Application</title> </head> <body> <p>HelloWorld!</p> </body>

3 - 20

Application Development for the Microbrowser

</html>

2. Configure the Web server to serve the above XHTML file.

For example, if you are using Apache Tomcat to try this example, then put this file into the

webapps\PLCM

folder of Tomcat.

3. Configure SoundPoint IP and SoundStation IP phones to point to the XHTML file in the sip.cfg configuration file.

Note

For this example, change

http://<WEBSERVER_ADDRESS:PORT>/PLCM/Sample.xhtml

mb.main.home

4. Reboot the phones.

5. On a SoundPoint IP phone, press the Applications (or Services) key.

The text “Hello World!” appears on the graphic display.

Static XHTML applications can be developed using any Web server. Even though Tomcat is used in the example, the developer is free to use any Web server.

Dynamic XHTML Application

To develop a dynamic XHTML application:

1. Create a

AddStock.xhtml

page.

This XHTML page is designed for getting a stock symbol as input from the SoundPoint IP or SoundStation IP phone, then retrieve the information for this stock symbol.

<html xmlns="http://www.w3.org/1999/xhtml"> <!- - HEADER START - -> <head> <title>Stocks</title> </head> <!- - HEADER END - -> <!- - BODY START - -> <body> <!- - ADD STOCK FORM START - -> <form method="POST" action="GetQuote.jsp"> <p>Symbol<input type="text" name="stockname"/> <input type="submit" value="Get Quote"/></p> </form> <!- - ADD STOCK FORM END - -> </body> <!- - BODY END - -> </html>

3 - 21

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

2. Configure the Web server to serve the above XHTML file.

For example, if you are using Apache Tomcat to try this example, put this file into the

webapps\PLCM

folder of Tomcat.

3. Write an application that is going to retrieve the stock information from a data service provider.

For this example, this application will be retrieving stock information from Yahoo and will send it to the Microbrowser. This application is written using a Java Server Page (JSP). Name the file GetQuote.jsp .

Note

Care should be taken as the lines of code shown below may have wrapped. If you cut and paste these lines, they may contain new-lines where there should not be. Check for valid code before executing.

<?xml version="1.0" encoding="iso-8859-1"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <%@page import="java.io.File,java.io.IOException,java.net.URL,java.awt.image.B ufferedImage,javax.imageio.ImageIO"%> <html> <head> <title>Stock Quote</title> </head> <body> <% // GETTING THE PATH WHERE BMP FILE HAS TO BE SAVED String bmpFilePath = application.getRealPath(File.separator) + "quote.bmp"; // DEFINE URL FROM WHERE CONTENT TO BE RETRIEVED String stockUrl = "http://ichart.yahoo.com/t?s="; // RETRIEVE THE STOCK SYMBOL FROM REQUEST String stockSymbol = "PLCM"; // DEFAULT TO PLCM if ( request.getParameter("stockname") != null ) { stockSymbol = request.getParameter("stockname"); } readAndConvertContentToBmp(stockUrl + stockSymbol, bmpFilePath, stockSymbol); %> <%! // READ THE CONTENT FROM GIVEN URL AND THEN CONVERT THE CONTENT TO A BMP FILE private void readAndConvertContentToBmp(String a_stockUrl, String a_filePath, String a_name) throws IOException { try { BufferedImage stockImage = ImageIO.read(new URL(a_stockUrl)); ImageIO.write(stockImage, "bmp", new File(a_filePath)); }

3 - 22

Application Development for the Microbrowser

catch (IOException ex) { throw ex;} } %>  <img src="quote.bmp"/>  </body> </html>

4. Configure the Web server to deploy the above JSP file.

For example, if you are using Apache Tomcat to try this example, put this file into the

webapps\PLCM

folder of Tomcat.

5. Configure SoundPoint IP and SoundStation IP phones to point to the XHTML file in the sip.cfg configuration file.

Note

For this example, change

http://<WEBSERVER_ADDRESS:PORT>/PLCM/AddStock.xhtml

mb.main.home

6. Reboot the phones.

7. On a SoundPoint IP phone, press the Applications (or Services) key.

The

AddStock.xhtml

appears on the graphic display.

8. Enter a stock symbol, then select the Get Quote soft key.

The stock quote for the entered stock symbol appears on the graphic display.

Dynamic XHTML applications can be developed using any Web server. Even though Tomcat is used in the example, the developer is free to use any Web server.

Dynamic XHTML applications can be developed using any Web technologies—for example, ASP.net, Java Servlets, Java Server Pages, CGI-PERL, and PHP.

SoundPoint IP/SoundStation IP/VVX XML API Application

Refer to SoundPoint IP/SoundStation IP/VVX XML API Application Interface on page 2-1.

This example uses a Telephone Integration URI:

• This is an ASP.NET sample for an IIS Server.

3 - 23

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

• A customer is browsing a company’s web site on the internet. They come upon this web page (http://A_Web_Site/WebCallback.aspx), and enter their name and phone number as shown below.

• After the customer clicks Send Request, the page shown below is pushed to the customer support agent’s phone.

3 - 24

The customer support agent can call the customer by just pressing the Select key, because the highlighted link contains a Tel URI with the customer’s phone number.

To develop an XML API application:

1. Using an integrated development environment (IDE) of your choice,

create a file called

<%@ Page Language="C#" AutoEventWireup="true" CodeFile="WebCallback.aspx.cs" Inherits="WebCallback" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

webcallback.aspx

Application Development for the Microbrowser

<html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>Web Call Back Request</title> </head> <body> <form id="form1" runat="server"> <div> Please Enter Your Name and Phone # to Ask an Agent to Call Back Immediately:<br /> <br /> Name:<br /> <asp:TextBox ID="BoxName" runat="server" Height="23px" Width="192px"></asp:TextBox><br /> <br /> Phone #<br /> <asp:TextBox ID="BoxNumber" runat="server" Height="22px" Width="192px"></asp:TextBox><br /> <br /> <asp:Button ID="Button1" runat="server" Height="30px" OnClick="Button1_Click" Text="Send Request" Width="162px" /></div> </form> </body> </html>

2. Using the IDE of your choice, create a file called

using System; using System.IO; using System.Text; using System.Data; using System.Configuration; using System.Net; using System.Web; using System.Web.Security; using System.Web.UI; using System.Web.UI.WebControls; using System.Web.UI.WebControls.WebParts; using System.Web.UI.HtmlControls; using System.Threading;

public partial class WebCallback : System.Web.UI.Page { public static ManualResetEvent allDone = new ManualResetEvent(false); protected void Page_Load(object sender, EventArgs e) {

}

protected void Button1_Click(object sender, EventArgs e)

webcallback.aspx.cs

3 - 25

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

{ String phoneNum = BoxNumber.Text ; String name = BoxName.Text;

//send a push request to the phone with the IP address

//NOTE: Change this hardcoded IP address

callbackReq("172.18.103.32", phoneNum, name);

}

private void callbackReq(String phoneIP, String phoneNum, String name) { String strLoc = "http://" + phoneIP + "/push"; String[] cred = { "Polycom", "456" };

NetworkCredential myCred = new NetworkCredential(cred[0], cred[1]);

CredentialCache myCache = new CredentialCache();

myCache.Add(new Uri(strLoc), "Digest", myCred);

string result = "";

// Create the web request HttpWebRequest request = (HttpWebRequest)WebRequest.Create(strLoc);

WebRequestState myRequestState = new WebRequestState(); myRequestState.request = request;

request.Method = "POST"; request.Credentials = myCache;

myRequestState.createPostData(phoneNum, name);

IAsyncResult r = (IAsyncResult)request.BeginGetRequestStream( new AsyncCallback(ReadCallback), myRequestState);

allDone.WaitOne();

// Get response HttpWebResponse response = (HttpWebResponse)request.GetResponse();

3 - 26

// Get the response stream StreamReader reader = new StreamReader(response.GetResponseStream());

Application Development for the Microbrowser

// Read the whole contents and return as a string result = reader.ReadToEnd();

reader.Close(); response.Close();

}

private static void ReadCallback(IAsyncResult asynchronousResult) {

WebRequestState myRequestState = (WebRequestState)asynchronousResult.AsyncState; WebRequest myWebRequest = myRequestState.request;

// End the Asynchronus request. Stream streamResponse = myWebRequest.EndGetRequestStream(asynchronousResult);

byte[] byteArray = Encoding.UTF8.GetBytes(myRequestState.getPostData());

// Write the data to the stream. streamResponse.Write(byteArray, 0, byteArray.Length); streamResponse.Close(); allDone.Set(); }

}

public class WebRequestState { public String postData = null;

public WebRequest request; public WebRequestState() { request = null; }

public String getPostData() { return postData; }

public void createPostData(String phoneNum, String name) { postData = "<PolycomIPPhone><Data Priority=\"critical\">" +

3 - 27

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

"<title>Customer Web Call Back Request</title>" + " <h1>Customer Name : " + name + " </h1> <br></br>" + "<a href=\"tel://" + phoneNum + ";Line1\">Callback to Customer</a>" + "</Data></PolycomIPPhone>";

} }

3. Configure the IIS Web server to deploy the above files.

4. Change the sip.cfg configuration file as follows:

a Set

b Set

The phone’s IP address is hardcoded in

apps.push.username apps.push.password

to Polycom.

to 456.

webcallback.aspx.cs

172.18.103.32 for this example. You must change this to another value. Refer to note in code.

5. Reboot the phone.

After a customer enters their name and phone number on the web page, the Customer Web Call Back Request page appears on the phone with IP address hardcoded in the webcallback.aspx.cs file.

3 - 28

Application Development for the Browser

This chapter presents an overview on how to develop an XHTML application that can be run on the Web Server and the Browser of the Polycom VVX 1500 phone. It also describes the relevant configuration parameters that can be found in the sip.cfg configuration file.

This chapter contains information on:

• Supported Standards

• HTTP Support

• Browser User Interface

• Setting Up the Polycom SDK

• Developing an XHTML Application

To troubleshoot any problems with your applications, refer to

Troubleshooting on page 5-1.

Note

Polycom is not responsible for troubleshooting any programming that you create for the Browser.

Supported Standards

The Browser supports true Web 2.0 applications with the following features:

• XHTML 1.1. (XHTML 1.0 is supported but not recommended.)

• HTML 4.01 with partial support for HTML 5. No support for media

player.

• CCS 2.1 with partial support for CCS 3.0. No support for the new white-space values pre-wrap and pre-line.

4 - 1

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

• SVG 1.1 (partial support)

• JavaScript. Supports ECMA-262 with extensions.

• XMLHttpRequest

• DOM

• HTTP 1.1

HTTP Support

The Browser is a fully compliant HTTP/1.1 user agent as described in RFC 2616. For more information, refer to

http://www.ietf.org/rfc/rfc2616.txt?number=2616.

• It supports:

— Cookies

Note

Cookies are stored in the flash file system; they are preserved when the phone reboots or is reconfigured. Cookies are shared between the idle display Browser and the main Browser.

— Refresh headers

— HTTP proxies

— HTTP by HTTP over TLS

The Browser will support the TLS protocol v1 only. It is not backward compatible with SSL v2 or SSL v3.

— Custom CA certificates

For more information on CA certificates, refer to “Technical Bulletin 17877: Using Custom Certificates With SoundPoint IP Phones“ at

http://www.polycom.com/usa/en/support/voice/soundpoint_ip/VoIP_T echnical_Bulletins_pub.html .

Browser User Interface

4 - 2

Note

The screenshots of the Polycom VVX 1500 phone shown below display Polycom’s My Info Portal.

Application Development for the Browser

Two instances of the Browser may run concurrently:

• An instance with standard interactive user interface

Note

• An instance that does not support user input, but appears in a window on

Launching the Browser

The interactive browser runs in full screen mode only.

the idle display

By default, when you press the App key on the Polycom VVX 1500, the Application Launch Pad appears. You must add a new Launch Pad item to the microbrowser configuration parameters—

mb.main.x.text— f

and

or the main Browser to be loaded.

mb.main.x.url, mb.main.x.icon

4 - 3

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

If the Application Launch Pad is disabled— set—and you press the App key on the Polycom VVX 1500, the main Browser loads the home page specified in the Subsequent presses of the App key simply toggle between the Browser and SIP telephony applications. The browser title bar shows a progress indicator when the page is loading.

Whenever there is an event in the telephony application that requires the user's attention, the telephony application is brought to the foreground automatically.

The Browser can be displayed again by simply pushing the App key. While the Browser application is not displayed, it is still active and pending transactions will complete in the background and be immediately visible when the browser is brought to the foreground.

Navigation and Form Editing

The user navigates in the Browser as they would in any major web browser. The navigation keys on the Polycom VVX 1500 can be used to scroll the web page up, down, left, and right. There is an on-screen navigation cluster that performs in the same manner.

The toolbar shows the following buttons:

• Home

mb.LaunchPad.enabled

mb.main.home

configuration parameter.

Note

• Stop/Refresh (depending on whether the page has completely downloaded yet)

• Keyboard pop-up (when focus is on an input widget)

• Navigation (Up, down, left, and right buttons appear only if scrolling is

available in those directions)

Holding down the navigation keys speeds up scrolling.

• Exit

• Encoding (Ascii, Cyrillic, Katakana, Latin, and Unicode)

• Text entry mode (123, ABC, abc, and Abc)

Form editing in the Browser is performed as in any major web browser. When the focus is on an input field and the keyboard is invoked such that the input field is vertically centered in the top portion of the screen, the keyboard widget displays in the lower portion of the screen. The keyboard is removed from the screen once the user “clicks” on the screen. This allows the user to click the Submit button next to the entry field without closing the keyboard widget.

4 - 4

Idle Display Browser

The idle display browser is independent of the main Browser, but is capable of rendering the same content. Its home page is configured via the

mb.idleDisplay.home

does not accept any user input and will only appear when the user has no phone calls in progress and the phone is in the idle user interface state.

Setting Up the Polycom SDK

The Polycom SDK 1.0 is set of tools to assist you in developing XML API/XHTML applications for the Polycom VVX 1500 phone, providing a simulation of a Polycom VVX 1500 with both the main and idle browsers. It can be used to test basic call functionality (by using SIP signalling). (Audio/video support (RTP functionality) is not supported.)

The Polycom SDK 1.0 is available from

http://www.polycom.com/support/voice/sdk and can be installed in on

any computer running Microsoft® Windows® XP Professional, SP3 and Microsoft Windows Server 2003 Standard edition, SP2.

Application Development for the Browser

configuration parameter. The idle display browser

Note

If the computer where the SDK is to be run is already running a web server, it should be shut down before using the SDK.

The VVX 1500 simulator uses port 80. If any existing applications on the computer are using port 80, they should be shut down.

The setup.exe executable will install three components:

• The VVX 1500 simulator

• The XML API Web Testing Tool (optional)

• The XML API Standalone Testing tool (optional)

To start using the SDK, start the VVX 1500 simulator by selecting Start > Polycom > SDK > VVX 1500 Simulator > Start.

For more information, refer to the documentation provided with the Polycom SDK installation.

Developing an XHTML Application

This section provides information on:

• Changing Configuration Parameters

• Sample Applications

4 - 5

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Changing Configuration Parameters

Create a new configuration file in the style of sip.cfg so that users will connect to your application when they press the Application key (or select the Application feature item).

Note

For more information on why to create another configuration file, refer to the “Configuration File Management on SoundPoint IP Phones” whitepaper at

www.polycom.com/support/voice/ .

To allow an application to be run from the Browser:

1. Open a new configuration file in an XML editor.

2. Add the Microbrowser <mb> parameter.

3. Set

mb.proxy

to the address of the desired HTTP proxy to be used by the

Browser.

For example,

mb.proxy=10.11.32.103:8080

where 10.11.32.103 is proxy server IP address and 8080 is the port number.

4. Set

mb.idleDisplay.home

to the URL used for the Browser idle display

home page.

For example,

mb.idleDisplay.home=http://10.11.32.128:8080/sampleapps/idle

5. Set

mb.idleDisplay.refresh

to the period in seconds between refreshes

of the idle display Browser’s content.

For example,

6. Set

mb.main.home

mb.idleDisplay.refresh=10

to the URL used for the Browser home page.

4 - 6

For example,

mb.main.home=http://10.11.32.128:8080/sampleapps/login

7. Set

mb.limits.nodes

to the maximum number of tags that the XML

parser will handle.

For example,

8. Set

mb.limits.cache

mb.limits.nodes= 256

to the maximum total size of objects (KB)

downloaded for each page (both XHTML and images).

For example,

mb.limits.cache= 200

9. (Optional.) If you are including HTTP URL push messages in your application, do the following:

a Set

apps.push.messageType

For example,

apps.push.messageType

to the appropriate display priority.

Application Development for the Browser

b Set

apps.push.serverRootURL

to the application server root URL.

For example,

apps.push.serverRootURL

c Set

apps.push.username

For example,

apps.push.username

=http://172.24.128.85:8080/sampleapps

to the appropriate username.

=bob

The username and password are required to authenticate incoming push requests to the phone.

d Set

e Verify that

apps.push.password

For example,

apps.push.password

httpd.enabled

to the appropriate password.

=1234

is set to 1 (the web server is enabled).

10. (Optional.) If you are including telephone event notifications in your application, do the following:

a Set

apps.telNotification.URL

to the location where notifications

should be sent.

For example,

apps.telNotification.URL

=http://172.24.128.85:8080

If this URL is set to Null, the notifications events will not be sent.

b Set

apps.telNotification.incomingEvent

to 1 or 0 (for Enable or

Disable respectively).

For example,

c Set

apps.telNotification.outgoingEvent

apps.telNotification.incomingEvent

to 1 or 0 (for Enable or

Disable respectively).

For example,

d Set

apps.telNotification.offhookEvent

apps.telNotification.outgoingEvent

to 1 or 0 (for Enable or

Disable respectively).

For example,

e Set

apps.telNotification.onhookEvent

apps.telNotification.offhookEvent

to 1 or 0 (for Enable or

Disable respectively).

For example,

apps.telNotification.onhookEvent

11. (Optional.) If you are including phone state polling requests in your application, do the following:

a Set

apps.statePolling.URL

to the location where requested

information should be sent.

For example,

apps.statePolling.URL

=http://172.24.128.85:8080

If this URL is set to Null, the requested information will not be sent.

4 - 7

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Note

b Set

apps.statePolling.username

For example,

apps.statePolling.username

to the appropriate username.

=bob

The username and password are required to authenticate incoming polling requests to the phone.

c Set

Setting address to the user agent header field in all HTTP messages sent by the phone.

apps.statePolling.password

For example,

sec.tagSerialNo

apps.statePolling.password

in sip.cfg will cause the phone to append its MAC

to the appropriate password.

=****

12. Save your changes and close the XML editor.

13. Add the new file to the master configuration file’s CONFIG_FILES list in

the appropriate order. (The files are processed in the order listed—left to right. The parameter found first in the list of files will be the one that is effective.)

For more information on configuration parameters, refer to the latest Administrator’s Guide for the SoundPoint IP / SoundStation IP / VVX Family at

http://www.polycom.com/support/voicedocumentation/.

Sample Applications

Note

Refer to SoundPoint IP/SoundStation IP/VVX XML API Application Interface on page 2-1.

This section presents a sample application (PDF attachment mip3.zip) that you can use as a starting point for writing your own application.

Polycom recommends that you use Adobe Reader 8 or 9 to view this guide and the attachments. Click on the paperclip icon on the left-hand side to view the attachment mip3.zip .

4 - 8

Troubleshooting

This chapter presents problems, likely causes, and corrective actions. Problems are grouped as follows:

• XML Errors

If you still need assistance, contact your system administrator.

XML Errors

Symptom Problem Corrective Action

Improperly formatted tables could cause the phone to stop and restart or display the error “XML Error (17,75) mismatched tag”.

A table tag was improperly formatted.

Correct the improperly formatted table.

5 - 1

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

5 - 2

Appendix

This appendix provides information on XHTML elements that are not supported by the Microbrowser.

Unsupported XHTML Elements

The unsupported elements and attributes are:

Tag Type Tag Description Basic Tags <html>—Defines HTML document.

<body>—Defines documents’ body. <h1> to <h6>—Defines header 1 to header 6. <p>—Defines a paragraph. <br>—Inserts a single line break. <hr>—Defines a horizontal rule.

A - 1

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Tag Type Tag Description Character Format Tags <b>—Defines bold text.

<font>—Deprecated. Defines text font, size, and color. <i>—Defines italic text. <em>—Defines emphasized text. <big>—Defines big text. <strong>—Defines strong text. <small>—Defines small text. <sup>—Defines superscripted text. <sub>—Defines subscripted text. <bdo>—Defines the direction of text display. <u>—Deprecated. Defines underlined text.

Output Tags <pre>—Defines preformatted text.

<code>—Defines computer code text. <tt>—Defines teletype text. <kbd>—Defines keyboard text. <var>—Defines a variable. <dfn>—Defines a definition term. <samp>—Defines sample computer code. <xmp>—Deprecated. Defines preformatted text.

Block Tags <acronym>—Defines an acronym.

<abbr>—Defines an abbreviation. <address>—Defines an address element. <blockquote>—Defines a long quotation. <center>—Deprecated. Defines centered text. <q>—Defines a short quotation. <cite>—Defines a citatio n. <ins>—Defines inserted text. <del>—Defines deleted text. <s>—Deprecated. Defines strikethrough text.

A - 2

<strike>—Deprecated. Defines strikethrough text.

Tag Type Tag Description Link Tags <a>—Defines an anchor.

The following attributes are not supported: charset, coords, hreflang, rel, rev, shape, target, type, id, class, title, style, dir, lang, xml:lang, tabindex, and accesskey.

Frame Tags <frame> — Defines a sub window (frame).

<frameset>—Defines a set of frames. <noframes>—Defines a noframe section. <iframe>—Defines an inline sub window (frame).

Input Tags <form>—Defines a form.

The following attributes are not supported: accept, accept charset, enctype, target, class, id, style, title, dir, lang, and accesskey.

<input>—Defines an input field. The following attributes are not supported: accept, align,

alt, disabled, maxlength, readonly, size, arc, type:button, type:file, type:image, class, is, style, title, dir, lang, accesskey.

Appendix

<textarea>—Defines a text area . <button>—Defines a push button. <select>—Defines a selectable list. <optgroup>—Defines an option group. <option>—Defines an item in a list box. <label>—Defines a label for a form control. <fieldset>—Defines a fieldset. <legend>—Defines a title in a fieldset. <isindex>—Deprecated. Defines a single-line input

field.

A - 3

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Tag Type Tag Description List Tags <ul>—Defines an unordered list.

<ol>—Defines an ordered list. <li>—Defines a list item. <dir>—Deprecated. Defines a directory list. <dl>—Defines a definition list. <dt>—Defines a definition term. <dd>—Defines a definition description. <menu>—Deprecated. Defines a menu list.

Image Tags <img>-Defines an image.

The following attributes are not supported: alt, align, border, hspace, ismap, longdesc, usemap, vspace, id, class, title, style, xml:lang, and lang

<map>—Defines an image map. <area>—Defines an area inside an image map.

Table Ta gs <table>—Defines a table.

The following atrributes are not supported: bgcolor, frame, rules, summary, id, class, title, style, dir, lang, and xml:lang.

<col>—Defines attributes for table columns. <tr>—Defines a table row.

The following attributes are not supported: bgcolor, cahr, charoff, valign, id, class, title, style, dir, lang, and xml:lang.

<td>—Defines a table cell. The following attributes are not supported: abbr, axis,

bgcolor, char, charoff, headers, height, nowrap, scope, valign, width, id, class, title, style, dir, lang, and xml:lang.

<tbody>—Defines a table body. The following attributes are not supported: align:justify,

align:char, char, charoff, valign, id, class, title, style, dir, lang, and xml:lang.

<colgroup>—Defines groups of table columns.

Style Tags <style>—Defines a style definition.

<div>—Defines a section in a document.

A - 4

<span>—Defines a section in a document.

Appendix

Tag Type Tag Description Meta Information Tags <head>—Defines information about the document.

No attributes are supported. <title>—Defines the document title. <meta>—Defines meta information <base>—Defines a base URL for all the links in a page <basefont>—Deprecated. Defines a base font

Programming Tags <script>—Defines a script

A - 5

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

A - 6

Third Party Software

This appendix provides the copyright statements for third party software products that are part of the application programs that run on Polycom SoundPoint IP, SoundStation IP, and VVX 1500 phones.

Product License Location

c-ares c-ares on page D-2 curl curl on page D-3 eXpat eXpat on page D-9 ILG JPEG IJG JPEG on page D-9

libMng libMng on page D-10 libPng libPng on page D-11 libSRTP libSRTP on page D-13 libssh2 libssh2 on page D-13 OpenLDAP OpenLDAP on page D-14 OpenSSL OpenSSL on page D-15 zlib zlib on page D-18

This appendix provides the copyright statements for third party software products that are part of the application programs that run on Polycom VVX 1500 phones only.

Product License Location

BusyBox Refer to the “Polycom Voice OF FER of Source for GPL

and LGPL Software” dhcp dhcp 4.0.0-14 on page D-3 droidfonts droidfonts on page D-5 Dropbear Dropbear on page D-4

D - 1

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

Product License Location

glibc Refer to the “Polycom Voice OFFER of Source for GPL

and LGPL Software” libstdc++ Refer to the “Polycom Voice OFFER of Source for GPL

and LGPL Software” Linux kernel Refer to the “Polycom Voice OFFER of Sour ce fo r GP L

and LGPL Software” module-init-tools Refer to the “Polycom Voice OFFER of Source for GPL

and LGPL Software” mtd-utils Refer to the “Polycom Voice OFFER of Source for GPL

and LGPL Software” ncurses ncurses on page D-14 pmap pmap-29092002 on page D-17 procps Refer to the “Polycom Voice OFFER of Sour ce fo r GP L

and LGPL Software” tsattach Refer to the “Polycom Voice OFFER of Source for GPL

and LGPL Software” tslib Refer to the “Polycom Voice OFFER of Source for GPL

and LGPL Software” udev Refer to the “Polycom Voice OF FER of Source for GPL

and LGPL Software” Webkit Refer to the “Polycom Voi ce OF FER of Source for GPL

and LGPL Software” wrsv-ltt Refer to the “Polycom Voice OFFER of Source for GPL

and LGPL Software”

The “Polycom Voice OFFER of Source for GPL and LGPL Software” is available at

http://downloads.polycom.com/voice/voip/offerForSourceVoiceProducts. html .

c-ares

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of M.I.T. not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission.

D - 2

Third Party Software

M.I.T. makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty.

curl

Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name of a copyright holder shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization of the copyright holder.

dhcp 4.0.0-14

THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Internet Systems Consortium, Inc.

950 Charter Street

Redwood City, CA 94063

<info@isc.org>

D - 3

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

http://www.isc.org/

Dropbear

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

=====

LibTomCrypt and LibTomMath are written by Tom St Denis, and are Public Domain.

=====

sshpty.c is taken from OpenSSH 3.5p1,

"As far as I am concerned, the code I have written for this software can be used freely for any purpose. Any derived versions of this software must be clearly marked as such, and if the derived work is incompatible with the protocol description in the RFC file, it must be called by a name other than "ssh" or "Secure Shell". "

D - 4

=====

loginrec.c

loginrec.h

Third Party Software

atomicio.h

atomicio.c

and strlcat() (included in util.c) are from OpenSSH 3.6.1p2, and are licensed under the 2 point BSD license.

loginrec is written primarily by Andre Lucas, atomicio.c by Theo de Raadt.

strlcat() is (c) Todd C. Miller

=====

Import code in keyimport.c is modified from PuTTY's import.c, licensed as follows:

Portions copyright Robert de Bath, Joris van Rantwijk, Delian Delchev, Andreas Schultz, Jeroen Massar, Wez Furlong, Nicolas Barry, Justin Bradford, and CORE SDI S.A.

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

droidfonts

Apache License

Version 2.0, January 2004

http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.

D - 5

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.

"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to

D - 6

Third Party Software

reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:

1. You must give any other recipients of the Work or Derivative Works a copy of this License; and

2. You must cause any modified files to carry prominent notices stating that You changed the files; and

3. You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and

4. If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an a ddendu m to th e NOTIC E text from th e Work , prov ided t hat su ch additional attribution notices cannot be construed as modifying the License.

You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and

D - 7

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

distribution of the Work otherwise complies with the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

D - 8

Third Party Software

eXpat

Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd and Clark Cooper Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

IJG JPEG

Independent JPEG Group's free JPEG software

This package contains C software to implement JPEG image encoding, decoding, and transcoding. JPEG is a standardized compression method for full-color and gray-scale images.

The distributed programs provide conversion between JPEG "JFIF" format and image files in PBMPLUS PPM/PGM, GIF, BMP, and Targa file formats. The core compression and decompression library can easily be reused in other programs, such as image viewers. The package is highly portable C code; we have tested it on many machines ranging from PCs to Crays.

We are releasing this software for both noncommercial and commercial use. Companies are welcome to use it as the basis for JPEG-related products. We do not ask a royalty, although we do ask for an acknowledgement in product literature (see the README file in the distribution for details). We hope to make this software industrial-quality --- although, as with anything that's free, we offer no warranty and accept no liability.

For more information, contact jpeg-info@jpegclub.org.

Contents of this directory

jpegsrc.vN.tar.gz contains source code, documentation, and test files for release N in Unix format.

jpegsrN.zip contains source code, documentation, and test files for release N in Windows format.

D - 9

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

jpegaltui.vN.tar.gz contains source code for an alternate user interface for cjpeg/djpeg in Unix format.

jpegaltuiN.zip contains source code for an alternate user interface for cjpeg/djpeg in Windows format.

wallace.ps.gz is a PostScript file of Greg Wallace's introductory article about JPEG. This is an update of the article that appeared in the April 1991 Communications of the ACM.

jpeg.documents.gz tells where to obtain the JPEG standard and documents about JPEG-related file formats.

jfif.ps.gz is a PostScript file of the JFIF (JPEG File Interchange Format) format specification.

jfif.txt.gz is a plain text transcription of the JFIF specification; it's missing a figure, so use the PostScript version if you can.

TIFFTechNote2.txt.gz is a draft of the proposed revisions to TIFF 6.0's JPEG support.

pm.errata.gz is the errata list for the first printing of the textbook "JPEG Still Image Data Compression Standard" by Pennebaker and Mitchell.

jdosaobj.zip contains pre-assembled object files for JMEMDOSA.ASM.

If you want to compile the IJG code for MS-DOS, but don't have an assembler, these files may be helpful.

libMng

For the purposes of this copyright and license, "Contributing Authors" is defined as the following set of individuals:

Gerard Juyn

(hopefully some more to come...)

The MNG Library is supplied "AS IS". The Contributing Authors disclaim all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The Contributing Authors assume no liability for direct, indirect, incidental, special, exemplary, or consequential damages, which may result from the use of the MNG Library, even if advised of the possibility of such damage.

Permission is hereby granted to use, copy, modify, and distribute this source code, or portions hereof, for any purpose, without fee, subject to the following restrictions:

1. The origin of this source code must not be misrepresented.

D - 10

2. Altered versions must be plainly marked as such and must not be misrepresented as being the original source.

Third Party Software

3. This Copyright notice may not be removed or altered from any source or altered source distribution.

The Contributing Authors specifically permit, without fee, and encourage the use of this source code as a component to supporting the MNG and JNG file format in commercial products. If you use this source code in a product, acknowledgment would be highly appreciated.

libPng

If you modify libpng you may insert additional notices immediately following this sentence.

This code is released under the libpng license.

libpng versions 1.2.6, August 15, 2004, through 1.2.40, September 10, 2009, are Copyright (c) 2004, 2006-2009 Glenn Randers-Pehrson, and are distributed according to the same disclaimer and license as libpng-1.2.5 with the following individual added to the list of Contributing Authors

Cosmin Truta

libpng versions 1.0.7, July 1, 2000, through 1.2.5 - October 3, 2002, are Copyright (c) 2000-2002 Glenn Randers-Pehrson, and are distributed according to the same disclaimer and license as libpng-1.0.6 with the following individuals added to the list of Contributing Authors

Simon-Pierre Cadieux

Eric S. Raymond

Gilles Vollant

and with the following additions to the disclaimer:

There is no warranty against interference with your enjoyment of the library or against infringement. There is no warranty that our efforts or the library will fulfill any of your particular purposes or needs. This library is provided with all faults, and the entire risk of satisfactory quality, performance, accuracy, and effort is with the user.

libpng versions 0.97, January 1998, through 1.0.6, March 20, 2000, are Copyright (c) 1998, 1999 Glenn Randers-Pehrson, and are distributed according to the same disclaimer and license as libpng-0.96, with the following individuals added to the list of Contributing Authors:

Tom Lane

Glenn Randers-Pehrson

Willem van Schaik

libpng versions 0.89, June 1996, through 0.96, May 1997, are Copyright (c) 1996, 1997 Andreas Dilger Distributed according to the same disclaimer and license as libpng-0.88, with the following individuals added to the list of Contributing Authors:

D - 11

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

John Bowler

Kevin Bracey

Sam Bushell

Magnus Holmgren

Greg Roelofs

Tom Tanner

For the purposes of this copyright and license, "Contributing Authors" is defined as the following set of individuals:

Andreas Dilger

Dave Martindale

Guy Eric Schalnat

Paul Schmidt

Tim Wegner

The PNG Reference Library is supplied "AS IS". The Contributing Authors and Group 42, Inc. disclaim all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The Contributing Authors and Group 42, Inc. assume no liability for direct, indirect, incidental, special, exemplary, or consequential damages, which may result from the use of the PNG Reference Library, even if advised of the possibility of such damage.

Permission is hereby granted to use, copy, modify, and distribute this source code, or portions hereof, for any purpose, without fee, subject to the following restrictions:

1. The origin of this source code must not be misrepresented.

2. Altered versions must be plainly marked as such and must not be misrepresented as being the original source.

3. This Copyright notice may not be removed or altered from any source or altered source distribution.

The Contributing Authors and Group 42, Inc. specifically permit, without fee, and encourage the use of this source code as a component to supporting the PNG file format in commercial products. If you use this source code in a product, acknowledgment is not required but would be appreciated.

Libpng is OSI Certified Open Source Software. OSI Certified Open Source is a certification mark of the Open Source Initiative.

D - 12

Glenn Randers-Pehrson

glennrp at users.sourceforge.net

September 10, 2009

Third Party Software

libSRTP

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this

list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

* Neither the name of the Cisco Systems, Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

libssh2

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this

list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

Neither the name of the copyright holder nor the names of any other contributors may be used to endorse or promote products derived from this software without specific prior written permission.

D - 13

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

ncurses

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, distribute with modifications, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished - to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Except as contained in this notice, the name(s) of the above copyright holders shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization.

OpenLDAP

The OpenLDAP Public License

Version 2.8, 17 August 2003

Redistribution and use of this software and associated documentation ("Software"), with or without modification, are permitted provided that the following conditions are met:

D - 14

Third Party Software

1. Redistributions in source form must retain copyright statements and

notices,

2. Redistributions in binary form must reproduce applicable copyright

statements and notices, this list of conditions, and the following disclaimer in the documentation and/or other materials provided with the distribution, and

3. Redistributions must contain a verbatim copy of this document.

The OpenLDAP Foundation may revise this license from time to time.

Each revision is distinguished by a version number. You may use this Software under terms of this license revision or under the terms of any subsequent revision of the license.

THIS SOFTWARE IS PROVIDED BY THE OPENLDAP FOUNDATION AND ITS CONTRIBUTORS ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OPENLDAP FOUNDATION, ITS CONTRIBUTORS, OR THE AUTHOR(S) OR OWNER(S) OF THE SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The names of the authors and copyright holders must not be used in advertising or otherwise to promote the sale, use or other dealing in this Software without specific, written prior permission. Title to copyright in this Software shall at all times remain with copyright holders.

OpenLDAP is a registered trademark of the OpenLDAP Foundation.

OpenSSL

The OpenSSL toolkit stays under a dual license, i.e. both the conditions of the OpenSSL License and the original SSLeay license apply to the toolkit. See below for the actual license texts. Actually both licenses are BSD-style Open Source licenses. In case of any license issues related to OpenSSL please contact openssl-core@openssl.org. OpenSSL License Copyright (c) 1998-2008 The OpenSSL Project. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

D - 15

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

3. All advertising materials mentioning features or use of this software must display the following acknowledgment: "This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)"

4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact openssl-core@openssl.org.

5. Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in their names without prior written permission of the OpenSSL Project.

6. Redistributions of any form whatsoever must retain the following acknowledgment: "This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/)" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com).

D - 16

Original SSLeay License: Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) All rights reserved. This package is an SSL implementation written by Eric Young (eay@cryptsoft.com). The implementation was written so as to conform with Netscape’s SSL. This library is free for commercial and non-commercial use as long as the following conditions are adhered to. The following conditions apply to all code found in this distribution, be it the RC4, RSA, lhash, DES, etc., code; not just the SSL code. The SSL documentation included with this distribution is covered by the same copyright terms except that the holder is Tim Hudson (tjh@cryptsoft.com). Copyright remains Eric Young's, and as such any Copyright notices in the code are not to be removed. If this package is used in a product, Eric Young

Third Party Software

should be given attribution as the author of the parts of the library used. This can be in the form of a textual message at program startup or in documentation (online or textual) provided with the package. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer.

3. All advertising materials mentioning features or use of this software must display the following acknowledgement: "This product includes cryptographic software written by Eric Young (eay@cryptsoft.com)" The word 'cryptographic' can be left out if the routines from the library being used are not cryptographic related.

4. If you include any Windows specific code (or a derivative thereof) from the apps directory (application code) you must include an acknowledgement: "This product includes software written by Tim Hudson (tjh@cryptsoft.com)" THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. The licence and distribution terms for any publicly available version or derivative of this code cannot be changed. i.e. this code cannot simply be copied and put under another distribution licence [including the GNU Public Licence.]

pmap-29092002

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

D - 17

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

3. The name of the author may not be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

zlib

version 1.2.3, July 18th, 2005

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.

2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.

3. This notice may not be removed or altered from any source distribution.

Jean-loup Gailly Mark Adler

jloup@gzip.org madler@alumni.caltech.edu

D - 18

Index

basic tags

supported 3–2 unsupported A–1

block tags

unsupported A–2

Browser

application development process 4–6 configuration parameters, changes to 4–6 definition 1–3 idle display 4–3 launching 4–3 navigation and form editing 4–3 supported XHTML elements 4–1

character format tags

unsupported A–2

frame tags

unsupported A–3

HTTP support 3–14, 4–2

image tags

supported 3–6 unsupported A–4

input tags

supported 3–3 unsupported A–3

launching Browser 4–3 launching Microbrowser 3–16

link tags

supported 3–3 unsupported A–3

list tags

unsupported A–4

meta information tags

supported 3–13 unsupported A–5

Microbrowser

application development process 3–17 configuration parameters, changes to 3–18 definition 1–2 idle display 3–

launchi

navigation and form editing 3–16 supported XHTML elements 3–1

Microbrowser <mb> 3–18, 4–6

output tags

unsupported A–2

overview 1–1

programmable soft key tags

supported 2–1

programming tags

unsupported A–5

sample application

dynamic 3–21 static 3–20 XML API 3–23

style tags

unsupported A–4

supported XHTML elements A–1

table tags

supported 3–7 unsupported A–4

ng 3–16

Index – 1

Web Application Developer’s Guide for the SoundPoint IP/SoundStation IP/VVX Family

troubleshooting 5–1

XML errors 5–1

unsupported attributes A–1 unsupported elements A–1

XHTML, definition 1–4

Index – 2

Polycom Web Application Developer’s User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Contents

Overview

What is the Microbrowser

What is the Browser

What is XHTML

How to Create Applications

New Features in SIP 3.2

SoundPoint IP/SoundStation IP/VVX XML API Application Interface

Programmable Soft Keys

Telephone Integration URIs

Push Requests

Telephony Notification Events

Phone State Polling

API Security

Application Development for the Microbrowser

Supported XHTML Elements

Basic Tags

Link Tags

Input Tags

Image Tags

Tab le Tags

Meta Information Tags

HTTP Support

Microbrowser User Interface

Launching the Microbrowser

Navigation and Form Editing

Idle Display Microbrowser

Developing an XHTML Application

Changing Configuration Parameters

Sample Applications

Application Development for the Browser

Supported Standards

HTTP Support

Browser User Interface

Launching the Browser

Navigation and Form Editing

Idle Display Browser

Setting Up the Polycom SDK

Developing an XHTML Application

Changing Configuration Parameters

Sample Applications

Troubleshooting

XML Errors

Appendix

Unsupported XHTML Elements

Third Party Software

Index