功能简介 EDK功能使用户可以自定义话机的可编程按键的功能。使用 EDK，你可以执行以下操作： 将常用功能分配给可编程按键。 根据需要为常用话机设置创建菜单快捷方式。 使用 EDK 宏字符串作为联系人号码。 应用场景涉及以下内容： 添加新的可编程按键可以简化常见的话机任务操作，这些默认任务可能需要多个按键才能使用默认配置。 移除为某些可能多余或从未使用过的功能配置的可编程按键。 一键连接到联系人的分机号，而无需手动输入 DTMF。 为可编程按键配置 EDK 的规则会根据情况而不同。建议你在使用 EDK 之前先熟悉宏语言。 配置 EDK 的原则 以下准则将帮助你有效地配置 EDK： 激活 EDK 功能需要有效的宏构造。 字符“$”界定宏字符串的部分（仅数字除外），并且必须成对存在。有关更多信息，请参阅 EDK 宏字符串。 可以以“!<宏名称>”格式调用宏，其中 <宏名称> 由参数 edk.edklist.X.mname 定义。 如果有两个或多个相同的宏，则软键或可编程按键将调用参数 edk.edklist.X.mname 定义的 X 值最小的宏。 EDK 宏字符串 使用 EDK 之前，你必须熟悉本节中提到的宏语言。 宏字符串 功能说明 Digits 要发送的字符。支持以下字符：. @ * # + 0-9 和英文字符。此参数的具体意义由操作字符串决定。例如：*981135。 $C<command>$ 这是指令。它可以出现在操作字符串中的任何位置。支持的命令（或快捷方式）包括： hang up (hu) hold (h) wait connect (wc) pause <number of seconds> (p <num sec>), 最大值是10 举例： 4411$Cwc$Cp10$ 表示呼叫号码 4411 > > 等待连接 > > 连接上并且持续10秒。 $T<type>$ 嵌入式操作类型。可以定义多个动作。支持的操作类型包括： invite dtmf refer intercom 举例： *338$Tdtmf$ 表示按 DTMF 类型发送 *338。 说明：我们建议你始终定义此字段。如果不定义，则默认使用 INVITE 指令呼出提供的数字。 $M<macro>$ 嵌入式宏。<macro> 字符串必须以字母开头。如果未定义宏名称，则将忽略操作字符串的执行。 举例：$MAA$ 表示调用 EDK 宏 AA。 $S<softkey ID>$ 执行此操作的功能与按对应软键的功能相同。每个功能键在话机上都有一个唯一的标识符，你可以根据系统定义的功能键 ID 来配置此参数。如果未在话机上定义软键 ID 或当前界面上没有匹配的软键，则将忽略操作字符串的执行。软键 ID 不区分大小写。 举例：$Sanswer$表示按应答软键。 亿联话机支持自定义软键。调用自定义软键时，必须添加前缀“#”。举例：如果自定义软键标签为 IVR1，则自定义功能键 ID 为 custom_macro，则 S#custom_macro 表示按下 IVR1 软键。 说明：要查看软键 ID，可以将“features.enhanced_dss_keys.enable”和“edk.id_mode.enable”设置为 1（启用），然后在话机空闲时长按音量调高键。 $K<key name>$ 执行此操作的功能与按对应硬键的功能相同。支持的键名包括： LineKeyX SoftKeyX（X取值1-4） ArrowUp（不适用于 T57W） ArrowDown（不适用于 T57W） ArrowLeft（不适用于 T57W） ArrowRight（不适用于 T57W） VolDown VolUp Cancel（不适用于 T57W） OK（不适用于 T57W） DialPadX（X 取值 0-9） DialPadPound DialPadStar Headset Mute Message Hold Redial Transfer Speaker Conference ExtX@Y（X 表示扩展键的序列号, Y 表示扩展台的序列号; 对于 T48S/T48G/T46S/T46G/T29G: X 的范围是 1 到 40, Y 的范围是 1 到 6；对于 T57W/T54W/T53W/T53C/T53/T48U/T46U/T43U: X 的范围是 1 到 60, Y 的范围是 1 到 3；如果仅将一个扩展台到话机，则可以省略 @Y。） Menu（你通过在非执行场景以外的任何界面上执行此命令来进入菜单。例如，在通话过程中无法进入菜单。） Home（对于 T57W/T48U/T48S/T48G 话机，你可以在拨号界面上通过此命令来返回到待机界面。） 举例：$KDialPadPound$表示按井号键。 说明：如果找不到按键（例如，重拨键），但该功能可用，则话机将执行相应的操作。如果找不到按键并且该功能不可用，则将忽略操作字符串的执行。 $I<menu item ID>$ 定位并进入所需的菜单项。每个菜单项在话机上都有一个唯一的标识符，你可以根据系统定义的菜单项 ID 来配置此参数。如果未在话机上定义菜单项 ID，或者当前界面上没有匹配的菜单项，则将忽略操作字符串的执行。菜单项 ID 不区分大小写。 举例：$Istatus_list&表示进入状态菜单。 说明：要查看菜单项 ID，可以将“edk.id_mode.enable”设置为 1（启用），然后在话机空闲时长按音量调高键。 $P<label>&T<title>&C<characters number allowed>&N&M$ 用户输入的提示字符串格式如下： label：为用户输入提示指定的标签。 title：用户输入提示的指定标题。 characters number allowed：定义最大输入字符数。 如果包含 &N，则字符类型为数字（默认输入法：123）。如果不包含 &N，字符类型为文本（默认输入法：abc），你可以手动更改输入法。对于 T57W/T48U/T48S/T48G，如果包含 &N，则输入模式为数字和符号；如果不包含 &N，则会显示屏幕键盘，你可以手动更改输入模式。 如果包括 &M，输入将显示星号字符“*”（在 T57W/T48U/T48S/T48G 上显示为点）。 举例：$PPassword&C3&N&M$ 表示提示密码弹出框，最大输入字符数为 3，输入类型为数字，输入将显示星号字符“*”（在 T57W/T48U/T48S/T48G 上显示为点）。 说明：&T<title> 不适用于 T57W/T48U/T48S/T48G/T46G/T42G/T41P/T29G 话机。 $P<EDK user input prompt X>N<characters number allowed>$ 用户输入的提示字符串格式如下： EDK user input prompt X：表示调用了哪个 EDK 用户输入提示，指示由 edk.edkprompt.X.enable 定义的 X。 characters number allowed：定义最大输入字符数。你需要按 Enter 软键完成数据输入。 举例：$P2N5$ 表示调用 EDK 用户输入提示 2，最多输入 5 个字符。 说明：有关 EDK 用户输入提示的更多信息，请参阅 EDK 用户输入弹框参数。 $L<label>$ 这是整个操作的标签说明： 标签：该值可以是任何字符串，包括空字符串（在这种情况下，不显示标签）。 如果未为自定义可编程按键或软键配置任何标签，则使用此标签；否则，将忽略该标签。 将此命令放在操作字符串中的首位。 举例：$LEDK2$1234$Tinvite$ 表示呼出号码 1234，并使用 “EDK2” 作为自定义键的标签。 $LED<color and time>&L<label>$( 不适用于 T30P/T30/T19§ E2/CP920话机) BLF/BLF 列表键 LED 的状态配置说明如下： 状态启用：指定 BLF/BLF 列表键的 LED 颜色，并设定对应状态的持续时间（单位：毫秒）。持续时间的有效值范围是 100 到 60000 毫秒。 循环：可以由“颜色”和“时间”的多种组合组成。该状态将陷入无限循环，直到被其他宏触发。 支持的颜色（必须为小写）： r：红色 ri：红色（对于 T57W/T48U/T48S/T48G，红色并带有呼入标记） ro：红色（对于 T57W/T48U/T48S/T48G，红色并带有呼出标记） rd：红色（对于 T57W/T48U/T48S，红色并带有 DND 标记） g：绿色 gi：绿色（对于 T57W/T48U/T48S/T48G，绿色并带有呼入标记） go：绿色（对于 T57W/T48U/T48S/T48G，绿色并带有呼出标记） y：黄色 yi：黄色（对于 T57W/T48U/T48S/T48G，黄色并带有呼入标记） yo：黄色（对于 T57W/T48U/T48S/T48G，黄色并带有呼出标记） yd：黄色（对于 T57W/T48U/T48S，黄色并带有 DND 标记） o：关闭（off） 标签配置 &L<label> (可选)：必须将“&L<label>”放在命令流的最后。 举例：$LEDg1000o100r300&Lidle$ 表示 BLF / BLF 列表可编程按键灯将进行以下无限循环： 绿色常亮 1000 毫秒 灯灭 100 毫秒 红色常亮 300 毫秒 同时，BLF / BLF 列表可编程按键的标签更改为“idle”。 说明： 可以在没有“时间”的情况下配置最后一个“颜色”，这表示一直显示最后一种颜色，直到被其他宏触发为止。 该宏只能用于 BLF / BLF 列表功能。 有关更多信息，请参阅配置已有 BLF 状态的行为。 $XML<xml browser url>$ 执行XML浏览器URL。举例：$XMLhttp://10.83.3.12/XML/PhoneExecute.xml$ 定义了要访问的XML浏览器URL地址http://10.83.3.12/XML/PhoneExecute.xml。 更多关于XML浏览器的信息，请参阅XML浏览。 EDK 参数 要配置 EDK 列表、EDK 用户输入提示、EDK 软键和自定义可编程按键，必须启用 EDK 功能。默认情况下，EDK 功能处于禁用状态。 亿联话机可以通过长按音量调高键来显示功能键 ID 或菜单项 ID。对于那些在配置 EDK 宏时需要查看功能键 ID 或菜单项 ID 的用户而言，这特别有用。 features.enhanced_dss_keys.enable edk.id_mode.enable M7语句 可选值 出厂默认值 功能说明 features.enhanced_dss_keys.enable 0-禁用1-启用 0 EDK功能开关。 edk.id_mode.enable 0-禁用1-启用 0 EDK 配置 menu ID 或者 softkey ID 时，该配置需优先打开。长按音量“+”进入提示模式，softkey label 切换为 ID，menu title 切换为 ID。 菜单项 ID 显示在话机的状态栏上。 再次长按音量键三秒钟以退出。仅 当“features.enhanced_dss_keys.enable”设置为 1（启用）时有效。 EDK 列表参数 当定义多个软键或可编程按键时，使用 EDK 列表参数定义宏非常有用。 edk.edklist.X.enable edk.edklist.X.mname edk.edklist.X.action M7语句 可选值 出厂默认值 功能说明 edk.edklist.X.enable[1] 0-禁用1-启用 0 单独配置开启或者关闭这个宏。 说明：仅当 "features.enhanced_dss_keys.enable" 设置为1（启用）时有效。 edk.edklist.X.mname[1] 字符串 空 配置宏的名称。举例：edk.edklist.2.mname = macro2 它不能以数字开头。 该参数必须有一个值，不能为空。 如果有两个或多个相同的宏，则软键或可编程按键将调用 X 值最小的宏。这意味着在多个宏定义存在的情况下，设备会优先执行具有最低 X 值的那个宏。 仅当 "features.enhanced_dss_keys.enable" 设置为1（启用）时有效。 edk.edklist.X.action[1] 0-禁用1-启用 空 配置宏的具体操作。举例：edk.edklist.2.action = 1013$Tinvite$ 该参数必须有一个值，不能留空。 仅当 "features.enhanced_dss_keys.enable" 设置为1（启用）时有效。 [1]X表示宏ID. X=1-255. EDK 用户输入弹框参数 如果与用户的交互是作为任何宏的一部分实现的，则必须适用EDK输入提示参数。 edk.edkprompt.X.enable edk.edkprompt.X.label edk.edkprompt.X.type edk.edkprompt.X.userfeedback edk.edkprompt.X.title M7语句 可选值 出厂默认值 功能说明 edk.edkprompt.X.enable[1] 0-禁用1-启用 0 配置启用或关闭该输入框。 如果宏尝试使用已禁用的 EDK 用户输入提示，则宏执行将失败。 仅当“features.enhanced_dss_keys.enable” 设置为 1（启用）时有效。 edk.edkprompt.X.label[1] 字符串 Default 配置输入框的label。举例：edk.edkprompt.1.label = Enter Password 说明：仅当 "features.enhanced_dss_keys.enable" 和 "edk.edkprompt.X.enable" 设置为 1（启用）时有效。 edk.edkprompt.X.type[1] text 或者 numeric text 它配置用户为用户输入提示 X 输入的字符类型。 如果设置为 numeric，则默认输入法是 123，并且可以在 abc / ABC / 2aB 输入法之间切换。 如果设置为 text，则默认输入法是 abc，并且可以在 ABC / 2aB / 123 输入法之间切换。 说明：仅当 “features.enhanced_dss_keys.enable” 和 “edk.edkprompt.X.enable”设置为 1（启用）时有效。 edk.edkprompt.X.userfeedback[1] visible：输入的文本可见。 masked：输入的文本显示为星号字符“*”。它可以用来屏蔽密码字段。 visible 配置输入内容是否要加 Mask。 说明：仅当 “features.enhanced_dss_keys.enable” 和 “edk.edkprompt.X.enable” 设置为 1（启用）时有效。 edk.edkprompt.X.title[1] 字符串 EDK Prompt 配置 EDK Prompt 自定义标题。如果留空，则显示默认的 EDK Prompt。 说明：仅当“features.enhanced_dss_keys.enable” 和 “ edk.edkprompt.X.enable”设置为 1（启用）时有效。 [1]X代表弹窗ID. X=1-10. 自定义 EDK 软键参数 你可以根据需要自定义软键。此功能通常用于访问常用功能或创建常用话机设置的菜单快捷方式。 可以在以下话机状态中添加自定义功能键： 空闲 - 话机上没有正在进行的通话。 来电 - 话机上有来电。 连接中 - 话机上有一个去电。此外，呼叫正在接通。 转接连接 - 呼叫正在转移到另一部话机。此外，呼叫正在接通。 通话 - 话机上正在进行通话。 呼叫失败 - 呼出通话失败。 回铃 - 话机上有一个去电。此外，话机处于回铃状态。 转接回铃 - 呼叫正在转接到另一部话机。此外，话机处于回铃状态。 保留 - 通话被保留在话机上。 保持 - 通话被保持。 会议 - 话机将建立话机会议。 拨号音 - 话机在拨号屏幕上，无需输入号码。 拨号 - 话机在拨号屏幕上，输入号码但不拨号。 配置自定义软键可能会影响不同呼叫状态下的软键布局。有关软键布局的更多信息，请参阅软键布局。 softkey.X.enable softkey.X.label softkey.X.position softkey.X.action softkey.X.softkey_id softkey.X.use.idle softkey.X.use.incoming_call softkey.X.use.connecting softkey.X.use.transfer_connecting softkey.X.use.on_talk softkey.X.use.call_failed softkey.X.use.ring_back softkey.X.use.transfer_ring_back softkey.X.use.hold softkey.X.use.held softkey.X.use.conferenced softkey.X.use.dialtone softkey.X.use.dialing M7语句 可选值 出厂默认值 功能说明 softkey.X.enable[1] 0-禁用1-启用 0 开启或关闭softkey x。 说明：仅当“features.enhanced_dss_keys.enable”设置为1（启用）时有效。 softkey.X.label[1] 字符串 空 配置softkey x的label。 说明：仅当“features.enhanced_dss_keys.enable”设置为1（启用）时有效。 softkey.X.position[1] 0到10的整数如果设置为0，则软键X位于左侧的第一个可用位置。 如果设置为其他值，则会显示更多软键，并且软键X位于指定位置，后面的软键将向右移动一个位置。按更多软键查看其余的软键。 0 配置 softkey x 位置。说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.action[1] 字符串 空 配置 softkey x 执行的操作。这里的值使用与 EDK 相同的宏操作字符串语法。你还可以调用已定义的 EDK 宏，宏名称后跟字符“！”。 举例： softkey.1.action= !macro1 在此示例中，macro1 表示由参数 edk.edklist.X.mname 配置的宏名称。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.softkey_id[1] 字符串 空 custom softkey 的 softkey id 与系统 softkey 的 softkey id 功能一致。 举例： softkey.1.softkey_id= custom_macro1 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.idle[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在 idle 界面显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.incoming_call[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在来电界面显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.connecting[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在去电界面显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.transfer_connecting[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在转接连接界面显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.on_talk[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在通话中的界面显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.call_failed[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在呼叫失败界面显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.ring_back[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在回铃界面显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.transfer_ring_back[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在转接回铃界面显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.hold[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在hold界面显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.held[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在held界面显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.conferenced[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在会议界面显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.dialtone[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在拨号界面（未输入号码，可听到dialtone）显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 softkey.X.use.dialing[1] 0-禁用1-启用 0 配置自定义 Softkey 是否在拨号界面（已输入号码，还未呼出）显示。 说明：仅当“features.enhanced_dss_keys.enable”和“softkey.X.enable”设置为1（启用）时有效。 [1]X是软键ID. X=1-10. 举例：账号键调用 EDK 宏命令 features.enhanced_dss_keys.enable = 1 edk.edklist.1.enable = 1 edk.edklist.1.mname = IVR1 edk.edklist.1.action = 1013$Tinvite$$Cwc$$Cp10$$Penter number&C4&N$$Tdtmf$$Cp3$$Chu$ linekey.1.type = 73 linekey.1.value = !IVR1 linekey.1.label = Custom Autop自动部署后，账号键1将调用宏“IVR1”。你可以按账号键1执行操作“1013$Tinvite$$Cwc$$Cp10$$Penter number&C4&N$$Tdtmf$$Cp3$$Chu$” 你也可以设置“linekey.1.value= 1013$Tinvite$$Cwc$$Cp10$$Penter number&C4&N$$Tdtmf$$Cp3$$Chu$”而无需配置EDK列表。你也可以在话机上手动使用宏“IVR1”或操作字符串“1013$Tinvite$$Cwc$$Cp10$$Penter number&C4&N$$Tdtmf$$Cp3$$Chu$”来手动分配账号键。 举例：添加联系人时使用 EDK 在本地联系人, LDAP, 远程地址簿或 XML 群组中添加联系人号码时，可以使用 EDK 宏字符串。 添加联系人号码时，请使用以下格式之一： 在宏名称前添加一个感叹号（!）前缀，然后将其括在括号中。例如，(!macro1)。 括号中包含 EDK 宏字符串。例如（8001234567$Cwc$$Cp2$103$Tdtmf$）。 举例：假设公司话机为 8001234567, 分机号为 103 的联系人。如果要直接呼叫此联系人，则可以按照以下步骤配置联系人号码： 配置以下参数：触发话机执行自动部署。 features.enhanced_dss_keys.enable = 1 ​ edk.edklist.1.enable = 1 ​ edk.edklist.1.mname = macro1 ​ edk.edklist.1.action = 8001234567$Cwc$$Cp2$103$Tdtmf$ 触发话机执行自动部署。 在你的话机上，将（!macro1）设置为联系人号码。当你呼叫此联系人时，话机将调用宏“macro1”。这样话机将执行操作“8001234567$Cwc$$Cp2$103$Tdtmf$”。 你也可用直接将（8001234567$Cwc$$Cp2$103$Tdtmf$）设置为联系人号码。 备注：8001234567$Cwc$$Cp2$103$Tdtmf$ 表示话机首先拨打 8001234567，并在呼叫连接后自动发送 DTMF 序列 103，并持续 2 秒钟。