在思科會議伺服器空間中配置DTMF序列

簡介

本文檔介紹配置DTMF序列以允許使用者在Cisco Meeting Server (CMS)空間上執行操作的步驟。

必要條件

需求

思科建議您瞭解以下主題：

• 思科會議伺服器
• DTMF

採用元件

本文中的資訊係根據以下軟體和硬體版本：

• 運行軟體版本3.8的思科會議伺服器

本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除（預設）的組態來啟動。如果您的網路運作中，請確保您瞭解任何指令可能造成的影響。

背景資訊

可以在CMS中為空間參與者定義自定義DTMF序列，以呼叫影響空間及其參與者的操作。例如，參與者可以使用DTMF序列切換其自己的音訊靜音、開始或停止會議流或結束會議。

dtmfProfile 定義了用於呼叫每個可用特定操作的DTMF序列。透過CMS API將dtmfProfile 分配到system/profiles，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（可以在API中的不同級別應用），可以實現對執行DTMF操作的許可權的精細控制。此圖表說明所有可能的層次：

應用callLegProfile的級別將決定其範圍。在較低層次指定的設定檔會覆寫以上設定的設定檔。這些示例說明如何利用此原則只允許對某些空間或使用者呼叫DTMF操作。

僅允許在特定空間中執行動作

可在/system/profiles級別建立和應用否定執行DTMF操作的許可權的callLegProfile。然後，可以在coSpace級別建立和應用另一個允許這些操作的callLegProfile，因此，將許可權範圍限制到特定的coSpace(或一組coSpaces，如果應用於多個的話)。

1. 導航到配置 > API。

2. 導航到/api/v1/callLegProfiles部分並將其展開。

3. 按一下新建。

4. 切換作業選項至需要禁止的作業，並將它們設為false。

5. 按一下建立。

在本示例中，已建立callLegProfile，透過將endCallAllowed設定為false禁止結束會議：

6. 將其分配給系統/配置檔案，以全局禁止此操作：

7. 建立新的callLegProfile，這次允許此操作。在本示例中，建立了callLegProfile，並將endCallAllowed設定為true：

8. 導航到配置 > API > /api/v1/coSpaces並將其展開。

9. 查詢您要分配到的coSpace，然後在callLegProfile下選擇您建立的用於允許執行的操作。

因為此callLegProfile是在較低的API級別應用的，所以它將覆蓋先前應用到/system/profiles的callLegProfile，從而只能從此特定coSpace中呼叫DTMF操作。

僅允許具有密碼的使用者執行動作

許可權範圍可縮小至一組需要特殊許可權的使用者，例如視訊操作員。可以使用自己的電話號碼建立accessMethod，以訪問具有實際允許執行DTMF操作的特定callLegProfile的coSpace。

1. 導航到配置 > API > /api/v1/coSpaces並將其展開。

2. 從清單中選擇要為其建立accessMethod的coSpace。

3. 從相關對象清單中，按一下/api/v1/coSpaces/<coSpace ID>/accessMethods連結：

4. 在uri欄位中，輸入特權使用者可撥入此空間的號碼。

5. 建立密碼。當特權使用者撥打accessMethod號碼時，他們需要輸入此代碼，後跟#號以獲准進入會議。

6. 在callLegProfile下，選擇允許結束呼叫的呼叫。

7. 選擇性地輸入accessMethod的名稱，以便從API瀏覽器中輕鬆辨識它。

在本示例中，為影片操作員建立編號為3001的accessMethod，以便在加入coSpace時使用(目錄號3000已分配給coSpace，普通使用者撥打此號碼以加入此空間中的會議)。它受口令保護，並且允許結束呼叫的callLegProfile被專門分配給它。

8. 透過將callLegProfile分配給system/profiles來全局應用禁止執行的操作。

在本示例中，不需要將callLegProfile分配給coSpace本身。它繼承全局應用的配置檔案，因此透過撥打coSpace號碼(3000)加入會議的使用者無權透過DTMF結束呼叫。

由於此配置，影片操作員可以透過撥打accessMethod號碼(3001)而不是coSpace號碼(3000)加入會議。他們的呼叫段使用允許應用該操作的callLegProfile，因此只有他們才能使用定義的DTMF序列結束呼叫。

相關資訊

CMS 3.8 API參考指南