快速入門:處理語音和視訊通話事件

重要

本文所述的功能目前處於公開預覽狀態。 此預覽版本沒有服務等級協定,不建議用於處理生產工作負載。 可能不支援特定功能,或可能已經限制功能。 如需詳細資訊,請參閱 Microsoft Azure 預覽版增補使用條款

使用 Azure 事件方格來處理通訊服務語音和視訊通話事件,以開始使用 Azure 通訊服務。

關於 Azure 事件方格

Azure Event Grid 是一項雲端式事件服務。 在本文中,您將了解如何訂閱通訊服務事件的事件,並觸發事件以檢視結果。 通常,您會將事件傳送至可處理事件資料及採取行動的端點。 在本文中,您會將事件傳送至可收集及顯示訊息的 Web 應用程式。

必要條件

設定

啟用事件格線資源提供者

如果您先前在 Azure 訂用帳戶中未曾使用過事件方格,您可能必須依照下列步驟註冊事件方格資源提供者:

在 Azure 入口網站中:

  1. 選取左側功能表上的 [訂用帳戶]
  2. 選取您用於「事件方格」的訂用帳戶。
  3. 在左側功能表的 [設定] 下,選取 [資源提供者] 。
  4. 尋找 Microsoft.EventGrid
  5. 如果未註冊,請選取 [註冊]

可能需要一點時間才能完成註冊。 選取 [重新整理] 來更新狀態。 當 [狀態] 是 [已註冊] 時,代表已準備好繼續進行。

事件方格檢視器部署

在本快速入門中,我們將使用 Azure 事件方格檢視器範例,以近乎即時的方式檢視事件。 這會為使用者提供即時摘要的體驗。 此外,每個事件的承載應該也都可供查看。

使用 Webhook 訂閱語音和視訊通話事件

在入口網站中,瀏覽至您已建立的 Azure 通訊服務資源。 在通訊服務資源內,從 [通訊服務] 頁面的左側功能表中選取 [事件]

Screenshot showing selecting the event subscription button within a resource's events page.

按 [新增事件訂用帳戶],進入建立精靈。

在 [建立事件訂用帳戶] 頁面上,輸入事件訂用帳戶的名稱

您可以訂閱特定事件,以向事件方格指出您要訂閱的語音和視訊事件,以及要將事件傳送至何處。 從下拉式功能表中選取您要訂閱的事件。 對於語音和視訊通話,您可以選擇 Call StartedCall EndedCall Participant addedCall Participant Removed

如果系統提示您提供 [系統主題名稱],請隨意提供唯一的字串。 此欄位不會影響您的體驗,其用途為內部遙測。

查看 Azure 通訊服務支援的事件的完整清單。

Screenshot showing the calling event types being selected.

選取 [WebHook] 作為 [端點類型]

Screenshot showing the Endpoint Type field being set to Web Hook.

針對 [端點],按一下 [選取端點],然後輸入 Web 應用程式的 URL。

在此案例中,我們將使用先前在本快速入門中設定的 Azure 事件方格檢視器範例的 URL。 該範例的 URL 格式如下:https://{{site-name}}.azurewebsites.net/api/updates

然後,選取 [確認選取項目]

Screenshot showing confirming a Web Hook Endpoint.

檢視語音和視訊通話事件

觸發語音和視訊通話事件

若要檢視事件觸發程序,我們必須先產生事件。

  • 開始 Azure 通訊服務語音和視訊通話時,會產生 Call Started 事件。 若要觸發此事件,只要開始與通訊服務資源連結的通話即可。
  • 當 Azure 通訊服務語音和視訊通話結束時,會產生 Call Ended 事件。 若要觸發此事件,請結束與通訊服務資源連結的通話。
  • 將參與者新增至 Azure 通訊服務語音和視訊通話時,就會產生 Call Participant Added 事件。 若要觸發此事件,請將參與者新增至與通訊服務資源連結的 Azure 通訊服務語音和視訊通話。
  • 將參與者從 Azure 通訊服務語音和視訊通話中移除時,會產生 Call Participant Removed 事件。 若要觸發此事件,請將參與者從與通訊服務資源連結的 Azure 通訊服務語音和視訊通話中移除。

查看 Azure 通訊服務支援的事件的完整清單。

接收語音和視訊通話事件

當您完成上述任一動作後,您會看到語音和視訊通話事件傳送至端點。 這些事件會顯示在我們一開始設定的 Azure 事件方格檢視器範例中。 您可以按事件旁的眼睛圖示,以查看整個承載。

深入了解事件結構描述和其他事件處理概念

清除資源

如果您想要清除並移除通訊服務訂用帳戶,您可以刪除資源或資源群組。 刪除資源群組也會刪除與其相關聯的任何其他資源。 深入了解如何清除資源

您可能也會想要: