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