Copyright 2010-2017 Obihai Technology, Inc.
116
One and only one of the calls on the Calls App screen is highlighted and the corresponding VLKW shows a white
bounding box to identify the Call Key that the highlighted call belongs to. As the user navigates through the calls on the
screen, the white bounding box will move accordingly. Note that the highlighted call is not necessarily the focused call.
If the highlighted call is not the focus, user can press the “Right” navigation key to make it the focused call. Note the
action triggered by pressing the Call Key applies to the focused call only.
Normally the calls are packed together on the Calls App screen. Hence it is possible to see two calls belonging to the
same Call Key on the same screen. If this is not desirable, you can disable the option
User
Preferences
::
PackCallsOnDisplay
which will cause the phone to show only calls belonging to the same Call Key
together on the same screen.
Soft Key Set Customization
The set of soft keys that are available on the phone screen at any given time is called a Soft Key Set. The set is chosen
by the phone based on the current App state. Very often it is chosen based on the highlighted item on a screen with
multiple items listed. Some of the soft key sets can be customized by entering a list of soft key specifications as a
comma-separated list in the corresponding soft key parameters.
Soft Key Set Parameter Syntax
The value of a Soft Key Set parameter is a comma separated list of
soft key specifications
, with the following general
format:
{softkey-spec}
[
|{softkey-spec}
]
, {softkey-spec}
[
|{softkey-spec}
]
, ...
A
{softkey-spec}
is a soft key specification as defined in the next section. The
|{softkey-spec}
syntax lets
you specify an optional alternative soft key to show when the given soft key is hidden. A soft key is hidden when its
hidden condition is matched. The hidden condition for each soft key is defined internally. For example:
missed|lines
specifies that the
Missed
soft key is shown when it is not hidden, otherwise the
Lines
soft key is
shown. If the alternative soft key is an empty key (unspecified or not found), an
<
Empty
>
soft key will be shown as the
alternative. Otherwise a hidden soft key is packed and does not occupy any soft key slot on the display.
For example: the set
barge,monitor,,newcall
shows
Barge In
,
Monitor
,
<Empty>
,
New Call
when barge
and monitor are not hidden, and
<Empty>
,
New Call
when barge and monitor are hidden. On the other hand, the
set
barge|,monitor|,,newcall
shows the same when barge and monitor are not hidden, but
<Empty>
,
<Empty>
,
<Empty>
,
New Call
when they are.
Soft Key Specification
General format:
{id}[?][;attr[
;attr[…]]]
{id}
is the standard soft key ID, as shown in the table below.
?
is an optional syntax to designate if the key should not hidden if the hidden condition is matched.
One or more
attr
attribute elements separated by a semicolon (;) can be included. Attribute is usually in the following
format
{attribute-name}[={attribute-value}]
. {attribute-value} may be enclosed in a pair of double
quotes (“) such that all the enclosed characters are preserved (otherwise all white spaces are removed); the enclosin
g
double quotes are not counted as part of the value. For example:
number=**922222222
,
name=”Echo
Server”
, or
url
=”http://abc.com/call.png,auth
-
token=abcdefg”
. That is, all contents within the
double quotes are interpreted as part of the attribute value.
All soft keys support the optional
label
and
icon
attribute which is the text and icon that can be shown on the screen
inside the soft key window. Without the label or icon attribute specified the default label and icon of the soft key will
be used. Some soft keys that have an on/off (or enabled/disabled or yes/no) state offer a
label1
and
icon1
option that
is used when the underlying function is in the “on” state.
The
acd
softkey also supports
label2
,
label3
,
icon2
, and
icon3
options for to cover the 4 states of an ACD Agent.
