Home screen display
From SIPfoundry sipx, The Open Source SIP PBX for Linux - Calivia
Contents |
[edit] How to change the phone's home screen display (phone top UI)
You can customize the appearance of sipXphone’s home screen by:
- Changing the data that displays in the title bar
- Presenting a corporate logo or other graphic image
You can also control whether or not sipXphone will play a distinctive audio file or “splash” sound each time it starts. In addition users can set a phone top preference to control window behavior for receiving a new call.
[edit] Define the home screen title
PHONESET_HOME_SCREEN_TITLE
You use this parameter to customize the information that displays in the title bar of a phone's home screen. By default, phones display the time and date, then, after 5 seconds, change to display the phone's SIP URL. This default is expressed as the following value for the PHONESET_HOME_SCREEN_TITLE parameter:
{h:mm a MM/dd/yy} \n {displayname}<{sipurl}>
The following can be specified as part of this value string:
- A simple text string.
- One or more of the options that follow.
Note: These options use data from the SIP URL that is designated as the USER_DEFAULT_OUTBOUND_LINE.
|
Option |
Description |
|
|
{displayname} {hostname} {sipurl} {username} \n |
The display name from the SIP URL. The domain name of the host in the SIP URL. The phone's SIP URL in the format <resource ID>@<host>. The resource ID from the phone's SIP URL. Defines a complete display segment. Each segment displays for 5 seconds, then the next segment displays. There is no limit on the number of segments you can define. |
Note: Symbols for dates and times are based on java.text.SimpleDateFormat. Frequently used symbols include:
|
Symbol |
Meaning & Example |
|
|
y M d E h H a m s |
year (e.g 2005) month in year (text & number) (e.g. July & 07) day in month (e.g. 24) day in week (e.g. Tuesday) hour in am/pm (1~12) (e.g. 8) hour in day (0~23) (e.g. 19) am/pm marker (e.g. PM) minute in hour (e.g. 30) second in minute (e.g. 55) |
[edit] Define home screen image (logo)
PHONESET_LOGO_URL
This configuration parameter stores the URL of an image file. If defined, the phone displays the specified image on its home screen. For example:
- Must be in .GIF or .JPG format
- Should be no larger than 24 x 126 pixels
You use the browser-based interface to define a value for this parameter. To define an image for the home screen:
- Store the image file on a Web server in your network.
- Set the PHONESET_LOGO_URL parameter on the phone(s) to indicate the URL for that file’s location.
[edit] Define the splash sound when the phone boots
PHONESET_SPLASH_SOUND
This configuration parameter determines whether a phone will play a distinctive sound when it starts up.
- When set to ENABLE, the splash sound plays each time the phone starts up.
- When set to DISABLE, the splash sound does not play.
Defaults to ENABLE, which plays the audioSplash.raw file that is delivered with all sipXphones.
[edit] Setting sipXphone window preferences
To set the preference for bringing the sipXphone to the top of all other windows when a new call comes in, you use the Prefs application on the phone top. You do not use a browser to change this preference.
Basic configuration steps:
- On the phone top, press MORE.
- On the Apps tab press Prefs
- The list of preferences categories displays.
- Select the Phone Top Settings preference category and press Adjust. The Phone Top Settings screen displays.
- Check or clear the check box.
- Press Ok.
- Press MORE again to return to the screen where you started.
Tip: You do not define a value for a configuration parameter to control this feature.
