Filter
Top Products
5-19
Cisco Unified IP Phone Services Application Development Notes
OL-20949-01
Chapter 5 Internal URI Features
Application Management URIs
This prevents open, but not active, applications which are buried on the application “stack” from closing
the entire application context which would also close the active application, potentially disrupting the
user’s interaction with the application. This also means that if an application closes or becomes
non-active (for example, if user navigates out of an application, or a new application is pushed to the
context) any pending Application URI requests are immediately cancelled.
Note The 6900 series IP phones cannot add phone service under application due to hardkey mapping.
URI Format
App:action:priority:idleTimer:applicationId
Where
action =
action to be taken with the application. Values include:
• RequestFocus—Makes a request to the application manager to bring the application context
(window) containing this application into focus (maximize). This is a request, not a demand, as
higher priority applications may prevent the application from actually gaining focus. Applications
must use onAppFocusGained event handlers (see the “Application Event Handlers” section on
page 3-22) to know when focus is actually gained.
–
If the requested application is Open, but not currently Active, this request will not succeed (error
response).
–
If the application already has focus, the request has no effect.
• ReleaseFocus—Makes a request to the application manager to relinquish focus to another
application context (essentially, a “move-to-back” request). Applications must use onAppFocusLost
event handlers to know when focus is actually lost (see the “Application Event Handlers” section on
page 3-22).
–
If the application does not have focus, the request has no effect.
–
If there are no other applications open (available to receive focus) then this application will
retain focus.
• Minimize—Makes a request to the application manager to minimize the application context
containing this application. This request always results in the application (eventually) being
minimized. If the application has focus when this URI executes, the onAppFocusLost event handler
will be invoked first, then the onAppMinimize handler (see the “Application Event Handlers”
section on page 3-22).
–
If the requested application is Open, but not currently Active, this request will not succeed (error
response).
–
If the application is already minimized, the request has no effect.
• Close—Makes a request to the application manager to close the application context containing this
application.
–
If the requested application is open, but not currently active, this request will not succeed (error
response). This request will result in the application context (and all applications within that
context) being closed.
–
If the application has focus when this URI executes, the onAppFocusLost event handler will be
invoked prior to the onAppClosed event handler (which will always be invoked).
priority = p
riority at which the action should be take. Values include: