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 接口调用拨号和挂断。

默认值：.*

办公时间已启用

为 Cisco IP 会议电话 8832 多平台电话启用办公时间功能。

“办公时间”功能旨在最大限度地减少电话非活动期间的电源使用。 您可以将电话配置为自动进入显示关闭模式，并在指定的工作时间之外关闭屏幕。

执行下列操作之一：

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

  <Office_Hours_Enabled ua="na">真</Office_Hours_Enabled>

• 在电话管理网页上，选择 True 可启用该功能，而选择 False 可禁用该功能。

有效值：True 和 False

默认值：False

工作日

通过指定所需的日期来自定义工作日。

在非工作日，电话将自动关闭屏幕。 默认情况下，工作日设置为星期一到星期五。 您可以使用工作时间开始和工作时间结束字段来设置工作日的工作时间。

执行下列操作之一：

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

  <Work_Days ua="na">周一|周二|周三|周四|星期五</Work_Days>

• 在电话管理网页上，输入有效的值。

有效值：星期六|星期日|星期一|星期二|星期三|星期四|星期五

默认值：星期一|星期二|星期三|星期四|星期五

工作时间开始

使用 24 小时格式设置工作时间的开始时间。 在指定的工作时间之外，电话将自动关闭屏幕。

执行下列操作之一：

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

  <Working_Hours_Start ua="na">06:00</Working_Hours_Start>

• 在电话管理网页上，输入有效值。 例如，09:00 表示上午 09:00，17:30 表示下午 05:30。

默认值：07：00

工作时间结束

使用 24 小时制设置工作时间的结束时间。 在指定的工作时间之外，电话将自动关闭屏幕。

执行下列操作之一：

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

  <Working_Hours_End ua="na">21:00</Working_Hours_End>

• 在电话管理网页上，输入有效值。 例如，09:00 表示上午 09:00，17:30 表示下午 05:30。

默认值：19:00

显示屏关闭模式下的 LED 指示灯

确定当电话进入“显示屏关闭模式”时是否关闭导航群集中选择按键的背光。

执行下列操作之一：

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

  <LED_Indicator_In_Display_Off_Mode ua="na">已启用</LED_Indicator_In_Display_Off_Mode>

• 在电话管理网页上，选择 启用 或 禁用。

  如果设置为启用，则背光灯在非工作时间保持亮起。 如果设置为禁用，当电话进入“显示屏关闭模式”后背光灯将熄灭。

有效值：启用和禁用

默认设置：启用

空闲超时（分钟）

设置电话从关闭显示屏模式唤醒后自动关闭屏幕的超时时间（分钟）。

执行下列操作之一：

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

  <Display_Off_Idle_Timeout__mins_ ua="na">5</Display_Off_Idle_Timeout__mins_>

• 在电话管理网页上，输入有效的值。

允许的值：1 到 60

默认值：5