Подключение к собранию Teams

Статья
10/26/2023

Службы коммуникации Azure можно использовать для создания приложений, позволяющих пользователям присоединяться к собраниям Teams и участвовать в ней. Цены на стандартные Службы коммуникации Azure применяются к этим пользователям, но не взимается дополнительная плата за саму возможность взаимодействия. Используя собственную модель идентификации (BYOI), вы управляете проверкой подлинности пользователей и пользователями ваших приложений не требуются лицензии Teams для присоединения к собраниям Teams. Это идеально подходит для приложений, позволяющих лицензированным пользователям Teams и внешним пользователям использовать пользовательское приложение для присоединения к виртуальной консультации. Например, поставщики медицинских услуг, использующие Teams, могут проводить виртуальные визиты с пациентами, которые используют пользовательское приложение.

Кроме того, можно использовать удостоверения Teams с пакетами SDK Службы коммуникации Azure. Дополнительные сведения содержатся здесь.

Взаимодействие не включено для Teams для личного использования.

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

Включение анонимного присоединения к собранию в клиенте Teams

Когда пользователь BYOI присоединяется к собранию Teams, он рассматривается как анонимный внешний пользователь, как и пользователи, которые присоединяются к собранию Teams анонимно с помощью веб-приложения Teams. Возможность пользователей BYOI присоединяться к собраниям Teams, так как анонимные пользователи управляются теми же параметрами Teams, которые управляют анонимным присоединением к собранию с помощью веб-приложения Teams и включены по умолчанию. В статье "Управление параметрами собраний в Microsoft Teams " описаны эти параметры.

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

Процесс собрания

Как и в случае с анонимным присоединением к собранию Teams, приложение должно иметь ссылку на собрание, которую можно получить с помощью API Graph или из календаря в Microsoft Teams. Имя пользователей BYOI, отображаемых в Teams, можно настроить с помощью пакета SDK для вызовов служб коммуникации. Они помечены как внешние, чтобы пользователи Teams знали, что они не прошли проверку подлинности с помощью идентификатора Microsoft Entra.

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

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

Дополнительные сведения о потоках данных, которые требуются для присоединения к конференциям Teams, см. на странице, посвященной архитектуре "клиент — сервер". Главный пример функции группового вызова содержит пример кода для присоединения к конференции Teams из веб-приложения.

Хранилище чатов

Во время собрания Teams все сообщения чата, отправленные пользователями Teams или пользователями служб коммуникации, хранятся в географическом регионе, связанном с организацией Microsoft 365, на котором размещается собрание. Дополнительные сведения см. в статье "Расположение данных в Microsoft Teams". Для каждого пользователя Служб коммуникации в собраниях также есть копия последнего отправленного сообщения, хранящегося в географическом регионе, связанном с ресурсом Служб коммуникации, используемым для разработки приложения служб коммуникации. Дополнительные сведения см. в статье "Доступность и расположение данных в регионе".

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

Диагностика и аналитика вызовов

После завершения собрания Teams диагностические сведения о собрании доступны с помощью ведения журнала служб коммуникации и диагностика и использования Аналитики вызовов Teams в Центре администрирования Teams. Пользователи служб коммуникации будут отображаться как анонимные на экранах Аналитики вызовов. Пользователи служб коммуникации не включаются в Аналитику в режиме реального времени Teams.

Конфиденциальность

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

Корпорация Майкрософт укажет через API Служб коммуникации Azure, что запись или транскрибирование начались, а вам понадобится в реальном времени сообщить этот факт пользователям в пользовательском интерфейсе приложения. Вы соглашаетесь гарантировать возмещение корпорации Майкрософт всех расходов и убытков в результате невыполнения вами этого обязательства.

Известные проблемы и ограничения

Пользователи служб коммуникации могут присоединиться к собранию Teams, запланированному для канала Teams, и использовать аудио и видео, но они не смогут отправлять или получать сообщения чата, так как они не являются членами канала.
Пользователи служб коммуникации могут присоединиться к собранию Teams и использовать видео, но они не смогут применять фоновые эффекты.
Пользователи служб коммуникации могут присоединяться к вебинару Teams, но роли докладчика и участников в настоящее время не применяются, поэтому пользователи служб коммуникации могут выполнять действия, не предназначенные для участников, например общий доступ к экранам, включение и отключение камеры, а также самостоятельное подключение, если ваше приложение предоставляет UX для этих действий.
При использовании Microsoft Graph для перечисления участников собрания Teams сведения о пользователях служб коммуникации в настоящее время не включены.
Презентации PowerPoint не отображаются для пользователей служб коммуникации.
Собрания Teams поддерживают до 1000 участников, но пакет SDK для вызовов Службы коммуникации Azure в настоящее время поддерживает только 350 участников, а пакет SDK чата поддерживает 250 участников.
При использовании Cloud Video Interop для Microsoft Teams некоторые устройства видели проблемы, когда пользователь служб коммуникации предоставляет общий доступ к экрану.
События голосового и видеозвонка служб коммуникации не вызываются для собрания Teams.
Такие функции, как реакции, поднятая рука, совместное использование и комнаты для разбиения, доступны только для пользователей Teams.
Пользователи служб коммуникации не могут взаимодействовать с приложениями опроса или Q&A в собраниях.
Службы коммуникации не будут иметь доступ ко всем функциям чата, поддерживаемым Teams. Они могут отправлять и получать текстовые сообщения, использовать индикаторы ввода, чеки чтения и другие функции, поддерживаемые пакетом SDK чата. Однако такие функции, как общий доступ к файлам, ответ или реакция на сообщение, не поддерживаются пользователям служб коммуникации.
Пакет SDK для звонков в настоящее время не поддерживает закрытые подпись для собраний Teams.
Пользователи служб коммуникации не могут присоединиться к трансляциям Teams.
События обработчика действий Teams для ботов не запускаются при присоединении пользователей служб коммуникации к собранию Teams.