在思科会议服务器空间中配置DTMF序列

简介

本文档介绍配置DTMF序列以允许用户在思科会议服务器(CMS)空间上执行操作的步骤。

先决条件

要求

Cisco 建议您了解以下主题：

• 思科会议服务器
• DTMF

使用的组件

本文档中的信息基于以下软件和硬件版本：

• 运行软件版本3.8的思科会议服务器

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

背景信息

在CMS中可为空间参与者定义自定义DTMF序列，以用于调用影响空间及其参与者的操作。例如，参与者可以使用DTMF序列切换其自己的音频静音、开始或停止会议流或结束会议。

dtmfProfile定义用于调用每个可用特定操作的DTMF序列。通过CMS API将dtmfProfile分配到系统/配置文件,DTMF序列可全局使用。通过创建对每个操作具有不同权限的callLegProfiles，并在API的不同级别应用这些操作，可以对DTMF操作的限制进行微调。

配置

1.创建dtmfProfile对象并将其全局应用

要创建dtmfProfile对象，请执行以下操作：

1.登录CMS Web管理员页面。

2.导航到配置 > API。

3.导航至/api/v1/dtmfProfiles部分，并 展开它。

4.单击新建。

5.定义用于执行所需操作的DTMF序列。在本示例中，为toggleMuteSelfAudio和endCall操作定义DTMF序列。

6.单击创建。

要全局应用dtmfProfile，请执行以下操作：

1.定位至配置 > API。

2.导航到/api/v1/system/profiles部分并展开该部分。

3.单击查看或编辑。

4.在dtmfProfile设置中，单击选择，然后选择以前创建的对象。

5.单击修改。

2.微调权限以执行DTMF操作

可通过配置callLegProfiles实现对执行DTMF操作的权限的精细控制，该配置文件可在API中的不同级别应用。下图说明了所有可能的级别：

callLegProfile的应用级别决定其范围。在较低级别分配的配置文件会覆盖以上设置的配置文件。这些示例说明了如何利用此原则允许仅向特定空间或用户调用DTMF操作。

仅允许特定空间中的操作

可以在/system/profiles级别创建和应用callLegProfile，以取消执行DTMF操作的权限。然后，可以在coSpace级别创建并应用另一个允许操作的callLegProfile，因此将权限范围限制为特定coSpace(或一组coSpaces，如果应用于多个)。

1.定位至配置 > API。

2.导航到/api/v1/callLegProfiles部分并将其展开。

3.单击新建。

4.定位至需要禁止的操作，并将其设置为false。

5.单击创建。

在本示例中，通过将endCallAllowed设置为false，创建了callLegProfile，以禁止结束会议：

6.将其分配到系统/配置文件，以全局禁止此操作：

7.创建新的callLegProfile，此次允许执行操作。在本示例中，创建了callLegProfile，并将endCallAllowed设置为true:

8.导航到配置 > API > /api/v1/coSpaces，然后展开它。

9.找到要为其分配的coSpace，然后在callLegProfile下选择您创建的用于允许操作的coSpace。

由于此callLegProfile应用于较低的API级别，因此它将覆盖以前应用于/system/profiles的callLegProfile，从而导致只能从此特定coSpace调用DTMF操作。

仅允许具有密码的用户执行操作

权限范围可以缩小到需要特殊权限的一组用户，如视频操作员。可以使用自己的目录号码创建accessMethod，以使用实际支持DTMF操作的特定callLegProfile访问coSpace。

1.导航到配置 > API > /api/v1/coSpaces，然后展开它。

2.从列表中选择要为其创建accessMethod的coSpace。

3.从Related objects列表中，单击/api/v1/coSpaces/<coSpace ID>/accessMethods链接：

4.在uri字段中，输入特权用户可拨入此空间的号码。

5.创建密码。当特权用户拨打accessMethod号码时，他们需要输入此代码，后接#号才能进入会议。

6.在callLegProfile下，选择允许结束呼叫的呼叫。

7.（可选）输入accessMethod的名称，使其可以从API资源管理器中轻松识别。

在本示例中，为视频操作员创建了一个编号为3001的accessMethod，以供他们在加入coSpace时使用(目录编号3000已分配给coSpace，普通用户拨打此号码以加入此空间中的会议)。它受密码保护，允许终止呼叫的callLegProfile被专门分配给它。

8.通过将callLegProfile分配到系统/配置文件全局应用禁止操作的callLegProfile。

在本示例中，无需将callLegProfile分配给coSpace本身。它继承全局应用的配置文件，因此通过拨打coSpace号(3000)加入会议的用户无权通过DTMF结束呼叫。

由于此配置，视频操作员可以通过拨打accessMethod号(3001)而不是coSpace号(3000)加入会议。它们的呼叫分支使用允许应用该操作的callLegProfile，因此只有它们可以使用定义的DTMF序列结束呼叫。

相关信息

CMS 3.8 API参考指南