Introduction
Softkey layout is used to customize the soft keys at the bottom of the LCD screen to best meet users' requirements. It can be configured based on call states. In addition to specifying which soft keys to display, you can determine their display order. You can create a template about the softkey layout for the different call states.
Compatibility
Custom softkey layout feature is only supported on x.0.4.2 version and above.
Softkey layout list
The following table lists the soft keys available for IP phones in different states:
Call States | Selected Soft keys(Enable) | Unselected Soft keys(Disable) | |
Dialing
| Send IME Delete EndCall | Empty Call Switch Directory DPickup Line GPickup | |
Connecting
| Connecting | Empty Empty Empty EndCall | Empty Call Switch |
SemiAttendTrans | Transfer Empty Empty EndCall | Empty Call Switch | |
Ring Back | Ring Back | Empty Empty Empty EndCall | Empty Call Switch Callback |
SemiAttendTransBack | Transfer Empty Empty EndCall | Empty Call Switch | |
Call Failed
| NewCall Empty Empty EndCall | Empty Call Switch | |
Call In
| Answer Forward Silence Reject | Empty Call Switch | |
Talking
| Talk | Transfer | Empty SWAP Mute Call Switch NewCall Recording |
Hold | Transfer | Empty Call Switch Conference | |
Held | Empty | Empty Call Switch NewCall | |
Pretrans | Transfer | Empty Call Switch Directory IME | |
Conferenced | Empty | Empty Call Switch Mute | |
Call Waiting
| Transfer Answer Reject EndCall NewCall | Empty | |
Edit the softkey layout file
The file's encode is UTF-8;
You can edit softkey in different states.
But you need to know the meaning of Labels
- "Enable" is selected softkey
- "Disable" is unselected softkey
- "Default" is default softkey (if you want to use the default softkey, you can reset to factory or press the "Reset to default" from IP Phone's webapage->Setting->Softkey Layout)
Softkey layout content as following:
<?xml version="1.0" ?> <Softkey> <Dialing> <Disable> <Key Type="Empty" /> <Key Type="Call Switch" /> <Key Type="Directory" /> <Key Type="Direct Pickup" /> <Key Type="Line Selection" /> <Key Type="Group Pickup" /> </Disable> <Enable> <Key Type="Send" /> <Key Type="IME" /> <Key Type="Delete" /> <Key Type="Cancel" /> </Enable> <Default> <Key Type="Send" /> <Key Type="IME" /> <Key Type="Delete" /> <Key Type="Cancel" /> </Default> </Dialing> <Connecting> <Disable> <Key Type="Empty" /> <Key Type="Call Switch" /> </Disable> <Enable> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Enable> <Default> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Default> </Connecting> <SemiAttendTrans> <Disable> <Key Type="Empty" /> <Key Type="Call Switch" /> </Disable> <Enable> <Key Type="Transfer" /> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Enable> <Default> <Key Type="Transfer" /> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Default> </SemiAttendTrans> <RingBack> <Disable> <Key Type="Empty" /> <Key Type="Call Switch" /> <Key Type="Callback" /> </Disable> <Enable> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Enable> <Default> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Default> </RingBack> <SemiAttendTransBack> <Disable> <Key Type="Empty" /> <Key Type="Call Switch" /> </Disable> <Enable> <Key Type="Transfer" /> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Enable> <Default> <Key Type="Transfer" /> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Default> </SemiAttendTransBack> <CallFailed> <Disable> <Key Type="Empty" /> <Key Type="Call Switch" /> </Disable> <Enable> <Key Type="NewCall" /> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Enable> <Default> <Key Type="NewCall" /> <Key Type="Empty" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Default> </CallFailed> <CallIn> <Disable> <Key Type="Empty" /> <Key Type="Call Switch" /> </Disable> <Enable> <Key Type="Answer" /> <Key Type="Forward" /> <Key Type="Silence" /> <Key Type="Reject" /> </Enable> <Default> <Key Type="Answer" /> <Key Type="Forward" /> <Key Type="Silence" /> <Key Type="Reject" /> </Default> </CallIn> <Talk> <Disable> <Key Type="Empty" /> <Key Type="SWAP" /> <Key Type="Mute" /> <Key Type="Call Switch" /> <Key Type="NewCall" /> <Key Type="Recording" /> </Disable> <Enable> <Key Type="Transfer" /> <Key Type="Hold" /> <Key Type="Conference" /> <Key Type="Cancel" /> <Key Type="Security" /> </Enable> <Default> <Key Type="Transfer" /> <Key Type="Hold" /> <Key Type="Conference" /> <Key Type="Cancel" /> <Key Type="Security" /> </Default> </Talk> <Hold> <Disable> <Key Type="Empty" /> <Key Type="Call Switch" /> <Key Type="Conference" /> </Disable> <Enable> <Key Type="Transfer" /> <Key Type="Resume" /> <Key Type="NewCall" /> <Key Type="Cancel" /> </Enable> <Default> <Key Type="Transfer" /> <Key Type="Resume" /> <Key Type="NewCall" /> <Key Type="Cancel" /> </Default> </Hold> <Held> <Disable> <Key Type="Empty" /> <Key Type="Call Switch" /> <Key Type="NewCall" /> </Disable> <Enable> <Key Type="Empty" /> <Key Type="Hold" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Enable> <Default> <Key Type="Empty" /> <Key Type="Hold" /> <Key Type="Empty" /> <Key Type="Cancel" /> </Default> </Held> <PreTrans> <Disable> <Key Type="Empty" /> <Key Type="Call Switch" /> <Key Type="IME" /> <Key Type="Directory" /> </Disable> <Enable> <Key Type="Transfer" /> <Key Type="Send" /> <Key Type="Delete" /> <Key Type="Cancel" /> </Enable> <Default> <Key Type="Transfer" /> <Key Type="Send" /> <Key Type="Delete" /> <Key Type="Cancel" /> </Default> </PreTrans> <Conferenced> <Disable> <Key Type="Empty" /> <Key Type="Call Switch" /> <Key Type="Mute" /> </Disable> <Enable> <Key Type="Empty" /> <Key Type="Hold" /> <Key Type="Split" /> <Key Type="Cancel" /> </Enable> <Default> <Key Type="Empty" /> <Key Type="Hold" /> <Key Type="Split" /> <Key Type="Cancel" /> </Default> </Conferenced> <Callwaiting> <Disable> <Key Type="Empty" /> </Disable> <Enable> <Key Type="Transfer" /> <Key Type="Answer" /> <Key Type="Reject" /> <Key Type="Cancel" /> <Key Type="NewCall" /> </Enable> <Default> <Key Type="Transfer" /> <Key Type="Answer" /> <Key Type="Reject" /> <Key Type="Cancel" /> <Key Type="NewCall" /> </Default> </Callwaiting> </Softkey> |
Configure the softkey layout URL
IP phone support 3 ways to configure the softkey layout URL:
Configuration file |
| P20995 |
Web Interface |
| Management->Auto Provision->Softkey Layout URL |
Phone Interface |
| N/A |
To configure the softkey layout URL via web interface:
- Login the IP Phone's webpage(admin/admin)
- Management->Auto Provision
- Enter the URL in the Softkey Layout URL field.
- Click the SaveSet button to save the configuration
Verify the softkey Layout feature
- Login the IP Phone's webpage->Management->Auto Provision
- Click the "Autoprovision Now" button.
- IP Phone will get the softkey.xml file from the specified URL:
- Enter Setting->Softkey Layout, checking the softkey which you custom.
Note:
If you disable the Custom softkey, IP Phone will not get the softkey.xml.