Menu States - Motorola CA50 Developer & User Manual

7 - 22 CA50/UCA Client & Server Developer & User Guide

Menu States

Defines the menus applicable for different menu states. For each state of the device (AppCallActive, indicates that
the device is in a call is active and an application is open in the browser state) menu states define what is shown as
the menu for the left soft key and the right soft key.
Following is a sample code snippet for the menu state AppCAllActive:
<MenuStates>
<State ID="4" Name="AppCallActive" LSKey="Options:M:L:AppCallActive"
RSKey="End:S:L:PhoneHangUp" LPHKey="" RPHKey="" FPTTKey="default"
</MenuStates>
The format for representing a menu for LSKey and RSKey use is: [title to display]:M:L:[menu name]
In this example, the LSKey refers to the menu titled Options and the menu name is AppCallActive.
State = "AppCallActive"
Left Soft key (LSKey) displays options as a menu and the actual menu referenced is AppCallActive.
Right Soft key (RSKey) displays end as a command and the actual command referenced is PhoneHangUp.
The name attribute identifies the client state as follows:
•
DesktopNoCall
•
AppNoCall
•
DesktopCallActive - The user is at the desktop and is on a phone call.
•
AppCallActive
•
DesktopQuietMode- The user has entered quiet mode from the desktop.
•
AppQuietMode
•
DesktopCallOnHold-The user is on a call at the desktop and is on hold.
•
AppCallOnHold
Menus and actions can be assigned to keys for each of the client states. These menus are accessible to the user
through the keys while the device is in that client state. Key and menu assignments must be thought through a bit.
For example, for the "AppCallActive" client state is recommended to assign a menu to a key that presents a "Hang
up" menu option.
As mentioned earlier, keys defined by the Web application take precedence over keys defined in the
<MenuStates> area of the profile. The CA50 is a dual purpose device (communication and Web browser). The
UCA Web developer must consider the <MenuStates> key assignments when designing a Web application for the
CA50.
NOTE Examples of base profiles are found in the following directory in the default UCA server software
installation: \Program Files\Motorola\UCA Server\Profiles.
- The user is at the desktop and not on a phone call.
- The user is running a Web application and is not on a phone call.
- The user is running a Web application and is on a phone call.
- The user has entered quiet mode while running a Web application.
- The user is on a call on hold while running a Web application.
SPTTKey="default" />