API для комнат для структурированных собраний

Виртуальные комнаты позволяют разработчикам с основными возможностями безопасности и контроля создавать хорошо структурированные возможности взаимодействия, такие как виртуальные встречи и групповые связи. Разработчики могут использовать виртуальные комнаты для проведения голосовых, видео и ТСОП звонков. Безопасность и элементы управления в комнатах можно классифицировать следующим образом.

• Безопасность доступа пользователей и элементы управления применяются к участникам вызова, управляя тем, кто может присоединиться к вызову и какие действия они могут предпринять во время звонка. Например, во время виртуальной встречи пациента с врачом, только авторизованный персонал больницы и пациенты могут присоединиться к вызову. Ограничение участников сохраняет конфиденциальность пациентов, и участники не превышают назначенные им роли и привилегии, чтобы нарушить текущий вызов.

• Безопасность и элементы управления на уровне помещений применяются на уровне вызова для управления тем, когда вызов может выполняться и какие возможности доступны во время вызова. Например, учащиеся могут присоединиться только к вызову класса в течение выделенного времени, но вызывающий ТСОП не может присоединиться к одному вызову класса.

Возможности высокого уровня, поддерживаемые в виртуальных комнатах

* Применяются некоторые исключения. Полный список см. в разделе "Возможности автоматизации вызовов".

Когда следует использовать виртуальные комнаты

В следующей таблице описывается, когда следует использовать виртуальные комнаты.

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

Как проводить вызовы в виртуальных комнатах

На высоком уровне для проведения звонков в виртуальных комнатах необходимо создать и управлять комнатами. В следующей таблице описывается, как разрешить участникам присоединяться к вызовам и выполнять операции в вызове из пакета SDK для вызовов на стороне клиента и на стороне сервера.

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

Полный список операций на стороне клиента во время вызова и их использование см. в документации пакета SDK для вызовов клиента Calling client SDK.

Управление вызовами виртуальных комнат на стороне сервера с помощью пакета SDK для сервера автоматизации вызовов

Пакет SDK службы автоматизации вызовов позволяет разработчикам управлять вызовами виртуальных комнат на стороне сервера и выполнять операции в вызове. Возможности автоматизации вызовов постепенно включены в вызовах виртуальных комнат. В следующей таблице показано текущее состояние этих возможностей. Разработчики управляют возможностями автоматизации вызовов и управляют ими на стороне сервера, которые работают на более высоком уровне, чем привилегии участника вызова. Поэтому возможности автоматизации вызовов не контролируются с помощью ролей пользователей и разрешений.

* В настоящее время в общедоступной предварительной версии.

На этом рисунке показаны основные понятия для управления комнатами и присоединения к ней.

Сервер, инициированный ТСОП, с помощью пакета SDK для сервера автоматизации вызовов

Разработчики могут активировать и деактивировать возможность подключения к участнику ТСОП, задав флаг pstnDialoutEnabled для конкретной комнаты. После того как разработчик устанавливает pstnDialoutEnabled=TRUE для комнаты, разработчики могут вызвать участника ТСОП на стороне сервера с помощью службы автоматизации вызовов, не требуя участия на стороне клиента.

Например, пациент может запросить службу интерпретации для предстоящей виртуальной встречи с врачом. В большинстве случаев номер телефона службы интерпретации определяется динамически с помощью внутреннего процесса. Эта возможность ТСОП на стороне сервера позволяет разработчикам определить целевой номер телефона, инициировать звонок и добавить его в виртуальный звонок пациента, не требуя каких-либо действий на стороне клиента.

Выполните следующие действия, чтобы добавить номер ТСОП в вызов комнаты с помощью пакета SDK службы автоматизации вызовов:

1. Создание комнаты с флагом pstnDialoutEnabled True
2. Участники запускают звонок в комнате
3. Использование пакета SDK службы автоматизации вызовов для подключения к вызову комнаты с помощью идентификатора комнаты
4. Использование пакета SDK службы автоматизации звонков для подключения к номеру ТСОП
5. Пользователь ТСОП принимает и присоединяется к вызову комнаты

Управление вызовами в виртуальных комнатах с использованием клиентских SDK для вызовов

Используйте пакеты SDK для звонков, чтобы присоединиться к вызову комнаты. Вызовы комнат можно присоединить с помощью пакетов SDK для вызовов в Интернете, iOS или Android. Примеры и способы присоединения к звонку в комнате см. в разделе "Присоединение к звонку в комнате".

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

Клиент, инициированный ТСОП, с помощью пакета SDK для клиента для вызовов

Разработчики могут включить или отключить возможность участников вызова дозвониться до участника PSTN, установив флаг pstnDialoutEnabled, специфичный для комнаты. После того как разработчик устанавливает pstnDialoutEnabled=TRUE для комнаты, участники вызова с ролью докладчика могут вызвать участника ТСОП из своего вызывающего клиента. Следующие шаги используются для добавления номера ТСОП в вызов комнаты с помощью пакета SDK для вызывающего клиента.

1. Создайте комнату с флагом pstnDialoutEnabled, равным True.
2. Участники начинают комнатный звонок.
3. Участник с ролью презентатора добавляет номер PSTN в вызов.
4. Пользователь телефонной сети принимает вызов и присоединяется к конференц-вызову.

API виртуальных комнат и пакеты SDK

Комнаты создаются и управляются с помощью API-интерфейсов комнат или пакетов SDK. Используйте API и пакеты SDK комнат в серверном приложении для room операций:

• Создание
• Изменить
• Удаление
• Установка и обновление списка участников
• Установка и изменение срока действия комнаты
• Назначение ролей и разрешений пользователям

Предопределенные роли и разрешения участников в вызовах виртуальных комнат

Вы можете назначить участников комнаты одной из следующих ролей: выступающий, сотрудник, участник и потребитель.

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

Заметка: Участник вызова ТСОП не является частью списка участников комнаты, следовательно, роль пользователя им не назначается. Они могут быть ограничены отключением или отменой звука на локальном устройстве.

* Доступно только в пакете SDK для веб-вызовов.

Обработка событий

События голосового и видеозвонка , опубликованные с помощью сетки событий, помечены сведениями о телефонном вызове.

• CallStarted публикуется при запуске вызова комнаты.
• CallEnded публикуется при завершении вызова комнаты.
• CallParticipantAdded публикуется при присоединении нового участника к вызову комнаты.
• CallParticipantRemoved публикуется при удалении участника из вызова комнаты.

Устаревшие возможности

Более ранняя общедоступная предварительная версия API комнат поддерживает две конфигурации для управления списком комнат следующим образом:

• Только комната "Пригласить ", которая позволила только приглашенным пользователям присоединиться к вызову комнат.
• Открытая комната, которая была менее безопасной. В конфигурации открытых комнат все Службы коммуникации Azure пользователи смогли присоединиться к вызову без явного приглашения через список комнат.

Концепция Open Room теперь устарела. Идти вперед, Пригласить только номера являются единственным поддерживаемым типом комнаты.

Известные ограничения

• Служба автоматизации вызовов Azure Communication Services в настоящее время не поддерживает звонки в комнаты.

Дальнейшие шаги

• Используйте краткое руководство по созданию, управлению и присоединению к комнате.
• Узнайте, как присоединиться к вызову комнаты.
• Узнайте, как управлять вызовом в комнате.
• Просмотрите требования к сети для мультимедиа и сигналов.
• Анализ данных комнат см. в разделе " Журналы комнат".
• Узнайте, как использовать рабочую область Log Analytics, см. в руководстве по Log Analytics.
• Создание собственных запросов в Log Analytics см. в статье " Начало работы с запросами".