Поделиться через

Краткое руководство. Обработка событий голосового и видеозвонка

  • Статья

Важно!

Функции, описанные в этой статье, в настоящее время находятся в общедоступной предварительной версии. Эта предварительная версия предоставляется без соглашения об уровне обслуживания. Ее не следует использовать для производственных рабочих нагрузок. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены. Дополнительные сведения см. в статье Дополнительные условия использования Предварительных версий Microsoft Azure.

Начало работы с Службы коммуникации Azure с помощью Сетка событий Azure для обработки событий голосового и видеозвонка служб коммуникации.

Сетка событий Azure

Сетка событий Azure — это облачная служба обработки событий. Из этой статьи вы узнаете, как подписываться на события службы коммуникации и запускать событие для просмотра результата. Как правило, события отправляются на конечную точку, которая обрабатывает данные событий и выполняет соответствующие действия. В рамках этой статьи события отправляются в веб-приложение, которое собирает и отображает сообщения.

Необходимые компоненты

Установка

Включение поставщика ресурсов службы "Сетка событий"

Если вы еще не использовали службу "Сетка событий" в подписке Azure, вам, возможно, потребуется зарегистрировать поставщик ресурсов этой службы, выполнив шаги ниже.

На портале Azure выполните следующие действия:

  1. В меню слева выберите Подписки.
  2. Выберите подписку, которую используете для службы "Сетка событий".
  3. В разделе Параметры выберите Поставщики ресурсов.
  4. Найдите Microsoft.EventGrid.
  5. Если поставщик ресурсов не зарегистрирован, выберите Зарегистрировать.

Регистрация может занять некоторое время. Щелкните Обновить, чтобы обновить состояние. Когда для состояния отобразится значение Зарегистрировано, можно будет продолжить.

Развертывание средства просмотра Сетки событий

В рамках этого краткого руководства для просмотра событий практически в реальном времени мы будем использовать пример средства просмотра Сетки событий Azure. Это позволит пользователю работать с веб-каналом в режиме реального времени. Кроме того, для проверки также должны быть доступны полезные данные каждого события.

Подписка на события голосового и видеозвонка с помощью веб-перехватчиков

На портале перейдите к созданному вами ресурсу Служб коммуникации Azure. В ресурсе Службы коммуникации на странице Communication Services (Службы коммуникации) в меню слева щелкните пункт События.

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

Нажмите кнопку Add Event Subscription (Добавить подписку на события), чтобы войти в мастер создания.

На странице Создать подписку на события введите имя подписки.

Вы можете подписаться на определенные события, чтобы сообщить сетке событий, на которые вы хотите подписаться, и куда отправлять события. В раскрывающемся меню выберите события, на которые вы хотите подписаться. Для голосового и видеозвонка у вас будет возможность выбрать Call Started, Call EndedCall Participant added и Call Participant Removed.

Если вам предложено ввести имя системного раздела, можно предоставить уникальную строку. Значение в этом поле не влияет на вашу работу и используется для внутренней телеметрии.

Просмотрите полный список событий, поддерживаемых Службами коммуникации Azure.

Screenshot showing the calling event types being selected.

Выберите значение Веб-перехватчик для параметра Тип конечной точки.

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

В разделе Конечная точка щелкните Выбрать конечную точку и введите URL-адрес веб-приложения.

В этом случае мы будем использовать URL-адрес из примера средства просмотра Сетки событий Azure, который мы настроили ранее в кратком руководстве. URL-адрес примера будет иметь следующий формат: https://{{site-name}}.azurewebsites.net/api/updates

Нажмите кнопку Подтвердить выбор.

Screenshot showing confirming a Web Hook Endpoint.

Просмотр событий голосового и видеозвонка

Активация событий голосового и видеозвонка

Чтобы просмотреть триггеры событий, сначала необходимо создать события.

  • Call Startedсобытия создаются при запуске голосового и видеозвонка Службы коммуникации Azure. Чтобы активировать это событие, просто запустите вызов, подключенный к ресурсу Служб коммуникации.
  • Call Endedсобытия создаются при завершении голосового и видеозвонка Службы коммуникации Azure. Чтобы активировать это событие, просто завершите вызов, подключенный к ресурсу Служб коммуникации.
  • Call Participant Addedсобытия создаются при добавлении участника в Службы коммуникации Azure голосовой и видеозвонок. Чтобы активировать это событие, добавьте участника в Службы коммуникации Azure голосовой и видеозвонок, подключенный к ресурсу Служб коммуникации.
  • Call Participant Removedсобытия создаются при удалении участника из Службы коммуникации Azure голосового и видеозвонка. Чтобы активировать это событие, удалите участника из Службы коммуникации Azure голосового и видеозвонка, подключенного к ресурсу Служб коммуникации.

Просмотрите полный список событий, поддерживаемых Службами коммуникации Azure.

Получение событий голосового и видеозвонка

После завершения любого действия выше вы заметите, что события голосового и видеозвонка отправляются в конечную точку. Эти события будут отображаться в примере средства просмотра Сетки событий Azure, который мы настроили в начале. Чтобы просмотреть все полезные данные, можно нажать значок глаза рядом с событием.

Дополнительные сведения см. в статье Обработка событий в Службах коммуникации Azure.

Очистка ресурсов

Если вы хотите отменить и удалить подписку на Службы коммуникации, можно удалить ресурс или группу ресурсов. При удалении группы ресурсов также удаляются все связанные с ней ресурсы. См. сведения об очистке ресурсов.

Полезные ссылки