您可以使用 ua 属性控制用户对用户界面上菜单项的访问。 ua 属性附加到配置文件中的每个参数。 有关详细信息，请参阅以下章节。

管理员帐户和用户帐户

Cisco IP 电话固件提供特定的管理员和用户帐户。 这些帐户提供特定的登录权限。 管理员帐户名为 admin；用户帐户名为 user。 帐户名称无法更改。

管理员帐户给予服务提供商或增值经销商 (VAR) 配置访问电话的权限。 用户帐户给予设备最终用户有限且可配置的控制权。

可使用密码对用户和管理员帐户分别进行保护。 如果服务提供商设置管理员帐户密码，当您单击管理员登录时，系统会提示您。 如果密码尚不存在，屏幕将刷新并显示管理参数。 管理员帐户和用户帐户均未分配任何默认密码。 只有管理员帐户可以分配或更改密码。

管理员帐户可查看和修改所有 Web 配置文件参数，包括可供用户登录的 Web 参数。 电话系统管理员可使用授权文件进一步限制用户帐户可查看和修改的参数。

用户帐户使用的配置参数可在电话上配置。 可禁用用户对电话 Web 用户界面的访问权限。

用户访问属性

用户帐户可以使用用户访问 (ua) 属性控制更改访问权限。 如果未指定 ua 属性，则现有用户访问设置会保留。 此属性不影响管理员帐户的访问。

ua 属性必须具有下列值之一：

  • na — 无法访问

  • ro — 只读

  • rw — 读取和写入

  • y — 保留值

    y 值必须与 na、ro 或 rw 一起使用。

下例解释了 ua 属性。 请注意，ua 属性更新为 rw 的最后一条线路，并且基站名称字段（旅行社 1）将保留。 如果不包含 y，旅行社 1 会被改写：

<flat-profile> <SIP_TOS_DiffServ_Value_1_ ua=”na”/> <Dial_Plan_1_ ua=”ro”/> <Dial_Plan_2_ ua=”rw”/><Station_Name ua=“rw” preserve-value="y">Travel Agent 1</Station_Name></flat-profile>

必须将 ua 选项的值置于双引号内。

访问电话 Web 界面

电话固件提供了可限制最终用户访问某些参数的机制。 固件提供了登录到管理员帐户或用户帐户的特定权限。 每一个可以单独受密码保护。

  • 管理员帐户 — 可完全访问所有管理 Web 服务器参数

  • 用户帐户 — 可访问部分管理 web 服务器参数

如果您的服务提供商禁用了对配置实用程序的访问权限，请联系服务提供商后再继续。

1

确保计算机可以与电话通信。 未使用 VPN。

2

在 Web 浏览器的地址栏中，输入电话的 IP 地址。

  • 用户访问：http://<ip 地址>
  • 管理员访问：http://<ip address>/admin/advanced
  • 管理员访问：http://<ip address>，单击管理员登录并单击高级

例如 http://10.64.84.147/admin

3

出现提示时，输入密码。

绕过设置密码屏幕

基于以下配置操作，第一次启动时或恢复出厂设置后，您可以跳过电话设置密码屏幕：

  • DHCP 配置

  • EDOS 配置

  • 在电话 XML 配置文件中配置用户密码

配置用户密码后，“设置密码”屏幕不会显示。

1

在文本编辑器或 XML 编辑器中编辑电话 cfg.xml 文件。

2

使用下列选项之一，插入 <User_Password> 标记。

  • 无密码（开始和结束标记）–<User_Password></User_Password>
  • 密码的值（4-127 个字符）–<User_Password >Abc123</User_Password>
  • 无密码（仅适用于开始标记）–<User_Password />
3

将更改保存到 cfg.xml 文件。

设置密码屏幕在第一次启动时或恢复出厂设置后不显示。 如果指定了密码，则在访问电话 Web 界面或电话屏幕菜单时，系统会提示用户输入密码。
控制对电话设置的访问

您可以将电话配置为允许或阻止访问电话网页或电话屏幕上的配置参数。 通过访问控制参数，您可以：

  • 表示创建配置时，哪些配置参数可供用户帐户使用。

  • 启用或禁用用户对管理 web 服务器的访问。

  • 启用或禁用用户对电话屏幕菜单的访问。

  • 为用户绕过设置密码屏幕。

  • 限制电话因为线路 1 的重新同步、升级或 SIP 注册而访问的 Internet 域。

您还可以使用 XML(cfg.xml) 代码配置电话配置文件中的参数。 要配置每个参数，请参阅下表访问控制参数中的字符串语法。

1

访问电话管理网页。

2

单击 Voice > System。

3

在系统配置部分中，按照访问控制参数下表中的定义配置参数。

4

单击提交所有更改以应用更改。

访问控制参数

下表定义了电话 Web 界面中 Voice > System 选项卡下系统配置部分中访问控制参数的功能和用法。 它还定义了电话配置文件 (cfg.xml) 中添加的字符串的语法，其中包含用于配置参数的 XML 代码。

表 1. 访问控制参数

参数名称

描述和默认值

Enable Web Server

启用或禁用对电话 Web 界面的访问。 将此参数设置为 Yes 以允许用户或管理员访问电话 Web 界面。 否则，将其设置为否。 如果设置为 No，将无法访问电话 Web 界面。

执行下列操作之一：

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

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

  • 在电话 Web 界面中，选择 Yes 将允许访问。

允许的值：是|否

默认值：Yes。

Enable Web Admin Access

允许或阻止对电话管理页面的访问：

http://<phone_IP>/admin

当设置为否时，将无法访问“管理员”网页。 只有用户的网页是可访问的。

如果要在访问被阻止后再次允许访问管理网页，则需要从电话执行工厂重置。

执行下列操作之一：

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

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

  • 在电话 Web 界面中，将此参数设置为 Yes 以允许访问。 否则，将其设置为否。

允许的值：是|否

默认值：Yes

管理员密码

允许您设置或更改电话管理网页的访问密码。

Admin Password 参数仅适用于电话管理网页。

有效密码必须包含 4 到 127 个字符，字符类型涉及以下四类中的三种：大写字母、小写字母、数字和特殊字符。

执行电话恢复出厂设置后，密码设置为空。

执行下列操作之一：

  • 在包含 XML(cfg.xml) 的电话配置文件中，输入以下格式的字符串：<Admin_Password ua="na">P0ssw0rd_tes89</Admin_Password>

  • 在电话 Web 界面中，输入管理员访问密码。

默认值：空

User Password

允许您或电话用户设置或者更改用于访问电话 Web 界面以及电话屏幕菜单的密码。

有效密码必须包含 4 到 127 个字符，字符类型涉及以下四类中的三种：大写字母、小写字母、数字和特殊字符。

执行电话恢复出厂设置后，密码设置为空。

在配置文件 (cfg.xml) 中，您可以使用 User_Password 参数绕过在第一次启动或恢复出厂时提示的设置密码屏幕。 有关更多信息，请参阅绕过设置密码屏幕。

默认值：空

显示密码警告

确定当用户或管理员密码为空时是否显示“ 未提供密码” 警告。 通常，警告消息会显示在电话 问题和诊断 菜单以及电话网页上。

同时设置用户密码和管理员密码后，警告消息消失。

如果 启用 Web 管理员访问权限 设置为 否，密码警告不会显示在电话屏幕上。

执行下列操作之一：

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

    <Display_Password_Warnings ua=“na”>是的</Display_Password_Warnings>

  • 在电话 Web 界面中，设置为 是 可显示警告，设置为 否 可隐藏警告。

允许的值：是|否

默认值：Yes

作为管理员，您可以通过快速拨号和呼叫代接为用户配置 BLF 快捷方式。 BLF 快捷方式允许用户监控其同事的线路。 当 BLF 快捷方式配置了呼叫代接和快速拨号时，用户可以使用 BLF 快捷方式应答受监控线路的呼叫，并一键呼叫被监控线路。

监控线上的指示器因配置而异。 有关状态，请参阅下表。

如果在监控线路上同时配置了快速拨号和呼叫代接，指示器将显示为快速拨号图标。
表 2. 带有呼叫代接的 BLF 指示器
图标状态

带有呼叫代接（空闲状态）的 BLF，适用于 Espresso B 和 C 型号。

该线路配置有呼叫代答和空闲模式。

警报，或

警报 · 代接已启用

 有一个来电等待代答。

如果为 BLF 快捷方式启用了呼叫代接功能，则用户可以通过点击 BLF 快捷方式为其同事应答呼叫。

如果未启用呼叫代接功能，用户将无法应答呼叫。 相反，点击快捷方式会发起对受监控线路的呼叫。

当您的电话上有活动呼叫或传出呼叫时，您无法接听受监控线路的警报呼叫。

正在使用

 监听线路正在使用中。
表 3. 带快速拨号 BLF 的状态指示器
图标状态说明

未知状态 BLF 快速拨号图标

空闲

受监控线路处于空闲模式。

您可以点击快捷方式呼叫快速拨号号码。

BLF 快速拨号警报图标

告警

警报 · 代接已启用

被监控线路上有呼叫发出警报。

如果 BLF 快捷方式已启用呼叫代接功能，您可以通过点击 BLF 快捷方式为同事应答呼叫。

如果未启用呼叫代接功能，您将无法应答呼叫。 相反，点击快捷方式会发起对受监控线路的呼叫。

当您的电话上有活动呼叫或传出呼叫时，您无法接听受监控线路的警报呼叫。

正在使用 BLF 快速拨号的图标

正在使用

被监控线路正在呼叫中。

如果点击快捷方式，就会呼叫快速拨号号码。 您将听到忙音或被重定向到语音邮件，具体取决于您同事线路上的配置。

BLF 快速拨号 DND 状态的图标

免打扰

受监控线路设置为免打扰（DND）。

对该线路的呼叫不会发出警报。

未注册 BLF 快速拨号图标

已取消注册

受监控的线路未注册。

对该线路的呼叫未连接。
配置电话以监控多个用户的线路

如果电话已注册到 BroadWorks 服务器，您可以配置电话以监控整个 BLF 列表。 电话会按顺序分配可用的线路键以监控 BLF 列表条目，并开始在 BLF 键上显示受监控线路的状态。

您还可以使用 XML（cfg.xml）在电话配置文件中配置参数。 要配置每个参数，请参阅下表用于监控多个用户线路的参数中的字符串语法。

开始之前

  • 确保电话已注册到 BroadWorks 服务器。

  • 您可以在 BroadWorks 服务器上为电话用户设置 BLF 列表。

  • 确保 BLF 键上的监控线路不处于不活动模式。

1

访问管理 Web 界面。

2

选择 Voice > Att Console。

3

配置 BLF 列表 URI、使用 BLF 列表的线路键、BLF 列表和 BLF 标签显示模式，如以下参数表所述，用于监控多个用户的线路。

4

单击 Submit All Changes。

监控多个用户线路的参数

监控多个用户线路的参数

下表定义了电话 Web 界面中 Voice > Att Console 选项卡下常规部分中 BLF 参数的功能和用法。 它还使用 XML（cfg.xml）定义在电话配置文件中添加的字符串的语法，以配置参数。

表 4. 监控多个用户线路的参数

参数

描述和默认值

BLF 列表 URI

您在 BroadWorks 服务器上为电话用户设置的忙线字段（BLF）列表的统一资源标识符（URI）。

仅当电话注册到 BroadWorks 服务器时，此字段才适用。 BLF 列表是电话可监控其线路的用户的列表。

必须以 <URI_名称>@<服务器> 格式指定 BLF 列表 URI。 指定的“BLF 列表”URI 必须与在 BroadWorks 服务器上为 List URI：sip 参数配置 的值相同。

执行下列操作之一：

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

    <BLF_List_URI ua="na">MonitoredUsersList@sipurash22.com</BLF_List_URI>

  • 在电话 Web 界面上，指定在 BroadSoft 服务器上定义的 BLF 列表。

默认值：空

将线路键用于 BLF 列表

控制当对 BLF 列表的监控激活时，电话是否使用其线路键来监控 BLF 列表。

此设置仅在 BLF 列表设置为显示时有意义。

执行下列操作之一：

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

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

  • 在电话 Web 界面上，将此字段设置为是，以使用未注册的线路监控 BLF 列表条目。 将其设置为否则禁止使用线路键来监控 BLF 列表条目。

默认值：No

BLF 列表

确定是显示还是隐藏线路键上的 BLF 列表。

如果设置为显示，电话会依次分配可用的线路键来监控 BLF 列表条目。 BLF 列表键的标签显示受监控用户的姓名和受监控线路的状态。

此设置仅在配置了 BLF 列表 URI 时有意义。

执行下列操作之一：

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

    <BLF_List ua="rw">显示</BLF_List>

  • 在电话 Web 界面上，将此字段设置为显示或隐藏以激活或停用 BLF 监控功能。

允许的值：显示|隐藏

默认值：显示

BLF 标签显示模式

指定 BLF 条目在线路键上的显示方式。 选项包括：姓名、分机 （分机号码）和两者 。

执行下列操作之一：

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

    <BLF_Label_Display_Mode ua="na">名称</BLF_Label_Display_Mode>

  • 在电话 Web 界面上，从列表中选择一个选项。

允许的值：名称|分机|两者

默认值：名称

配置线路以监控特定用户的线路

当用户需要监控同事是否有空处理呼叫时，您可以在电话线路配置忙灯字段。

您可以将忙灯字段配置为与快速拨号或呼叫代答的任意组合配合使用。 例如，忙线字段和快速拨号、忙线字段和呼叫代接，或忙线字段同时具有快速拨号和呼叫代接。 但单独的快速拨号需要不同的配置。

您还可以使用 XML（cfg.xml）在电话配置文件中配置参数。 要配置每个参数，请参阅用于监控特定线路的参数表中的字符串语法。

开始之前

确保用于配置忙灯字段的线路键不处于不活动模式。

1

访问电话管理网页。

2

选择 Voice > Phone。

3

选择要配置忙灯字段的线路键。

4

按照以下监控特定线路参数表中的定义配置分机、分机功能字段。

5

单击 Submit All Changes。

监控特定线路的参数

监控特定线路的参数

下表定义了电话 Web 界面中 Voice > Phone 选项卡下线路键 (n) 部分中忙灯字段 (BLF) 参数的功能和用法。 它还使用 XML（cfg.xml）定义在电话配置文件中添加的字符串的语法，以配置参数。

表 5. 监控特定线路的参数

参数

描述和默认值

分机

分配分机号码给线路键或禁用线路键上的分机功能。

线路键的数量因电话型号而异。 使用分机号码分配时，您可以将线路键配置为电话分机。

如果您需要在禁用直接 PLK 配置功能的情况下为线路键分配扩展功能（例如，快速拨号、BLF、呼叫代接），您可以启用该功能或将分机参数 设置为禁用。

执行下列操作之一：

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

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

    <Extension_2_ ua="na">2</Extension_2_>

    <Extension_3_ ua="na">3</Extension_3_>

    <Extension_4_ ua="na">4</Extension_4_>

  • 在电话 Web 界面上，将此参数设置为禁用以监控线路键上的另一条线路。

允许的值：禁用|1|2|3|4，允许的值因电话而异。

默认值：n，其中 n 为线路键号。

扩展功能

此参数仅在分机参数设置为禁用的线路上才起作用。

用于将扩展功能分配给电话上的线路。 支持的功能包括：

  • BLF 和呼叫代答

    示例：fnc=blf+cp;sub=BLF_List_URI@$PROXY;ext=user_ID@$PROXY

  • BLF 和快速拨号

    示例：fnc=blf+sd;sub=BLF_List_URI@$PROXY;ext=user_ID@$PROXY

  • BLF、快速拨号和呼叫代答

    示例：fnc=blf+sd+cp;sub=BLF_List_URI@$PROXY;ext=user_ID@$PROXY

其中， user_ID 表示受监控电话的 ID。

执行下列操作之一：

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

    <Extended_Function_1_>fnc=blf;sub=BLF_List_URI@$PROXY;ext=user_ID@$PROXY</Extended_Function_1_>

  • 在电话 Web 界面中，使用有效的语法配置参数，以便使用线路监控其他用户或分机。

默认值：空

为分机分配铃声

您还可以使用 XML(cfg.xml) 代码在电话配置文件中配置参数。 要配置每个参数，请参阅下表铃声参数中字符串的语法。

1

访问电话管理网页。

2

选择 Voice > Ext(n)，其中 (n) 是电话分机号码。

3

在 Call Feature Settings 部分，从列表中选择 Default Ring 参数，或选择不振铃。

您也可以通过输入以下格式的字符串，在配置文件 (cfg.xml) 中配置此参数： 

<Default_Ring_3_ ua="rw">1</Default_Ring_3_>
4

选择 Voice > Phone。

5

在 Ringtone 部分，如下表铃声参数中所述设置 Ring(n) 和 Silent Ring Duration 参数。

6

单击 Submit All Changes。

铃声参数

下表介绍了电话网页 Voice > Phone 选项卡中 Ringtone 部分的参数。

表 6. 铃声参数

参数

说明

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) 中输入以下格式的字符串：

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

自定义铃声模式

您可以使用振铃音脚本配置每个振铃音的特征。 当电话收到 SIP Alert-INFO 消息且消息格式正确时，电话将播放指定的铃声。 否则，电话将播放默认铃声。

在振铃音脚本中，为振铃音指定名称，并按以下格式添加脚本以配置独特的铃声：

n=ring-tone-name;h=hint;w=waveform-id-or-path;c=cadence-id;b=break-time;t=total-time

其中：

n = ring-tone-name 用于标识此振铃音。 此名称会显示在电话的振铃音菜单上。 可以在入站 INVITE 请求的 SIP Alert-Info 标头中使用相同的名称，以告知电话播放相应的振铃音。 该名称应仅包含允许在 URL 中使用的字符。

h = hint 用于 SIP Alert-INFO 规则。

w = waveform-id-or-path 是用于此振铃音中的所需波形的索引。 内置的波形包括：

  • 1 = 带有机械铃的传统电话

  • 2 = 典型电话振铃

  • 3 = 经典铃声

  • 4 = 宽带频率扫频信号

c = 是播放指定波形所需节奏的索引。 8 个节奏 (1–8) 在 <节奏 1> 到 <节奏 8> 中定义。 如果 w=3.4，则 Cadence id 可以为 0。 设置 c = 0 表示接通持续时间是振铃音文件的自然长度。

b = break-time 指定在两次振铃音突发之间断开的秒数，例如 b=2.5。

t = total-time 指定在超时前播放振铃音的总秒数。

在电话配置 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>

当您在电话上启用 BroadSoft 的 Hoteling 功能时，用户可以作为访客登录到电话。 在访客从电话注销后，用户将切换回主机用户。

您还可以使用 XML(cfg.xml) 代码在电话配置文件中配置参数。

1

访问电话管理网页。

2

选择 Voice > Ext [n] （其中 [n] 是分机号码）。

3

在呼叫功能设置部分，将启用 Broadsoft Hoteling 参数设置为是。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

<Enable_Broadsoft_Hoteling_1_ua="na">Yes</Enable_Broadsoft_Hoteling_1>

选项：Yes 和 No

默认值：No

4

在 Hoteling 订用到期中设置用户可作为访客登录电话的时间（以秒为单位）。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

<Hoteling_Subscription_Expires_1_ua="na">3600</Hoteling_Subscription_Expires_1>

有效值：介于 10 到 86400 之间的整数

默认值：3600

5

单击 Submit All Changes。

配置问题报告工具

您必须使用带上传脚本的服务器来接收用户从电话发送的问题报告。

  • 如果 PRT 上传规则字段中指定的 URL 有效，用户会在电话用户界面上收到说明他们已成功提交问题报告的通知警报。

  • 如果 PRT 上传规则字段为空或 URL 无效，则用户会在电话用户界面上收到说明数据上传失败的通知警报。

电话使用 HTTP/HTTPS POST 机制，其参数与基于 HTTP 表单的上传类似。 上传中包含以下参数（使用多部分 MIME 编码）：

  • devicename（例如： "SEP001122334455"）

  • serialno（例如："FCH12345ABC"）

  • username（用户名是分机的基站显示名称或用户 ID。 首先考虑基站显示名称。 如果此字段为空，则选择用户 ID。)

  • prt_file（例如： "probrep-20141021-162840.tar.gz"）

您可以以指定的时间间隔自动生成 PRT，并可以定义 PRT 文件名称。

您还可以使用 XML(cfg.xml) 代码配置电话配置文件中的参数。 要配置每个参数，请参阅下表问题报告工具中字符串的语法。

