Manuals / Brands / Cell Phone / Cell Phone / Polycom / Cell Phone / Cell Phone

Polycom 3725-49106-001 Rev A Configuring Push Request Parameters

1 92

Download 92 pages, 1.77 Mb

Web Application for Polycom Phones UC Software 5.0.0

Polycom, Inc. 75

Configuring Push Request Parameters

The <apps.push/> parameters are used to control push server controls. Requests sent to the phone’s

push server must be in the format of http://<Phone IP>/push. The push control request parameters

are listed in the following table.

Table 62: Push Request Parameters

Parameter

Permitted Values

Default

apps.push.alertSound

0 or 1

0

If 0, there is no sound when an alert is pushed. If 1, there is sound.

apps.push.messageType

0 to 5

0

Set which push priority messages should display on the phone. The possible values are:

0: (None) Discard push messages

1: (Normal) Allows only Normal priority push messages

2: (Important) Allows only Important priority push messages

3: (High) Allows only High priority push messages

4: (Critical) Allows only Critical priority push

5: (All) Allows all push messages of any priority

apps.push.password

string

null

The password to access the push server URL.

apps.push.secureTunnelEnabled

0 or 1

1

If 0, the Web server is not connected through a secure tunnel. If 1, the Web server is connected through a secure

tunnel.

apps.push.secureTunnelPort

1 to 65535

443

The port that the phone uses to communicate to the Web server when the secure tunnel is used.

apps.push.secureTunnelRequired

0 or 1

0

If 0, communications to the Web server do not require a secure tunnel. If 1, communications require a secure

tunnel.

apps.push.serverRootURL

URL

null

The application server root URL. The relative URL received from the HTTP push message is appended to this

root URL, and the combined URL is sent to the microbrowser.

For example, if the application server root URL is http://172.24.128.85:8080/sampleapps and the relative URL is

/examples/sample.html, the URL that is sent to the microbrowser is

http://172.24.128.85:8080/sampleapps/examples/sample.html. Can be either HTTP or HTTPS.

apps.push.username

string

null

The user name to access the push server URL.

Note: To enable the push functionality, the parameters apps.push.username and apps.push.password

must both be set, not null.

Contents

Main Contents Understanding Web Application Development on Polycom Phones ............. 12 2: Getting to Know the XML API Application Interface ........................................ 19 3: Page About This Guide This guide uses a number of conventions that help you to understand information and perform tasks. Icon Name Conventions Used in This Guide Typographic Conventions Writing Conventions Coding Conventions Whats in This Guide? Getting Started 1: Recommended Software Tools Getting Help and Support Resources Planning Your XML API Interface Requirements Strategies for Web Application Development Best Practices for Web Application Development Best Practices for Microbrowser Web Application Development Page Understanding Web Application 2: Development on Polycom Phones What is the Browser? What is the Microbrowser? Page What is XHTML? What Are the Differences Between the Microbrowser and Browser? Whats in the Software Development Kit? Launching the Polycom SDK Whats New in the Latest Polycom UC Software Updates? Support for the VVX 500 Business Media Phone Getting to Know the XML API 3: Application Interface Notes on API Security Using Telephone Integration URIs Page Page Using Push Requests HTTP URL Push Page HTML Data Push The following table describes the results of using a specific priority. For example, to push the display of an important message: Using Telephony Notification Events Page Viewing an Incoming Call Event Viewing an Outgoing Call Event The Offhook Event allows an application to see when a call is starting. Viewing an Offhook Event Viewing an Onhook Event Viewing a Phone Lock Event Viewing a Phone Unlock Event Viewing a Call State Change Event Viewing a Line Registration Event Viewing a Line Unregistration Event Viewing a User Login/Logout Event </UserLoginOutEvent> Using Phone State Polling Receiving Call Line Information Receiving Device Information The Device Information message is returned in the following format: The device information message contains the attributes listed in the following table. The Network Configuration message returns network information about the phone. Receiving Network Configuration The Network Configuration message is returned in the following format: The network configuration message contains the attributes listed in the following table. Page Writing Your Web Application 4: Developing Your Browser Application Supporting HTTP Launching the Browser from VVX Phones Navigating and Form Editing on the Main Browser Viewing the Idle Browser Using Browser JavaScript DOM Extensions PolySoftKey Page PolyUri Sample Browser Web Applications Developing Microbrowser-Specific Applications Supporting XHTML Elements Basic Tags <!DOCTYPE>  Link Tags <a> Input Tags <form> <input> Image Tags <img> Table Tags <table> An example for the <table> tag is shown next. <caption> <th> <tr> <td> <thead> <tbody> This tag defines table footer. <tfoot> The <tfoot> tag supports the attributes listed in the following table. Meta Information Tags The following META information tags are supported: <head>Defines information about the document <head> Audio Tags <audio> Ordered and Unordered List Tag <ol> <ul> Supporting HTTP Launching the Microbrowser from the Phone Navigating and Form Editing Behavior on the Main Browser Viewing the Idle Browser Sample Microbrowser Web Applications Static XHTML Application Dynamic XHTML Application Page XML API Application Page Page 2 Using the IDE of your choice, create a file called webcallback.aspx.cs. Page Page Using Configuration Parameters 5: Configuring Web Application Parameters Configuring Push Request Parameters Configuring Telephone Event Notification Parameters Configuring Phone State Polling Parameters Configuring Programmable Soft Keys The <softkey> tag supports the attributes listed in the following table. Page Sample Configuration Page apps.statePolling.responseMode is set to send the requested state polling information to Getting Help 6: Polycom and Partner Resources The Polycom Community Troubleshooting 7: Understanding Microbrowser Application Errors Page References 8: Additional Information Unsupported XHTML elements on the Microbrowser Page Page Page JavaScript Examples for the Browser Control of Soft Keys The following example shows how to control soft keys. Page Keypad Captures