Ring1 到 Ring12

适用于各种铃声的铃声脚本。

在电话配置 XML 文件 (cfg.xml) 中输入以下格式的字符串：

<!-- Ringtone -->
<Ring1 ua="na">n=Sunrise;w=file://Sunrise.rwb;c=1</Ring1>
<Ring2 ua="na">n=Chirp 1;w=file://chirp1.raw;c=1</Ring2>
<Ring3 ua="na">n=Chirp 2;w=file://chirp2.raw;c=1</Ring3>
<Ring4 ua="na">n=Delight;w=file://Delight.rwb;c=1</Ring4>
<Ring5 ua="na">n=Evolve;w=file://Evolve.rwb;c=1</Ring5>
<Ring6 ua="na">n=Mellow;w=file://Mellow.rwb;c=1</Ring6>
<Ring7 ua="na">n=Mischief;w=file://Mischief.rwb;c=1</Ring7>
<Ring8 ua="na">n=Reflections;w=file://Reflections.rwb;c=1</Ring8>
<Ring9 ua="na">n=Ringer;w=file://Ringer.rwb;c=1</Ring9>
<Ring10 ua="na">n=Ascent;w=file://Ascent.rwb;c=1</Ring10>
<Ring11 ua="na">n=Are you there;w=file://AreYouThereF.raw;c=1</Ring11>
<Ring12 ua="na">n=Chime;w=file://Chime.raw;c=1</Ring12>
<Silent_Ring_Duration ua="na">60</Silent_Ring_Duration>

静默振铃持续时间

控制静默振铃的持续时间。例如，如果该参数设置为 20 秒，则电话播放静默振铃 20 秒，然后向邀请消息发送 480 响应。

在电话配置 XML 文件 (cfg.xml) 中，输入以下格式的字符串：<Ring1 ua="na">n=Sunrise;w=file://Sunrise.rwb;c=1</Ring1>

<Silent_Ring_Duration ua="na">60</Silent_Ring_Duration>

PRT 上传规则

指定 PRT 上传脚本的路径。

如果 PRT 最大计时器和 PRT 上传规则字段为空，则不会生成问题报告。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <PRT_Upload_Rule ua="na">https://proxy.example.com/prt_upload.php</PRT_Upload_Rule>

• 在电话网页上，按以下格式数据路径：

  https://proxy.example.com/prt_upload.php

  或

  http://proxy.example.com/prt_upload.php

PRT 上传方法

确定用于将 PRT 日志上传到远程服务器的方法。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <PRT_Upload_Method ua="na">POST</PRT_Upload_Method>

• 在电话网页上，选择 POST或PUT 方法会将日志上传到远程服务器。

有效值：POST|PUT

默认值：POST

PRT 最大计时器

确定电话以多长时间的间隔（分钟）开始自动生成问题报告。

如果 PRT 最大计时器和 PRT 上传规则字段为空，则不会生成问题报告。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <PRT_Max_Timer ua="na">30</PRT_Max_Timer>

• 在电话网页上，以分钟为单位输入间隔持续时间。

有效值范围：10 分钟到 1440 分钟。

默认值：空

PRT 名称

为生成的 PRT 文件定义名称。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <PRT_Name ua="na">prt-string1-$MACRO</PRT_Name>

  输入此格式的名称：

  prt-string1-$MACRO

• 在电话网页上，按以下格式数目名称：

  prt-string1-$MACRO

默认值：空

组 1 寻呼脚本

组 2 寻呼脚本

组 3 寻呼脚本

组 4 寻呼脚本

组 5 寻呼脚本

组 6 寻呼脚本

组 7 寻呼脚本

组 8 寻呼脚本

组 9 寻呼脚本

组 10 寻呼脚本

输入一个字符串以配置要侦听的电话并启动多播寻呼。您最多可以将一部电话添加到 10 个寻呼组。按以下格式输入脚本：

pggrp=<multicast-address>:<port>;<name=group_name>;<num=multicast_number>;
<listen=boolean_value>;<pri=priority_level>;<codec=codec_name>;

示例脚本：

pggrp=224.168.168.168:34560;name=GroupA;num=500;listen=yes;pri=1;codec=g711a;

• 多播 IP 地址 (multicast-address) 和端口 (port) — 输入在寻呼服务器上指定的多播 IP 地址和端口。端口号对于每个组而言必须唯一，且必须是介于 1000 和 65534 之间的偶数。

  请确保为一个寻呼组内的所有电话设置相同的多播 IP 地址和端口。否则，电话将无法接收寻呼。

• 寻呼组名称 (name) — 选择性地输入寻呼组的名称。当您有多个寻呼组时，此名称可帮助识别电话所在的寻呼组。

• 多播号码 (num) — 指定电话侦听多播寻呼和发起多播寻呼会话的号码。为组内的所有电话分配同一个多播号码。号码必须符合为该线路指定的拨号方案以发起多播。

• 侦听状态 (listen) — 指定电话是否侦听此组的呼叫。将此参数设置为是可让电话侦听寻呼。否则，将其设置为否，或者不在脚本中添加此参数。

• 优先级 (pri) — 指定寻呼和电话呼叫之间的优先级。如果不指定优先级或者不在脚本中添加此参数，电话将使用优先级 1。这四个优先级分别为：

  • 0：寻呼会接管电话呼叫。当电话正在通话时，传入的寻呼会将当前呼叫置于保留状态。寻呼结束时，呼叫将继续。

  • 1：如果电话在通话时收到传入寻呼，用户听到寻呼和呼叫的混合音。

  • 2：当活动线路上收到传入寻呼时，用户收到寻呼音警告。除非活动呼叫置于保留或结束状态，否则不会应答传入寻呼。

  • 3：当电话正在通话时，电话会忽略传入的寻呼，且不会发出任何警报。

• 音频编解码器 (codec) —（可选）为要使用的多播寻呼指定音频编解码器。支持的编解码器包括 G711a、G711u、G722 和 G729。如果不指定编解码器或者不在脚本中添加编解码器参数，电话将使用 G711u 编解码器。

第一组附带默认脚本：

pggrp=224.168.168.168:34560;name=Group_1;num=800;listen=yes;pri=2;codec=g722;

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Group_1_Paging_Script ua="na">pggrp=224.168.168.168:34560;name=Group_1;
  num=800;listen=yes;pri=1;codec=g722</Group_1_Paging_Script>

• 在电话 Web 界面中，使用有效的字符串配置此字段。

pggrp=224.168.168.168:34560;name=All;num=800;listen=yes;

启用 TR-069

启用或禁用 TR-069 功能的设置。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Enable_TR-069 ua="na">No</Enable_TR-069>

• 在电话网页上，选择是会启用此功能，选择否会禁用它。

有效值：是|否

默认值：否

ACS URL

使用 CPE WAN 管理协议的 ACS 的 URL。此参数必须为有效的 HTTP 或 HTTPS URL。当使用 SSL 或 TLS 时，CPE 使用此 URL 的主机部分验证 ACS 证书。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <ACS_URL ua="na">https://acs.url.com</ACS_URL>

• 在电话网页上，输入 ACS 的有效 HTTP 或 HTTPS URL。

默认值：空

ACS 用户名

当 ACS 使用 CPE WAN 管理协议时，此用户名用于验证连接到 ACS 的 CPE。此用户名仅用于基于 HTTP 的 CPE 验证。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <ACS_Username ua="na">acs username</ACS_Username>

• 在电话网页上，输入基于 HTTPS 的 CPE 验证的有效用户名。

默认值：admin

ACS 密码

用于访问特定用户 ACS 的密码。此密码仅用于基于 HTTP 的 CPE 验证。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <ACS_Password ua="na"/>

• 在电话网页上，输入基于 HTTPS 的 CPE 验证的有效密码。

默认值：空

正在使用的 ACS URL

当前正在使用的 ACS URL。这是只读字段。

连接请求 URL

这是只读字段，显示向 CPE 发送连接请求的 ACS 的 URL。

连接请求用户名

此用户名用于验证向 CPE 发送连接请求的 ACS。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Connection_Request_Password ua="na"/>

• 在电话网页上，输入用于验证 ACS 的有效用户名。

连接请求密码

此密码用于验证向 CPE 发送连接请求的 ACS。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Connection_Request_Password ua="na"/>

• 在电话网页上，输入用于验证 ACS 的有效密码。

默认值：空

定期通知间隔

当“启用定期通知”设置为“是”时，CPE 尝试连接到 ACS 的时间间隔，以秒为单位。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Periodic_Inform_Interval ua="na">20</Periodic_Inform_Interval>

• 在电话网页上，以秒为单位输入有效的持续时间。

默认值：20

启用定期通知

启用或禁用 CPE 连接请求的设置。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Periodic_Inform_Enable ua="na">Yes</Periodic_Inform_Enable>

• 在电话网页上，选择是会启用此功能，选择否会禁用它。

有效值：是|否

默认值：是

TR-069 可跟踪性

启用或禁用 TR-069 事务日志的设置。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <TR-069_Traceability ua="na">Yes</TR-069_Traceability>

• 在电话网页上，选择是会启用此功能，选择否会禁用它。

有效值：是|否

默认值：否

CWMP V1.2 支持

启用或禁用 CPE WAN 管理协议 (CWMP) 支持的设置。如果设置为“禁用”，电话不向 ACS 发送任何通知消息，也不接受 ACS 发送的任何连接请求。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <CWMP_V1.2_Support ua="na">Yes</CWMP_V1.2_Support>

• 在电话网页上，选择是会启用此功能，选择否会禁用它。

有效值：是|否

默认值：是

TR-069 语音对象初始化

此设置用于修改语音对象。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <TR-069_VoiceObject_Init ua="na">Yes</TR-069_VoiceObject_Init>

• 在电话网页上，选择是会将所有语音对象初始化为工厂默认值，也可以选择否保持当前值。

有效值：是|否

默认值：是

TR-069 DHCP 选项初始化

此设置用于修改 DHCP 设置。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <TR-069_DHCPOption_Init ua="na">Yes</TR-069_DHCPOption_Init>

• 在电话网页上，选择是会从 ACS 初始化 DHCP 设置，也可以选择否保持当前 DHCP 设置。

有效值：是|否

默认值：是

备份 ACS URL

使用 CPE WAN 管理协议的 ACS 的备份 URL。此参数必须为有效的 HTTP 或 HTTPS URL。当使用 SSL 或 TLS 时，CPE 使用此 URL 的主机部分验证 ACS 证书。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <BACKUP_ACS_URL ua="na">https://acs.url.com</BACKUP_ACS_URL>

• 在电话网页上，输入使用 CPE WAN 管理协议的有效 URL。

默认值：空

备份 ACS 用户

当 ACS 使用 CPE WAN 管理协议时，此备份用户名用于验证连接到 ACS 的 CPE。此用户名仅用于基于 HTTP 的 CPE 验证。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <BACKUP_ACS_User ua="na">backup username</BACKUP_ACS_User>

• 当 ACS 使用 CPE WAN 管理协议时，在电话网页上，输入有效用户名向 ACS 验证 CPE。

默认值：空

备份 ACS 密码

用于访问特定用户 ACS 的备份密码。此密码仅用于基于 HTTP 的 CPE 验证。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <BACKUP_ACS_Password ua="na"/>

• 当 ACS 使用 CPE WAN 管理协议时，在电话网页上，输入有效密码向 ACS 验证 CPE。

默认值：空

XSI 主机服务器

输入服务器的名称。例如：

xsi.iop1.broadworks.net

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <XSI_Host_Server ua="na">https://xsi.iop1.broadworks.net</XSI_Host_Server>

• 在电话网页上，输入服务器。

例如：

https://xsi.iop1.broadworks.net

您还可以指定服务器的端口。例如：

https://xsi.iop1.broadworks.net:5061

如果没有指定端口。使用指定协议的默认端口。

默认值：空

XSI 验证类型

确定 XSI 验证类型。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <XSI_Authentication_Type ua="na">SIP Credentials</XSI_Authentication_Type>

• 在电话网页上，选择一种验证类型。

选项：

登录凭证－使用登录用户 ID 和登录密码验证访问。

SIP 凭证－使用电话上注册的 SIP 帐护的注册验证 ID 和密码验证访问。

如果为 XSI 验证类型选择 SIP 凭证，则需要在订阅者信息部分中输入订阅者验证 ID 和密码。

默认设置：登录凭证

登录用户 ID

电话用户的 BroadSoft 用户 ID。

例如：

johndoe@xdp.broadsoft.com.

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Login_User_ID ua="na">4081005300@as1bsoft22.sipurash.com</Login_User_ID>

• 在电话网页上，输入有效的用户 ID。

对于任何 XSI 验证类型，必须输入登录用户 ID。如果没有此参数，则 BroadWorks 任意位置功能不起作用。

默认值：admin

登录密码

与登录用户 ID 关联的字母数字密码。

当您为 XSI 验证类型选择登录凭证时，输入登录密码。

输入密码后，此参数会在配置文件 (cfg.xml) 中显示以下内容：<ACS_Password ua="na">************</ACS_Password>

默认值：空

启用任意位置

在分机上启用 BroadWorks 任意位置功能。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Anywhere_Enable_1_ ua="na">Yes</Anywhere_Enable_1_>

• 在电话网页上，选择是，会在此线路上启用任意位置功能，并且用户可以使用电话菜单将多个位置添加到这一特定线路。

有效值：是|否

默认值：是

XSI 主机服务器

xsi.iop1.broadworks.net

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <XSI_Host_Server ua="na">https://xsi.iop1.broadworks.net</XSI_Host_Server>

• 在电话 Web 界面中，输入要使用的 XSI 服务器。

默认值：空

XSI 验证类型

确定 XSI 验证类型。选择登录凭证以使用 XSI id 和密码验证访问。选择 SIP 凭证以使用在电话上注册的 SIP 帐户的注册用户 ID 和密码验证访问。

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <XSI_Authentication_Type ua="na">SIP Credentials</XSI_Authentication_Type>

• 在电话 Web 界面中，指定用于 XSI 服务的验证类型。

选项：SIP 凭证和登录凭证

默认设置：登录凭证

登录用户 ID

电话用户的 BroadSoft 用户 ID；例如：johndoe@xdp.broadsoft.com。

当您为 XSI 验证类型选择登录凭证或 SIP 凭证时，输入 SIP 验证 ID。

当您将 SIP 验证 ID 选择为 SIP 凭证时，必须输入登录用户 ID。如果没有登录用户 ID，BroadSoft 目录将不会出现在电话目录列表下。

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Login_User_ID ua="na">username</Login_User_ID>

• 在电话 Web 界面中，输入用于验证对 XSI 服务器访问的用户名。

默认值：空

登录密码

与用户 ID 关联的字母数字密码。

当您为 XSI 验证类型选择登录凭证时，输入登录密码。

默认值：空

启用目录

为电话用户启用 BroadSoft 目录。选择是以启用目录，选择否以将其禁用。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Directory_Enable ua="na">Yes</Directory_Enable>

• 在电话 Web 界面中，将此字段设置为是会启用 BroadSoft 目录。

选项：是和否

默认值：否

呼叫日志关联线路

可让您选择要显示最近呼叫日志的电话线路。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <CallLog_Associated_Line ua="na">1</CallLog_Associated_Line>

• 在电话 Web 界面中，选择一条电话线路。

有效值：1 到 10

默认值：1

显示以下位置的最新记录

可让您设置电话将显示哪种类型的最近呼叫日志。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Display_Recents_From ua="na">Phone</Display_Recents_From>

• 在电话 Web 接口中，选择服务器会显示 BroadSoft XSI 最近通话记录，选择电话会显示本地最近通话记录。

选项：电话和服务器

默认值：电话

SIP TOS/DiffServ 值

包含 SIP 消息的 UDP IP 数据包中的服务时间 (ToS)/区分服务 (DiffServ) 字段值。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <SIP_TOS_DiffServ_Value_1_ ua="na">0x68</SIP_TOS_DiffServ_Value_1_>

• 在电话网页上，输入包含 SIP 消息的 UDP IP 数据包中的字段值。

默认值：0x68

RTP ToS/DiffServ 值

语音数据包 ToS 字段的值。

设置数据流量中语音数据包的优先级。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <RTP_TOS_DiffServ_Value_1_ ua="na">0xb8</RTP_TOS_DiffServ_Value_1_>

• 在电话网页上，输入 ToS 字段的值。

默认值：0xb8

视频 RTP ToS/DiffServ 值

视频数据包 ToS 字段的值。

设置数据流量中视频数据包的优先级。

执行下列操作之一：

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：

  <Video_RTP_TOS_DiffServ_Value_1_ ua="na">0x80</Video_RTP_TOS_DiffServ_Value_1_>

• 在电话网页上，为视频数据包的 ToS 字段输入有效的值。。

默认值：

绿灯常亮。

关

黄灯常亮。

关

琥珀色缓慢闪烁

关

熄灭

关

红色常亮

c = r; p = n

c=r

琥珀色闪烁

c = a; p = b

关闭

c = o

红色快速闪烁

对于按键扩展模块，会红色缓慢闪烁，因为按键扩展模块限制为：

• ON

• 关闭

• 缓慢闪烁

适用于电话线路键，仅限：

BLF 占线 LED 适用于按键扩展模块线路键。

控制服务器 URL

电话尝试保持连接的 WebSocket 服务器的 URL。

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串。

  <Control_Server_URL ua="na"/>

• 在电话网页上，输入 WebSocket 服务器的 URL。

  例如：

  <Control_Server_URL>wss://my-server.com
  /ws-server-path</Control_Server_URL>

URL 应采用以下格式之一：

• 对于不安全的 HTTP 连接：

  ws://your-server-name/path

• 对于安全的 HTTPS 连接：

  wss://your-server-name/some-path

我们建议使用安全连接。

默认值：空。

允许的 API

一个正则表达式，可用于限制允许从控制服务器进行的 API 调用。

• 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串。

  <Allowed_APIs ua="na">.*</Allowed_APIs>

• 在电话网页上，输入适当的正则表达式。

提供的正则表达式与来自控制服务器的 API 请求中提供的请求 URI 路径相匹配。如果给定正则表达式不匹配整个路径，则 API 调用将被拒绝。

允许的值包括：

• .*：允许所有 API

• /api/Call/v1/.*：允许所有 v1 Call 接口调用。

• /api/Call/v1/（拨号 |挂断）：仅允许 v1 Call 接口调用拨号和挂断。

默认值：.*