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 bur ied on the applica tion “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 appli cat ion is p ushe d to t he
context) any pending Application URI requests are immediatel y canc ell ed.
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. Applicat ions
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 wil l 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 appli cati on 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 ev e nt 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 wil l not succeed (error
response).
–
If the application is already minimized, the request h as no effect.
• Close—Makes a request to the application manager to close the application context containi ng t his
application.
–
If the requested application is open, but not currently active, this request w ill not succee d (er ror
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 onAppFocusL ost 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: