快速入門:處理語音和視訊通話事件
重要
本文所述的功能目前處於公開預覽狀態。 此預覽版本沒有服務等級協定,不建議用於處理生產工作負載。 可能不支援特定功能,或可能已經限制功能。 如需詳細資訊,請參閱 Microsoft Azure 預覽版增補使用條款。
使用 Azure 事件方格來處理通訊服務語音和視訊通話事件,以開始使用 Azure 通訊服務。
關於 Azure 事件方格
Azure Event Grid 是一項雲端式事件服務。 在本文中,您將了解如何訂閱通訊服務事件的事件,並觸發事件以檢視結果。 通常,您會將事件傳送至可處理事件資料及採取行動的端點。 在本文中,您會將事件傳送至可收集及顯示訊息的 Web 應用程式。
必要條件
- 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
- Azure 通訊服務資源。 如需進一步的詳細資料,請參閱建立 Azure 通訊服務資源快速入門。
- 已啟用 Azure 通訊服務語音和視訊通話的用戶端。 將語音電話新增至應用程式。
設定
啟用事件格線資源提供者
如果您先前在 Azure 訂用帳戶中未曾使用過事件方格,您可能必須依照下列步驟註冊事件方格資源提供者:
在 Azure 入口網站中:
- 選取左側功能表上的 [訂用帳戶]。
- 選取您用於「事件方格」的訂用帳戶。
- 在左側功能表的 [設定] 下,選取 [資源提供者] 。
- 尋找 Microsoft.EventGrid。
- 如果未註冊,請選取 [註冊]。
可能需要一點時間才能完成註冊。 選取 [重新整理] 來更新狀態。 當 [狀態] 是 [已註冊] 時,代表已準備好繼續進行。
事件方格檢視器部署
在本快速入門中,我們將使用 Azure 事件方格檢視器範例,以近乎即時的方式檢視事件。 這會為使用者提供即時摘要的體驗。 此外,每個事件的承載應該也都可供查看。
使用 Webhook 訂閱語音和視訊通話事件
在入口網站中,瀏覽至您已建立的 Azure 通訊服務資源。 在通訊服務資源內,從 [通訊服務] 頁面的左側功能表中選取 [事件]。
按 [新增事件訂用帳戶],進入建立精靈。
在 [建立事件訂用帳戶] 頁面上,輸入事件訂用帳戶的名稱。
您可以訂閱特定事件,以向事件方格指出您要訂閱的語音和視訊事件,以及要將事件傳送至何處。 從下拉式功能表中選取您要訂閱的事件。 對於語音和視訊通話,您可以選擇 Call Started
、Call Ended
、Call Participant added
和 Call Participant Removed
。
如果系統提示您提供 [系統主題名稱],請隨意提供唯一的字串。 此欄位不會影響您的體驗,其用途為內部遙測。
查看 Azure 通訊服務支援的事件的完整清單。
選取 [WebHook] 作為 [端點類型]。
針對 [端點],按一下 [選取端點],然後輸入 Web 應用程式的 URL。
在此案例中,我們將使用先前在本快速入門中設定的 Azure 事件方格檢視器範例的 URL。 該範例的 URL 格式如下:https://{{site-name}}.azurewebsites.net/api/updates
然後,選取 [確認選取項目]。
檢視語音和視訊通話事件
觸發語音和視訊通話事件
若要檢視事件觸發程序,我們必須先產生事件。
- 開始 Azure 通訊服務語音和視訊通話時,會產生
Call Started
事件。 若要觸發此事件,只要開始與通訊服務資源連結的通話即可。 - 當 Azure 通訊服務語音和視訊通話結束時,會產生
Call Ended
事件。 若要觸發此事件,請結束與通訊服務資源連結的通話。 - 將參與者新增至 Azure 通訊服務語音和視訊通話時,就會產生
Call Participant Added
事件。 若要觸發此事件,請將參與者新增至與通訊服務資源連結的 Azure 通訊服務語音和視訊通話。 - 將參與者從 Azure 通訊服務語音和視訊通話中移除時,會產生
Call Participant Removed
事件。 若要觸發此事件,請將參與者從與通訊服務資源連結的 Azure 通訊服務語音和視訊通話中移除。
查看 Azure 通訊服務支援的事件的完整清單。
接收語音和視訊通話事件
當您完成上述任一動作後,您會看到語音和視訊通話事件傳送至端點。 這些事件會顯示在我們一開始設定的 Azure 事件方格檢視器範例中。 您可以按事件旁的眼睛圖示,以查看整個承載。
深入了解事件結構描述和其他事件處理概念。
清除資源
如果您想要清除並移除通訊服務訂用帳戶,您可以刪除資源或資源群組。 刪除資源群組也會刪除與其相關聯的任何其他資源。 深入了解如何清除資源。
您可能也會想要: