Общие сведения о виртуальных комнатах
Виртуальные комнаты позволяют разработчикам с основными возможностями безопасности и контроля создавать хорошо структурированные возможности взаимодействия, такие как виртуальные встречи и групповые связи. Разработчики могут использовать виртуальные комнаты для проведения голосовых, видео и ТСОП звонков. Безопасность и элементы управления в комнатах можно классифицировать следующим образом.
Безопасность доступа пользователей и элементы управления применяются к участникам вызова, управляя тем, кто может присоединиться к вызову и какие действия они могут предпринять во время звонка. Например, во время виртуальной встречи пациента с врачом, только авторизованный персонал больницы и пациенты могут присоединиться к вызову. Ограничение участников сохраняет конфиденциальность пациентов, и участники не превышают назначенные им роли и привилегии, чтобы нарушить текущий вызов.
Безопасность и элементы управления на уровне помещений применяются на уровне вызова для управления тем, когда вызов может выполняться и какие возможности доступны во время вызова. Например, учащиеся могут присоединиться только к вызову класса в течение выделенного времени, но вызывающий ТСОП не может присоединиться к одному вызову класса.
Возможности высокого уровня, поддерживаемые в виртуальных комнатах
| Возможность | Поддерживается в вызове комнат |
|---|---|
| Голос (VoIP) | ✔️ |
| Видео | ✔️ |
| Клиент, инициированный телефонным подключением к номеру ТСОП | ✔️ |
| Сервер, инициированный телефонным подключением к номеру ТСОП** | ✔️ |
| Управление вызовами на стороне сервера (автоматизация вызовов)* | ✔️ |
| Телефонная связь ТСОП | ❌ |
| Асинхронное обмен сообщениями (чат) | ❌ |
| Взаимодействие с Microsoft Teams | ❌ |
* Применяются некоторые исключения. Полный список поддерживаемых возможностей автоматизации вызовов приведен в этом документе.
** В настоящее время в общедоступной предварительной версии.
Когда следует использовать виртуальные комнаты
В следующей таблице показано, когда следует использовать виртуальные комнаты.
| Condition | Использование комнат |
|---|---|
| Если важно контролировать, кто может присоединиться к вызову (только приглашение). | ✔️ |
| Когда важно управлять началом и окончанием вызова. | ✔️ |
| Когда роли и разрешения пользователей необходимы для проведения хорошо управляемых коммуникаций. | ✔️ |
| Если решение требует взаимодействия Teams.* | ❌ |
* Если решение требует взаимодействия между Teams и Службы коммуникации Azure, используйте вызовы взаимодействия Teams.
Как проводить вызовы в виртуальных комнатах
На высоком уровне для проведения звонков в виртуальных комнатах необходимо создать и управлять комнатами. В следующей таблице описывается, как разрешить участникам присоединяться к вызовам и выполнять операции в вызове из пакета SDK для вызовов на стороне клиента и на стороне сервера.
| Возможность | ACS SDK | Клиентский пакет SDK для сервера | Description |
|---|---|---|---|
| Создание виртуальных комнат и управление ими | Пакет SDK для виртуальных комнат | Сервер | Пакет SDK для виртуальных комнат позволяет разработчикам создавать виртуальные комнаты и управлять ими, добавлять и удалять пользователей, назначать и обновлять роли пользователей, устанавливать или обновлять расписания виртуальных комнат. Разработчики также могут задать ограничения безопасности, например ограничить исходящий номер ТСОП из комнат. |
| Присоединение звонка виртуальных комнат с голосовой связью, видео или ТСОП и выполнение операций, инициированных клиентом в вызове | Вызов пакета SDK | Клиент | Пакет SDK для вызывающего клиента позволяет пользователям присоединяться к вызову виртуальных комнат и выполнять операции на стороне клиента, разрешенные назначенными ролями пользователей. Безопасность в вызове виртуальных комнат обеспечивается путем применения списка, расписания, ролей пользователей и ограничений управления, заданных путем создания и управления виртуальными комнатами. Используя пакет SDK для вызовов клиента, разработчики позволяют участникам вызова выполнять такие операции, как отключение и отключение звонка, общий доступ к экрану, включение и отключение видео для участника ТСОП и т. д. |
| Управление операциями на стороне сервера | Пакет SDK службы автоматизации вызовов | Сервер | Пакет SDK службы автоматизации вызовов позволяет разработчикам выполнять операции в вызове на стороне сервера. Операции с вызовами включают абонентскую связь, инициированную сервером, к номеру ТСОП, записи звонков, отправке и получению DTMF, отправке объявлений определенным пользователям и т. д. Так как выполнение операций на стороне сервера не зависит от пользователей и управляется разработчиками, эти действия не контролируются ролями пользователей. |
Разработчики используют пакет SDK для виртуальных комнат, пакет SDK для вызова клиента и пакет SDK службы автоматизации вызовов для защиты своих вызовов и активации операций на стороне клиента или сервера.
| Возможность | Пакет SDK для сервера комнат | Вызов пакета SDK для клиента | Пакет SDK для сервера автоматизации вызовов |
|---|---|---|---|
| Управление виртуальными комнатами: создание, получение, обновление, список и удаление виртуальных комнат | ✔️ | ❌ | ❌ |
| Управление списками виртуальных комнат— добавление и обновление и удаление пользователя в виртуальную комнату | ✔️ | ❌ | ❌ |
| Управление разрешениями участников вызовов виртуальных комнат — назначение и обновление ролей пользователей | ✔️ | ❌ | ❌ |
| Управление расписанием виртуальных комнат — разрешенное расписание набора и обновления виртуальных комнат | ✔️ | ❌ | ❌ |
| Управление средствами управления безопасностью виртуальных комнат— флаг установки и обновления, чтобы разрешить исходящий ТСОП из определенных виртуальных комнат | ✔️ | ❌ | ❌ |
| Получение списка пользователей, приглашенных для присоединения к виртуальной комнате | ✔️ | ❌ | ❌ |
| Пользователь инициирует вызов виртуальных комнат или присоединяет выполняемый вызов. | ❌ | ✔️ | ❌ |
| Подключение к пользователю ТСОП | ❌ | ✔️ | ✔️* |
| Добавление и удаление участников VoIP в выполняемый вызов | ❌ | ✔️ | ✔️* |
| Получение списка участников, присоединившихся к вызову во время выполнения | ❌ | ✔️ | ✔️* |
| Заголовки вызовов "Запуск и остановка" и "Изменение заголовков" | ❌ | ✔️ | ❌ |
| Управление записью вызовов | ❌ | ❌ | ✔️ |
| Отправка и получение DTMF от участников ТСОП | ❌ | ❌ | ✔️* |
| Воспроизведение звуковых запросов участникам | ❌ | ❌ | ✔️* |
Вызывающий клиентский пакет SDK предоставляет полный список операций вызова на стороне клиента и объясняет, как их использовать.
* В настоящее время в общедоступной предварительной версии.
Управление вызовами виртуальных комнат на стороне сервера с помощью пакета SDK для сервера автоматизации вызовов
Пакет SDK службы автоматизации вызовов позволяет разработчикам управлять вызовами виртуальных комнат на стороне сервера и выполнять операции в вызове. Возможности автоматизации вызовов постепенно включены в вызовах виртуальных комнат. В следующей таблице показано текущее состояние этих возможностей. Разработчики управляют возможностями автоматизации вызовов и управляют ими на стороне сервера, которые работают на более высоком уровне, чем привилегии участника вызова. Поэтому возможности автоматизации вызовов не контролируются с помощью ролей пользователей и разрешений.
| Возможность автоматизации вызовов | Поддерживается в вызове комнат |
|---|---|
| Участник ТСОП с телефонным подключением * | ✔️ |
| Отправка и чтение DTMF в участника ТСОП * | ✔️ |
| Отправка объявлений определенным участникам звонка * | ✔️ |
| Добавление и удаление участника VoIP из текущего вызова | ✔️ |
| Завершение вызова для всех пользователей | ✔️ |
| Транскрибирование вызовов | ❌ |
| Потоковая передача аудиомедийных носителей | ❌ |
* В настоящее время в общедоступной предварительной версии.
На этом рисунке показаны основные понятия для управления комнатами и присоединения к ней.
Сервер, инициированный ТСОП, с помощью пакета SDK для сервера автоматизации вызовов
Разработчики могут активировать и деактивировать возможность подключения к участнику ТСОП, задав флаг pstnDialoutEnabled для конкретной комнаты. После того как разработчик устанавливает pstnDialoutEnabled=TRUE для комнаты, разработчики могут вызвать участника ТСОП на стороне сервера с помощью службы автоматизации вызовов, не требуя участия на стороне клиента.
Например, пациент может запросить службу интерпретации для предстоящей виртуальной встречи с врачом. В большинстве случаев номер телефона службы интерпретации определяется динамически с помощью внутреннего процесса. Эта возможность ТСОП на стороне сервера позволяет разработчикам определить целевой номер телефона, инициировать звонок и добавить его в виртуальный звонок пациента, не требуя каких-либо действий на стороне клиента.
Выполните следующие действия, чтобы добавить номер ТСОП в вызов комнаты с помощью пакета SDK службы автоматизации вызовов:
- Создание комнаты с флагом pstnDialoutEnabled
True - Участники запускают звонок в комнате
- Использование пакета SDK службы автоматизации вызовов для подключения к вызову комнаты с помощью идентификатора комнаты
- Использование пакета SDK службы автоматизации звонков для подключения к номеру ТСОП
- Пользователь ТСОП принимает и присоединяется к вызову комнаты
Управление вызовами виртуальных комнат с клиентских пакетов SDK
Используйте пакеты SDK для звонков, чтобы присоединиться к вызову комнаты. Вызовы комнат можно присоединить с помощью пакетов SDK для вызовов в Интернете, iOS или Android. Здесь можно найти примеры быстрого запуска для присоединения к номерам.
Доступ к комнатам также можно получить с помощью библиотеки пользовательского интерфейса Службы коммуникации Azure. Библиотека пользовательского интерфейса позволяет разработчикам добавлять клиент вызова с поддержкой комнат в приложение только с несколькими строками кода.
Клиент, инициированный ТСОП, с помощью пакета SDK для клиента для вызовов
Разработчики могут разрешить или запретить возможность вызова участникам телефонного подключения к участнику ТСОП, задав для номера определенный флаг pstnDialoutEnabled. После того как разработчик устанавливает pstnDialoutEnabled=TRUE для комнаты, участники вызова с ролью докладчика могут вызвать участника ТСОП из своего вызывающего клиента. Следующие шаги используются для добавления номера ТСОП в вызов комнаты с помощью пакета SDK для вызывающего клиента.
- Создание комнаты с флагом pstnDialoutEnabled с значением True
- Участники запускают звонок в комнате
- Участник с ролью докладчика добавляет номер ТСОП в вызов
- Пользователь ТСОП принимает и присоединяется к вызову комнаты
API виртуальных комнат и пакеты SDK
Комнаты создаются и управляются с помощью API-интерфейсов комнат или пакетов SDK. Используйте API и пакеты SDK комнат в серверном приложении для room операций:
- Создание
- Изменить
- Удаление
- Установка и обновление списка участников
- Установка и изменение срока действия комнаты
- Назначение ролей и разрешений пользователям
| Пакет SDK для виртуальных комнат | Версия | Штат |
|---|---|---|
| Пакеты SDK для виртуальных комнат | 2024-04-15 | Общедоступная версия — полностью поддерживается |
| Пакеты SDK для виртуальных комнат | 2023-06-14 | Общедоступная версия — полностью поддерживается |
| Пакеты SDK для виртуальных комнат | 2023-10-30 | Общедоступная предварительная версия — полностью поддерживается |
| Пакеты SDK для виртуальных комнат | 2023-03-31 | Общедоступная предварительная версия — прекращена |
| Пакеты SDK для виртуальных комнат | 2022-02-01 | Общедоступная предварительная версия — прекращена |
| Пакеты SDK для виртуальных комнат | 2021-04-07 | Общедоступная предварительная версия — прекращена |
Предопределенные роли и разрешения участников в вызовах виртуальных комнат
Участникам комнаты можно назначить одну из следующих ролей: выступающий, участник и потребитель.
В следующей таблице представлены подробные возможности, сопоставленные с ролями. На высоком уровне роль докладчика имеет полный контроль, возможности участников ограничены звуком и видео, а потребитель может получать только аудио, видео и общий доступ к экранам.
| Возможность | Роль: выступающий | Роль: участник | Роль: потребитель |
|---|---|---|---|
| Элементы управления "Средний вызов" | |||
| — Включение и отключение видео | ✔️ | ✔️ | ❌ |
| — отключить или отменить микрофон | ✔️ | ✔️ | ❌ |
| — Отключить удаленный пользователь | ✔️ | ❌ | ❌ |
| — Переключение между камерами | ✔️ | ✔️ | ❌ |
| — активный динамик | ✔️ | ✔️ | ✔️ |
| — Выбор говорящего для звонков | ✔️ | ✔️ | ✔️ |
| — выбор микрофона для звонков | ✔️ | ✔️ | ❌ |
| — Отображение состояния участников (бездействия, подключения, подключения, удержания, отключения, отключения и т. д.) | ✔️ | ✔️ | ✔️ |
| — показать состояние вызова (ранний носитель, входящие, подключение, звонок, подключение, подключение, удержание, отключение, отключение, отключение | ✔️ | ✔️ | ✔️ |
| — Показывает, отключен ли участник | ✔️ | ✔️ | ✔️ |
| - Показать причину, по которой участник оставил звонок | ✔️ | ✔️ | ✔️ |
| — Запуск подписей вызовов | ✔️ | ✔️ | ✔️ |
| — Изменение языка подписей | ✔️ | ✔️ | ❌ |
| - Завершение собрания для всех участников | ✔️ | ❌ | ❌ |
| - Приглашение присоединиться к участнику виртуальной комнаты к вызову | ✔️ | ❌ | ❌ |
| Общий доступ к экранам | |||
| — экран общего доступа | ✔️ * | ❌ | ❌ |
| — Предоставление общего доступа к приложению | ✔️ * | ❌ | ❌ |
| — Общий доступ к вкладке браузера | ✔️ * | ❌ | ❌ |
| — Участники могут просматривать общий экран | ✔️ | ✔️ | ✔️ |
| Управление реестром | |||
| — удаление участника | ✔️ | ❌ | ❌ |
| Управление устройствами | |||
| — запрашивать разрешение на использование звука и видео | ✔️ | ✔️ | ❌ |
| — Получение списка камер | ✔️ | ✔️ | ❌ |
| — Установка камеры | ✔️ | ✔️ | ❌ |
| — Получение выбранной камеры | ✔️ | ✔️ | ❌ |
| — получение списка микрофонов | ✔️ * | ✔️ * | ❌ |
| — Установка микрофона | ✔️ * | ✔️ * | ❌ |
| — Получение выбранного микрофона | ✔️ * | ✔️ * | ❌ |
| — Получение списка динамиков | ✔️ * | ✔️ * | ✔️ * |
| — Настройка динамиков | ✔️ * | ✔️ * | ✔️ * |
| — Получение выбранного говорящего | ✔️ | ✔️ | ✔️ |
| Визуализация видео | |||
| — Отрисовка видео в нескольких местах (локальная камера или удаленный поток) | ✔️ | ✔️ | ✔️ (Только удаленный) |
| — настройка и обновление режима масштабирования видео | ✔️ | ✔️ | ✔️ (Только удаленный) |
| — отрисовка удаленного видеопотока | ✔️ | ✔️ | ✔️ |
| Подключение к участникам ТСОП на стороне клиента | |||
| — Абоненты ТСОП из звонков виртуальных комнат | ✔️ | ❌ | ❌ |
* Доступно только в пакете SDK для веб-вызовов. Недоступно в пакетах SDK для вызовов iOS и Android
** В настоящее время в общедоступной предварительной версии.
Обработка событий
События голосового и видеозвонка , опубликованные с помощью сетки событий, помечены сведениями о телефонном вызове.
- CallStarted публикуется при запуске вызова комнаты.
- CallEnded публикуется при завершении вызова комнаты.
- CallParticipantAdded публикуется при присоединении нового участника к вызову комнаты.
- CallParticipantRemoved публикуется при удалении участника из вызова комнаты.
Устаревшие возможности
Более ранняя общедоступная предварительная версия API комнат поддерживает две конфигурации для управления списком комнат следующим образом:
- Только комната "Пригласить ", которая позволила только приглашенным пользователям присоединиться к вызову комнат.
- Открытая комната, которая была менее безопасной. В конфигурации открытых комнат все Службы коммуникации Azure пользователи смогли присоединиться к вызову без явного приглашения через список комнат.
Концепция Open Room теперь устарела. Идти вперед, Пригласить только номера являются единственным поддерживаемым типом комнаты.
Известные ограничения
- Службы коммуникации Azure возможности автоматизации вызовов в настоящее время не поддерживают вызовы комнат.
Дальнейшие действия
- Используйте краткое руководство по созданию, управлению и присоединению к комнате.
- Узнайте, как присоединиться к вызову комнаты.
- Узнайте, как управлять вызовом в комнате.
- Просмотрите требования к сети для мультимедиа и сигналов.
- Анализ данных комнат см. в разделе " Журналы комнат".
- Узнайте, как использовать рабочую область Log Analytics, см. в руководстве по Log Analytics.
- Создание собственных запросов в Log Analytics см. в статье " Начало работы с запросами".