示例脚本如下所示。 此脚本仅供参考。 思科不支持客户服务器上安装的上传脚本。 

<？php // 注意：您可能需要编辑 php.ini 文件以允许更大的 // 大小的文件上传。 修改我使用的 upload_max_filesize // 的设置：upload_max_filesize = 20M // 检索上传文件的名称$filename = basename（$_FILES['prt_file']['name']）;去掉设备名称、序列号和用户名（如果存在）$devicename = $_POST['设备名称']的引号;$devicename = trim（$devicename，“'\”“）;$serialno = $_POST['序列'];$serialno = trim（$serialno，“'\”“）;$username = $_POST['用户名'];$username = trim（$username，“'\”“）;放置文件的位置 $fullfilename =“/var/prtuploads/”.$filename;如果文件上传不成功，则返回 500 错误并 // 通知用户重试 if（！move_uploaded_file（$_FILES['prt_file']['tmp_name']，$fullfilename））{ header（“HTTP/1.0 500 Internal Server Error”）; die（“错误：您必须选择要上传的文件。”）; }？>
1

访问电话管理网页。

2

选择 Voice > Provisioning。

3

在问题报告工具部分中，按照下表问题报告工具参数中的描述设置字段。

4

单击 Submit All Changes。

问题报告工具参数

表 7. 问题报告工具参数

参数

说明

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">总是</PRT_HTTP_Header_Value>

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

    总是

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

除下划线 (_) 外，第一个字符不能是特殊字符。

默认值：空

下载问题报告

用户使用问题报告工具向您提交问题报告。

如果您在使用 Cisco TAC 排除问题，通常需要问题报告工具提供的日志，以帮助解决问题。

要发布问题报告，用户需访问问题报告工具并提供发生问题的日期和时间以及问题描述。 您需要从电话管理网页下载问题报告。

1

访问电话管理网页。

2

选择 Info > Debug Info > Device Logs。

3

在 Problem Reports 区域，单击要下载的问题报告文件。

4

将文件保存到本地系统，然后打开文件以访问问题报告日志。

使用 TR-069 配置电话

您可以使用《技术报告 069 号协议》(TR 069) 中定义的协议和标准来管理电话。 TR-069 介绍管理所有电话和大型部署中的其他用户驻地设备 (CPE) 的公共平台。 该平台与电话类型和制造商无关。

TR-069 是一种基于 SOAP/HTTP 的双向协议，支持 CPE 和自动配置服务器 (ACS) 之间的通信。

您还可以使用 XML(cfg.xml) 代码配置电话配置文件中的参数。 要配置每个参数，请参阅下表 TR-069 配置参数中字符串的语法。

1

访问电话管理网页。

2

选择 Voice > TR-069。

3

按照下表 TR-069 配置参数所述设置字段。

4

单击 Submit All Changes。

TR-069 配置参数

TR-069 配置参数

下表定义了电话 Web 界面中 Voice > TR-069 选项卡下 TR-069 参数的功能和用法。 它还定义了电话配置文件中添加的字符串的语法，其中包含用于配置参数的 XML(cfg.xml) 代码。

表 8. TR-069 配置参数

参数

说明

Enable TR-069

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

执行下列操作之一：

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

    <Enable_TR-069 ua="na">No</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 验证的有效用户名。

默认值：空

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_Username 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">Yes</Periodic_Inform_Enable>

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

有效值：Yes|No

默认值：Yes

TR-069 Traceability

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

执行下列操作之一：

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

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

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

有效值：Yes|No

默认值：No

CWMP V1.2 Support

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

执行下列操作之一：

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

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

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

有效值：Yes|No

默认值：Yes

TR-069 VoiceObject Init

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

执行下列操作之一：

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

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

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

有效值：Yes|No

默认值：Yes

TR-069 DHCPOption Init

此设置用于修改 DHCP 设置。

执行下列操作之一：

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

    <TR-069_DHCPOption_Init ua="na">Yes</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 username</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。

默认值：空

如果未配置上述参数，您也可以通过 DHCP 选项 60、43 和 125 来获取这些参数。

查看 TR-069 状态

当您在用户电话上启用 TR-069 时，即可在电话 Web 界面查看 TR-069 参数的状态。

1

访问电话管理网页。

2

选择 Info > Status > TR-069 Status。

您可以配置分机以仅接受安全呼叫。 如果分机配置为仅接受安全呼叫，则分机发出的任何呼叫都将是安全的。

您还可以使用 XML(cfg.xml) 代码配置电话配置文件中的参数。

开始之前

使用 TLS 的 SIP 传输可以在电话网页上静态设置，也可以使用 DNS NAPTR 记录中的信息自动设置。 如果将电话分机的 SIP 传输参数设置为 TLS，则电话仅允许 SRTP。 如果 SIP 传输参数设置为 AUTO，电话将执行 DNS 查询以获取传输方法。

1

访问电话管理网页。

2

选择 Voice > Phone。

3

在补充服务部分，将安全呼叫服务设置为是。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

<Secure_Call_Serv ua="na">是</Secure_Call_Serv>
4

选择 Voice > Ext(n)。

5

在 Call Feature Settings 部分，将 Secure Call Option 设置为 Optional、Required 或 Strict。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

<Secure_Call_Option_1_ ua="na">Optional</Secure_Call_Option_1_>

选项：Optional、Required 和 Strict

  • Optional - 保留电话的当前安全呼叫选项。

  • Required－拒绝来自其他电话的不安全呼叫。

  • Strict - 仅当 SIP 传输设置为 TLS 时才允许 SRTP。 仅当 SIP 传输为 UDP/TCP 时才允许 RTP。

默认值：Optional

6

单击 Submit All Changes。

默认情况下，当有未读语音信息时，听筒 LED 将会闪烁。 您可以将电话配置为在未接呼叫时闪烁听筒 LED。

1

访问电话管理网页。

2

选择 Voice > User。

3

在 Supplementary Services 部分的 Handset LED Alert 参数中，选择 Voicemail, Missed Call。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

<Handset_LED_Alert ua="rw">语音邮件、未接呼叫</Handset_LED_Alert>

选项：Voicemail 和 Voicemail, Missed Call

默认值：Voicemail

4

单击 Submit All Changes。

该电话支持在一条线上同时进行多个通话。 您可以配置一条线路同时可以处理的允许呼叫数。 当一个呼叫处于活动状态时，其他呼叫可以保持或等待接听。

1

访问电话管理网页。

2

选择 Voice > Phone。

3

在 Miscellaneous Line Key Settings 部分，使用 Call Appearances Per Line 参数指定允许加入每条线路的呼叫数。

您也可以通过输入以下格式的字符串，在配置文件 (cfg.xml) 中配置此参数： 

<Call_Appearances_Per_Line ua="na">6</Call_Appearances_Per_Line>

允许的值范围从 2 到 10。缺省值为 2。

4

单击 Submit All Changes。

配置 SIP 传输

对于 SIP 消息，您可以配置要使用的每个分机：

  • 特定协议

  • 电话自动选择的协议

当您设置自动选择时，电话会根据 DNS 服务器上的名称颁发机构指针 (NAPTR) 记录确定传输协议。 电话使用记录中优先级最高的协议。

您还可以使用 XML(cfg.xml) 代码配置电话配置文件中的参数。

1

访问电话管理网页。

2

选择 Voice > Ext(n)，其中 n 是分机号码。

3

在 SIP Settings 部分，设置 SIP Transport 参数，为 SIP 消息选择传输协议。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

<SIP_Transport_n_ ua="na">UDP</SIP_Transport_n_>

其中 n 是分机号码。

选项：UDP、TCP、TLS 和 Auto

自动允许电话根据 DNS 服务器上的 NAPTR 记录自动选择适当的协议。

默认值：UDP

4

单击 Submit All Changes。

屏蔽电话的非代理 SIP 消息

您可以禁用电话从非代理服务器接收传入 SIP 消息的功能。 当您启用此功能时，电话只接受来自以下各项的 SIP 消息：

  • 代理服务器

  • 出站代理服务器

  • 备用代理服务器

  • 备用出站代理服务器

  • 来自代理服务器和非代理服务器的 IN-Dialog 消息。 例如：“呼叫会话”对话框和“订用”对话框

您还可以使用 XML(cfg.xml) 代码配置电话配置文件中的参数。

开始之前

1

访问电话管理网页。

2

选择 Voice > System。

3

在 System Configuration 部分，将 Block Nonproxy SIP 设置为 Yes，以屏蔽除对话消息外的任何传入非代理 SIP 消息。 如果您选择否，则电话不会屏蔽任何传入非代理 SIP 消息。

对于使用 TCP 或 TLS 传输 SIP 消息的电话，将 Block Nonproxy SIP 设置为 No。 默认屏蔽通过 TCP 或 TLS 传输的非代理 SIP 消息。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

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

选项：Yes 和 No

默认值：No

4

单击 Submit All Changes。

配置隐私标头

SIP 消息中的用户隐私标头设置来自受信任的网络的用户隐私需求。

您可以为每个线路分机设置用户隐私标头值。

1

访问电话管理网页。

2

选择 Voice > Extension。

3

在 SIP Settings 部分，设置 Privacy Header 参数以在受信任网络的 SIP 消息中设置用户隐私。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

<Privacy_Header_2_ ua="na">header</Privacy_Header_2_>

选项：

  • Disabled（默认值）

  • none—用户请求隐私服务不对此 SIP 消息应用隐私功能。

  • header—用户需要隐私服务来遮盖无法清除标识信息的标头。

  • session—用户请求隐私服务为会话提供匿名性。

  • user—用户请求仅通过中间人的隐私级别。

  • id—用户请求系统替换不显示 IP 地址或主机名的 id。

默认值：Disabled

4

单击 Submit All Changes。

启用 P-Early-Media 支持

您可以决定是否在去电 SIP 消息中包含 P-Early-Media 标头。 P-Early-Media 标头中包含早期媒体流的状态。 如果状态指示网络正在阻止早期媒体流，则电话将播放本地回铃音。 否则，电话会在等待呼叫接通时播放早期媒体。

您还可以使用 XML(cfg.xml) 代码配置电话配置文件中的参数。

1

访问电话管理网页。

2

选择语音 > 分机 (n)。

3

在 SIP Settings 部分，将 P-Early-Media Support 设置为 Yes，以控制是否在去电的 SIP 消息中包含 P-Early-Media 标头。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

<P-Early-Media_Support_1_ ua="na">No</P-Early-Media_Support_1_>

选项：Yes 和 No

默认值：No

4

单击 Submit All Changes。

在 SIP 消息中启用呼叫结束统计报告

您可以让电话在会话发起协议 (SIP) 消息（BYE 和 re‑INVITE 消息）中发送呼叫结束统计信息。 当呼叫终止或处于保留状态时，电话会向通话的另一方发送呼叫统计信息。 统计数据包括：

  • 发送或接收的实时传输协议 (RTP) 数据包

  • 发送或接收的总字节数

  • 丢失的数据包总数

  • 延迟抖动

  • 往返延迟 < 10 ms

  • 呼叫持续时间

呼叫统计信息作为标头发送到 SIP BYE 消息和 SIP BYE 响应消息（200 OK 并在保留期间 re-INVITE）。 对于音频会话，标头为 RTP-RxStat 和 RTP-TxStat。 对于视频会话，标头是 RTP-VideoRxStat 和 RTP-VideoTxStat。

SIP BYE 消息中呼叫统计信息的示例： 

Rtp-Rxstat: Dur=13,Pkt=408,Oct=97680,LatePkt=8,LostPkt=0,AvgJit=0,VQMetrics="CCR=0.0017;ICR=0.0000;ICRmx=0.0077;CS=2;SCS=0;VoRxCodec=PCMU;CID=4;VoPktSizeMs=30;VoPktLost=0;VoPktDis=1;VoOneWayDelayMs=281;maxJitter=12;MOScq=4.21;MOSlq=3.52;network=ethernet;hwType=CP-8865;rtpBitrate=60110;rtcpBitrate=0"
Rtp-Txstat: Dur=13,Pkt=417,Oct=100080,tvqMetrics="TxCodec=PCMU;rtpbitrate=61587;rtcpbitrate=0
Rtp-Videorxstat: Dur=12;pkt=5172;oct=3476480;lostpkt=5;avgjit=17;rtt=0;ciscorxvm="RxCodec=H264 BP0;RxBw=2339;RxReso=1280x720;RxFrameRate=31;RxFramesLost=5;rtpBitRate=2317653;rtcpBitrate=0"
Rtp-Videotxstat: Dur=12;pkt=5303;oct=3567031;ciscotxvm="TxCodec=H264 BP0;TxBw=2331;TxReso=1280x720;TxFrameRate=31;rtpBitrate=2378020;rtcpBitrate=0"

有关呼叫统计信息中属性的描述，请参阅下表 SIP 消息中呼叫统计信息的属性。

您也可以在电话配置文件中使用 Call_Statistics 参数来启用此功能。

<Call_Statistics ua="na">No</Call_Statistics>
1

访问电话管理网页。

2

选择 Voice > SIP。

3

在 RTP Parameters 部分，将 Call Statistics 字段设置为 Yes，以使电话在 SIP BYE 和 re‑INVITE 消息中发送呼叫统计信息。

您也可以通过输入以下格式的字符串，在配置文件 (cfg.xml) 中配置此参数：

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

允许的值包括：是|否。 默认值为“否”。

4

单击 Submit All Changes。

SIP 消息中呼叫统计的属性

表 9. 音频：RTP RxStat 负载

属性

说明

必需

持续时间

媒体会话/呼叫的持续时间

是

数据包

已接收的 RTP 数据包数量

是

十月

已接收的 RTP 数据包八位组数量

否

LatePkt

已接收并因在缓冲窗口外而被丢弃的 RTP 数据包数量

是

LostPkt

丢失的 RTP 数据包数量

是

AvgJit

会话持续期间的平均抖动

是

VoRxCodec

已协商的流/会话编解码器

是

VoPktSizeMs

以毫秒为单位的数据包大小。

是

maxJitter

检测到的最大抖动

是

VoOneWayDelayMs

延迟/单向延迟

是

MOScq

会话的对话质量平均意见得分，参见 RFC https://tools.ietf.org/html/rfc3611

是

maxBurstPktLost

丢失的连续数据包最大数量

否

avgBurstPktLost

突发丢失的连续数据包平均数量。 此数字可配合总都丢失量使用，以比较损失对呼叫质量的影响。

否

networkType

设备所在网络的类型（如果可能）。

是

hwType

正在运行会话/媒体的硬件客户端。 与软客户端更相关，但对于硬件电话仍然有用。 例如，型号 CP-8865。

是

表 10. 音频：RTP-TxStat 负载

属性

说明

必需

持续时间

会话持续时间

是

数据包

已传输的 RTP 数据包数量

是

十月

已传输的 RTP 数据包八位组数量

是

TxCodec

传输编解码器

是

rtpBitRate

RTP 传输比特率总计（位/秒）

是

rctpBitRate

RCTP 传输比特率总计（位/秒）

是

表 11. 视频：RTP VideoRxStat 负载

属性

说明

必需

持续时间

会话持续秒数

是

数据包

已接收的数据包数量

是

十月

已接收的八位组数量

是

LostPkt

丢失的数据包数量

是

AvgJit

会话持续期间的平均抖动

是

RTT

端到端往返时间

是

CiscoRxVm.RxCodec

用于已接收视频流的视频编解码器

是

CiscoRxVm.RxBw

已接收视频流的协商带宽

否

CiscoRxVm.RxReso

已接收视频流的分辨率

是

CiscoRxVm.RxFrameRate

已接收视频流的帧速率

是

CiscoRxVm.RxFrameLost

已接收视频流的丢失帧

是

CiscoRxVm.rtpBitRate

RTP 比特率（以秒为单位，包括任何 FEC、重传等）。 用于估计带宽使用情况（位/秒）。

是

CiscoRxVm.rtcpBitRate

RTCP 比特率（以秒为单位，包括任何 FEC、重传等）。 用于估计带宽使用情况（位/秒）。

是

表 12. 视频：RTP VideoTxStat 负载

属性

说明

必需

持续时间

会话持续秒数

是

数据包

已传输的数据包数量

是

十月

已传输的八位组数量

是

CiscoTxVm.TxCodec

用于已传输视频流的视频编解码器

是

CiscoTxVm.TxBw

传输的视频流的协商带宽

否

CiscoTxVm.TxReso

已传输视频流的分辨率

是

CiscoTxVm.TxFrameRate

已传输视频流的帧速率

是

CiscoRxVm.rtpBitRate

RTP 比特率（以秒为单位，包括任何 FEC、重传等）。 用于估计带宽使用情况（位/秒）。

是

CiscoTxVm.rtcpBitRate

RTCP 比特率（以秒为单位，包括任何 FEC、重传等）。 用于估计带宽使用情况（位/秒）。

是

SIP 会话 ID

电话支持会话标识符。 此功能允许在符合 RFC 7989 的基于 IP 的多媒体通信系统中对 SIP 会话进行端到端跟踪。为了支持会话标识符，在 SIP 请求和响应消息中添加了会话-ID 标头。

会话标识符指标识符的值，而 Session-ID 指用于传递标识符的标头字段。

  • 如果用户发起呼叫，发送 SIP INVITE 消息时，电话将生成本地 UUID。

  • 当 UAS 收到 SIP-INVITE 时，电话将使用传入消息拾取本地 UUID、将其追加到接收的 Session-ID 标头并在响应中发送标头。

  • 在特定会话的所有 SIP 消息中保留相同的 UUID。

  • 电话会在使用其他功能（例如会议或转接）期间保留相同的本地 UUID。

  • 此标头在 REGISTER 方法中实现，所有 REGISTER 消息的本地 UUID 仍保持不变，直到电话无法 REGISTER 为止。

Session-ID 包含参与呼叫的每个用户代理的通用唯一标识符 (UUID)。 每个呼叫都包含两个 UUID：本地 UUID 和远程 UUID。 本地 UUID 是从原始用户代理生成的 UUID，而远程 UUID 是从终止用户代理生成的。 UUID 值以小写十六进制字符的字符串形式表示，其中 UUID 的最有效八位组排在最前面。 会话标识符由 32 个字符组成，并且在整个会话中保持不变。

会话 ID 格式

组件将实现 Session-ID，这已经成为全局会话 ID。

电话在 http 标头中传递的当前会话 ID 示例（为清楚起见，仅包括破折号）是 00000000-0000-0000-0000-5ca48a65079a。

会话 ID 格式：UUUUUUUUSSSS5000y000DDDDDDDDDDDD，其中

UUUUUUUU - 为会话随机生成的唯一 ID [0-9a-f-f]。 生成的新会话 ID 示例：

  • 电话摘机

  • 输入激活码以完成首个 SIP 首次注册（加入流程）

SSSS - 生成会话的源。 例如，如果源类型为 "Cisco MPP"，则源值 (SSSS) 可以是 "0100"。

Y - 8、9、A 或 B 中的任何值，应符合 UUID v5 RFC。

DDDDDDDDDDDD－电话的 MAC 地址。

SIP 消息中的会话 ID 示例

呼叫中对话消息（例如 INVITE/ACK/CANCEL/BYE/UPDATE/INFO/REFER 及其响应）以及呼叫外消息（基本上是 REGISTER）都支持此标头。

Request-Line: INVITE sip:901@10.89.107.37:5060 SIP/2.0 Session-ID: 298da61300105000a00000ebd5cbd5c1;remote=00000000000000000000000000000000

状态行：SIP/2.0 100 正在尝试会话标识：fbaa810a00105000a00000ebd5cc118b;遥控器=298DA61300105000a00000ebd5cbd5c1

Status-Line: SIP/2.0 180 Ringing Session-ID: fbaa810a00105000a00000ebd5cc118b;remote=298da61300105000a00000ebd5cbd5c1

Status-Line: SIP/2.0 200 OK Session-ID: fbaa810a00105000a00000ebd5cc118b;remote=298da61300105000a00000ebd5cbd5c1

Request-Line: ACK sip:901@10.89.107.37:5060 SIP/2.0 Session-ID: 298da61300105000a00000ebd5cbd5c1;remote=fbaa810a00105000a00000ebd5cc118b

Request-Line: BYE sip:901@10.89.107.37:5060 SIP/2.0 Session-ID: 298da61300105000a00000ebd5cbd5c1;remote=fbaa810a00105000a00000ebd5cc118b

Status-Line: SIP/2.0 200 OK Session-ID: fbaa810a00105000a00000ebd5cc118b;remote=298da61300105000a00000ebd5cbd5c1

启用 SIP 会话 ID

您可以启用 SIP 会话 ID 以克服对现有呼叫标识符的限制，并允许对 SIP 会话进行端到端跟踪。

1

访问电话管理网页。

2

选择 Voice > Ext(n)。

3

转至 SIP Settings 部分。

4

将 SIP SessionID Support 设置为 Yes。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

<SIP_SessionID_Support_1_ ua="na">Yes</SIP_SessionID_Support_1_>
5

单击 Submit All Changes。

DND 和呼叫转移状态同步

您可以在电话管理网页上配置设置，以启用电话和服务器之间的免打扰 (DND) 及呼叫前转状态同步。

有两种方法可以同步功能状态：

  • 功能键同步 (FKS)

  • XSI 同步

FKS 使用 SIP 消息来传达功能状态。 XSI 同步使用 HTTP 消息。 如果同时启用 FKS 和 XSI 同步，则 FKS 优先于 XSI 同步。 请参阅下表，了解 FKS 如何与 XSI 同步交互。

表 13. FKS 和 XSI 同步之间的交互

功能键同步

启用 XSI DND

启用 XSI CFWD

免打扰同步

CFWD 同步

是

是

是

是 (SIP)

是 (SIP)

是

否

否

是 (SIP)

是 (SIP)

是

否

是

是 (SIP)

是 (SIP)

否

是

是

是 (HTTP)

是 (HTTP)

否

否

是

否

是 (HTTP)

否

是

否

是 (HTTP)

否

否

否

否

否

否

使用功能密钥同步 (FKS) 启用 DND 和呼叫转移状态同步

如果您启用功能键同步 (FKS)，服务器上的呼叫前转和免打扰 (DND) 设置将同步到电话。 在电话上进行的 DND 和呼叫前转设置更改也会同步到服务器。

当线路上启用 FKS 时，该线路从服务器获取 DND 和呼叫转接设置，并且不与 Voice > User 选项卡上的设置同步。

1

访问电话管理网页。

2

选择 Voice > Ext [n] （其中 [n] 是分机号码）。

3

在 Call Feature Settings 部分，将 Feature Key Sync 字段设置为 Yes。

4

单击 Submit All Changes。

通过 XSI 服务启用呼叫转移状态同步

启用呼叫前转同步后，服务器上与呼叫前转相关的设置将同步到电话。 在电话上进行的呼叫前转设置更改也会同步到服务器。

开始之前

  • 在 Voice > Ext (n) 选项卡上配置 XSI 主机服务器和相应的凭证。

    • 当使用登录凭证进行 XSI 服务器验证时，在 XSI 线路服务部分输入 XSI 主机服务器、登录用户 ID 和登录密码。

    • 使用 SIP 凭证进行 XSI 服务器验证时，在 XSI 线路服务部分输入 XSI 主机服务器和登录用户 ID，在订用方信息部分输入验证 ID 和密码 。

  • 在 Voice > Ext (n) 的呼叫功能设置部分禁用功能键同步 (FKS)。

1

访问电话管理网页。

2

选择 Voice > Ext [n] （其中 [n] 是分机号码）。

3

在 XSI 线路服务部分，将启用 CFWD 参数设置为是。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

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

选项：Yes 和 No

默认值：No

4

单击 Submit All Changes。

通过 XSI 服务启用 DND 状态同步

如果启用免打扰 (DND) 同步，服务器上的 DND 设置将同步到电话。 在电话上进行的 DND 设置更改也会同步到服务器。

开始之前

  • 在 Voice > Ext (n) 选项卡上配置 XSI 主机服务器和相应的凭证。

    • 当使用登录凭证进行 XSI 服务器验证时，在 XSI 线路服务部分输入 XSI 主机服务器、登录用户 ID 和登录密码。

    • 使用 SIP 凭证进行 XSI 服务器验证时，在 XSI 线路服务部分输入 XSI 主机服务器和登录用户 ID，在订用方信息部分输入验证 ID 和密码 。

  • 在 Voice > Ext (n) 的呼叫功能设置部分禁用功能键同步 (FKS)。

1

选择 Voice > Ext [n] （其中 [n] 是分机号码）。

2

在 XSI 线路服务部分，将启用 DND 参数设置为是。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

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

选项：Yes 和 No

默认值：No

3

单击 Submit All Changes。

将屏蔽主叫方 ID 设置同步到服务器

您可以将电话上的屏蔽主叫方 ID 状态与 BroadWorks XSI 服务器上的线路 ID 屏蔽状态同步。 当您启用同步后，用户在屏蔽主叫方 ID 设置中进行的更改也会更改 BroadWorks 服务器设置。

您还可以使用 XML(cfg.xml) 代码配置电话配置文件中的参数。

1

访问电话管理网页。

2

选择 Voice > Ext(n)。

3

在 XSI Line Service 部分，设置 Block CID Enable 参数。 选择是可使用 XSI 界面允许同步屏蔽主叫方 ID 状态与服务器。 选择否将使用电话的本地屏蔽主叫方 ID 设置。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

<Block_CID_Enable_1_ ua="na">No</Block_CID_Enable_1_>

选项：Yes 和 No

默认值：No

4

单击 Submit All Changes。

您可以在有限的带宽条件下确定语音或视频数据的优先级。

您需要在电话的每条线路上单独配置优先级。

您可以为不同的流量区域配置不同的优先级。 例如，您可以通过在内部和外部线路上设置不同的配置来为内部和外部流量配置不同的优先级。 为进行有效的流量管理，请在组中的所有电话线路上指定相同的设置。

数据包的服务类型 (ToS) 字段确定数据包在数据流量中的优先级。 您可以通过为每条电话线路指定语音和视频数据包 ToS 字段的相应值来配置所需的优先级。

对于语音数据，电话应用通过 LLDP 接收的 ToS 值。 没有通过 LLDP 提供的 ToS 值时，电话会应用您为语音数据包指定的值。

对于视频数据，电话始终应用您为视频数据包指定的 ToS 值。

默认值语音优先于视频。

您还可以使用 XML(cfg.xml) 代码配置电话配置文件中的参数。 要配置每个参数，请参阅下表确定语音和视频数据优先级的参数中的字符串语法。

1

访问电话管理网页。

2

选择 Voice > Ext(n)，其中 n 是分机号码。

3

在网络设置部分中，请按照下表确定语音和视频数据优先级的参数中所述设置参数值。

4

单击 Submit All Changes。

确定语音和视频数据优先级的参数

下表定义了电话 Web 界面中 Voice > Ext(n) 选项卡下 Network Settings 部分中 Configure Priorities for Voice and Video Data 参数的功能和用法。 它还定义了电话配置文件中添加的字符串的语法，其中包含用于配置参数的 XML(cfg.xml) 代码。

表 14. 将活动呼叫移动到位置的参数

参数

说明

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 字段输入有效的值。 .

默认值：

您可以为电话配置远程 SDK。 远程 SDK 提供了一个基于 WebSocket 的协议，通过该协议可以控制电话。

开始之前

WebSocket 服务器的运行地址和端口必须可从电话访问。

1

选择 Voice > Phone。

2

转至 WebSocket API 部分。

3

按照 WebSocket API 参数的下表所述设置 Control Server URL 和 Allowed API 字段。

4

单击 Submit All Changes。

WebSocket API 参数

下表定义了电话网页的 Voice > Phone 选项卡中 WebSocket API 部分中每个参数的功能和用法。 它还定义了电话配置文件中添加的字符串的语法，其中包含用于配置参数的 XML(cfg.xml) 代码。

表 15. WebSocket API 参数

参数名称

描述和默认值

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

我们建议使用安全连接。

默认值：空。

默认情况下，电话的翻转计数器（ROC）在发生重新键控后保留其值，因为 SSRC、IP 或端口不会更改。 这是为了符合 RFC 3711。

但是，如果远程端不完全符合 RFC 3711，则当 IP 电话和远程端进行安全呼叫时，可能会导致某些互操作问题（例如，单向音频问题）。

要增强电话在这种情况下的兼容性，您可以启用 ROC 重置。

1

访问电话管理网页。

2

选择 Voice > SIP。

3

在 RTP 参数部分中，将参数 RX ROC 重新键入 时重置设置为 是。

也可以在配置文件中配置此参数：

<RX_ROC_Reset_on_Re-Key ua=“na”>Yes</RX_ROC_Reset_on_Re-Key>

允许的值：Yes 和 No。

默认值：No

如果将该参数设置为 Yes，电话将在重新生成密钥后重置 Rx ROC 值，而不更改 SSRC/IP/端口。 如果设置为 否，电话将在重新生成密钥后保留 Rx ROC 值，而不会更改 SSRC/IP/端口。

4

单击 Submit All Changes。

您可以设置组播寻呼，以允许用户向其他电话发送寻呼消息。 寻呼可以转至同一网络中的所有电话或一组电话。 组中的任意电话都可以发起多播寻呼会话。 仅设置为侦听寻呼组的电话会收到寻呼。

一部电话最多可添加至 10 个寻呼组。 每个寻呼组都有一个唯一的多播端口和号码。 寻呼组中的电话必须订用到相同的多播 IP 地址、端口和多播号码。

您可以从特定组配置传入寻呼的优先级。 当电话处于活动状态并且必须播放重要寻呼时，用户会在活动音频路径上听到寻呼。

出现多个寻呼会话时，会按时间顺序应答。 在活动寻呼结束之后，会自动应答下一个寻呼。 当免打扰（DND）应用于电话上的所有线路而不是特定线路时，电话将忽略任何呼入。

您可以指定寻呼要使用的编解码器。 支持的编解码器包括 G711a、G711u、G722 和 G729。 如果不指定编解码器，寻呼默认使用 G711u。

您还可以让电话从服务器接收页面，以选择性地显示图像或其他 UI 元素。 借助此功能，可以在组播寻呼期间调用 XML 服务。 要启用此功能，请配置参数 XML 应用程序服务 URL ，并在 Voice>Phone 的 寻呼组脚本中添加“ xmlapp=yes ”。 有关参数的更多信息，请参阅 XML BroadWorks 上电话的应用程序配置和 多寻呼组的参数。

您还可以使用 XML(cfg.xml) 代码配置电话配置文件中的参数。 若要配置每个参数，请参阅多寻呼组 的参数中的字符串语法。

开始之前

  • 确保您的网络支持多播，以便同一寻呼组中的所有设备都能接收寻呼。
  • 对于 Wi-Fi 网络，为多播启用并正确配置接入点。
  • 确保寻呼组中的所有电话都在同一网络中。
1

访问电话管理网页。

2

选择 Voice > Phone。

3

请转至 Multiple Paging Group Parameters 部分。

4

输入多播寻呼脚本，如以下多寻呼组 参数表中的定义。

5

单击 Submit All Changes。

多寻呼组的参数

下表定义了电话管理页面中多个寻呼组参数的功能和用法。

它还定义在电话配置文件（cfg.xml）中添加以配置参数的字符串的语法。

表 16. 多个寻呼组参数
参数说明
组 1 分页脚本–第 10 组分页脚本

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

  • 组播寻呼：

    pggrp=<multicast-address>：<port>;<名称=group_name>;<num=multicast_number>;<听=boolean_value>;<pri=priority_level>;<编解码器=codec_name>;

    示例脚本：

    pggrp=224.168.168.168:34560;名称=Group_1;num=800;听=是;pri=1;

  • 支持 XML 应用程序的组播分页：

    pggrp=<multicast-address>：<port>;<名称=group_name>;<num=multicast_number>;<听=boolean_value>;<pri=priority_level>;<编解码器=codec_name>;<xmlapp=boolean_value>;<超时=秒>

    示例脚本：

    pggrp=224.168.168.168:34560;名称=Group_1;num=800;听=是;pri=1;xmlap- p = 是；超时 = 3600;

  • 多播 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 应用程序（xmlapp）—指定电话在通过寻呼组接收音频时是否联系 XML 应用程序服务器。 将此参数设置为 Yes 可使电话从多播寻呼调用 XML 应用程序。 否则，将其设置为 no。

    请确保 已配置 XML 服务中的参数 XML 应用程序服务 URL ，有关详细信息，请参阅 XML 服务 。

    在 XML URL 中，必须配置宏 MCASTADDR 以区别于普通多播分页。 例如， https://<url>?mcast=$MCASTADDR

  • 超时—（可选）指定电话屏幕上显示的 XML 应用程序消息的超时时间（秒）。 如果未配置该参数，则 XML 应用程序消息将随分页一起消失。

    通常，无论进行何种寻呼调用，XML 应用程序都会在超时后结束。 如果寻呼呼叫仍然处于活动状态，则只有 XML 应用程序结束。

    如果在最后一次寻呼结束时 XML 应用程序未关闭，则新寻呼将关闭最后一个分页的 XML 应用程序。

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

<Group_1_Paging_Script ua=“na”>pggrp=224.168.168.168:34560;名称=Group_1;num=800;听=是;pri=1;编解码器 = g722;xmlap- p = 是；超时 = 3600;</Group_1_Paging_Script>

默认值：空

寻呼功能使用户能够通过电话直接与其他用户联系。 如果被寻呼者的电话已配置为自动应答寻呼，则该电话不会响铃。 而是在发起寻呼时，自动在两部电话之间建立直接连接。

您还可以使用 XML(cfg.xml) 代码配置电话配置文件中的参数。

开始之前

1

访问电话管理网页。

2

选择 Voice > User。

3

在 Supplementary Services 部分，为 Auto Answer Page 参数选择 Yes。

您可以通过输入以下格式的字符串，在电话配置 XML 文件 (cfg.xml) 中配置此参数：

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

选项：Yes 和 No

默认值：Yes

4

单击 Submit All Changes。