Cisco OL-20949-01 User Manual
Page 67
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
) 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
).
–
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
).
–
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 = priority at which the action should be take. Values include: