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>

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 Upload Rule

指定 PRT 上传脚本的路径。

如果 PRT Max Timer 和 PRT Upload Rule 字段为空，电话不会自动生成问题报告，用户只能手动执行此操作。

执行下列操作之一：

• 在包含 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 Upload Method

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

执行下列操作之一：

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

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

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

有效值：POST 和 PUT

默认值：POST

PRT Max Timer

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

如果 PRT Max Timer 和 PRT Upload Rule 字段为空，电话不会自动生成问题报告，用户只能手动执行此操作。

执行下列操作之一：

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

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

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

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

默认值：空

PRT Name

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

执行下列操作之一：

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

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

  输入此格式的名称：

  prt-string1-$MACRO

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

  prt-string1-$MACRO

默认值：空

PRT HTTP Header

在 PRT Upload Rule 中指定 URL 的 HTTP 标头 。

参数值与 PRT HTTP Header Value 关联。

只有配置了两个参数时，HTTP 标头才包含在 HTTP 请求中。

执行下列操作之一：

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

  <PRT_HTTP_Header ua="na">x-cisco-spark-canary-opts</PRT_HTTP_Header>

• 在电话网页上，按以下格式输入 HTTP 标头：

  x-cisco-spark-canary-opts

有效值范围：a-z、A-Z、0-9、下划线 (_) 和连字符 (-)

默认值：空

PRT HTTP Header Value

设置指定 HTTP 标头的值。

参数值与 PRT HTTP Header 关联。

只有配置了两个参数时，HTTP 标头才包含在 HTTP 请求中。

执行下列操作之一：

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

  <PRT_HTTP_Header_Value ua="na">always</PRT_HTTP_Header_Value>

• 在电话网页上，按以下格式输入值：

  always

有效值范围：a-z、A-Z、0-9、下划线 (_)、逗号 (,)、分号 (;)、等于号 (=) 和连字符 (-)

默认值：空

Group 1 Paging Script

–

Group 10 Paging Script

输入一个字符串以配置要侦听的电话并启动多播寻呼。 您最多可以将一部电话添加到 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) — 指定电话是否侦听此组的呼叫。 将此参数设置为 yes 可让电话侦听寻呼。 否则，将其设置为 no，或者不在脚本中添加此参数。

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

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

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

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

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

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

执行下列操作之一：

• 在包含 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 界面中，使用有效的字符串配置此字段。

默认值： 空

Enable TR-069

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

执行下列操作之一：

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

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

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

有效值：Yes|No

默认值：No

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 Username

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

执行下列操作之一：

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

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

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

默认值：admin

ACS Password

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

执行下列操作之一：

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

  <ACS_Password ua="na"/>

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

默认值：空

ACS URL In Use

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

Connection Request URL

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

Connection Request Username

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

执行下列操作之一：

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

  <Connection_Request_Password ua="na"/>

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

Connection Request Password

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

执行下列操作之一：

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

  <Connection_Request_Password ua="na"/>

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

默认值：空

Periodic Inform Interval

当 Periodic Inform Enable 设置为 yes 时，CPE 尝试连接到 ACS 的时间间隔，以秒为单位。

执行下列操作之一：

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

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

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

默认值：20

Periodic Inform Enable

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

执行下列操作之一：

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

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

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

有效值：Yes|No

默认值：Yes

TR-069 Traceability

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

执行下列操作之一：

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

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

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

有效值：Yes|No

默认值：No

CWMP V1.2 Support

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

执行下列操作之一：

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

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

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

有效值：Yes|No

默认值：Yes

TR-069 VoiceObject Init

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

执行下列操作之一：

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

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

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

有效值：Yes|No

默认值：Yes

TR-069 DHCPOption Init

此设置用于修改 DHCP 设置。

执行下列操作之一：

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

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

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

有效值：Yes|No

默认值：Yes

BACKUP 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。

默认值：空

BACKUP ACS User

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

执行下列操作之一：

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

  <BACKUP_ACS_User ua="na">备份用户名</BACKUP_ACS_User>

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

默认值：空

BACKUP ACS Password

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

执行下列操作之一：

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

  <BACKUP_ACS_Password ua="na"/>

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

默认值：空

XSI Host Server

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

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 Authentication Type

确定 XSI 验证类型。

执行下列操作之一：

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

  <XSI_Authentication_Type ua="na">SIP 凭证</XSI_Authentication_Type>

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

选项：

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

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

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

默认值：Login Credentials

Login User 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

Login Password

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

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

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

默认值：空

Anywhere Enable

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

执行下列操作之一：

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

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

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

有效值：Yes|No

默认值：Yes

XSI Host Server

xsi.iop1.broadworks.net

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

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

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

默认值：空

XSI Authentication Type

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

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

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

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

选项：SIP Credentials 和 Login Credentials

默认值：Login Credentials

Login User ID

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

当您为 XSI 验证类型选择 Login Credentials 或 SIP Credentials 时，输入 SIP 验证 ID。

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

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

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

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

默认值：空

Login Password

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

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

默认值：空

Directory Enable

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

执行下列操作之一：

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

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

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

选项：Yes 和 No

默认值：No

呼叫日志关联线路

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

执行下列操作之一：

• 在包含 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 界面中，选择 Server 会显示 BroadSoft XSI 最近通话记录，选择 Phone 会显示本地最近通话记录。

选项：Phone 和 Server

默认值：Phone

Control Server 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

我们建议使用安全连接。

默认值：空。

Allowed APIs

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

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

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

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

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

允许的值包括：

• .*：允许所有 API

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

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

默认值：.*