Общие сведения о пакете SDK для вызовов

Пакет SDK для вызовов позволяет устройствам конечных пользователей работать с голосовыми и видеовызовами. На этой странице приводятся подробные описания функций вызовов, включая сведения о поддержке платформ и браузеров. Чтобы начать работу прямо сейчас, ознакомьтесь с документами Краткое руководство по вызовам или Главный пример функции вызовов.

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

Основные возможности пакета SDK для вызовов:

  • Адресация. Службы коммуникации Azure предоставляют универсальные удостоверения, используемые для адресации конечных точек связи. Клиенты могут использовать эти удостоверения для проверки подлинности службы и общения друг с другом. Данные удостоверения используются в API для вызовов, с помощью которых клиенты могут увидеть, кто подключен к вызову (в виде списка).
  • Шифрование. Пакет SDK для вызовов шифрует трафик и предотвращает несанкционированное подключение к каналу связи.
  • Управление устройствами и мультимедиа. Пакет SDK для вызовов предоставляет средства для привязки к аудио- и видеоустройствам, кодирует содержимое для эффективной передачи через плоскость передачи данных и отображает содержимое на указанных выходных устройствах и в представлениях. Для совместного использования экрана и приложений также предоставляются интерфейсы API.
  • ТСОП. Пакет SDK для звонков может инициировать голосовые звонки с помощью традиционной телефонной сети с общедоступным коммутатором, используя телефонные номера, которые вы получаете в портал Azure или программным способом.
  • Конференции Teams. Пакет SDK для вызовов позволяет присоединиться к конференциям Teams и взаимодействовать с плоскостью данных для голосовых и видеовызовов в Teams.
  • Уведомления. Пакет SDK для вызовов предоставляет интерфейсы API, позволяющие клиентам получать уведомления о входящем вызове. В случаях, когда приложение не выполняется в фоновом режиме, можно использовать шаблоны для запуска всплывающих уведомлений, чтобы информировать пользователей о входящем вызове.

Подробные возможности

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

Группа функций Функция JS Windows Java (Android) Objective-C (iOS)
Основные возможности Настройка индивидуального вызова между двумя пользователями ✔️ ✔️ ✔️ ✔️
Настройка группового вызова с более чем двумя пользователями (не более 350 пользователей) ✔️ ✔️ ✔️ ✔️
Перевести индивидуальный вызов с двумя пользователями в групповой вызов с более чем двумя пользователями ✔️ ✔️ ✔️ ✔️
Присоединение к групповому вызову после вызова ✔️ ✔️ ✔️ ✔️
Приглашение другого участника голосовых вызовов через IP присоединиться к текущему групповому вызову ✔️ ✔️ ✔️ ✔️
Управление в процессе вызова Включение или отключение видео ✔️ ✔️ ✔️ ✔️
Включение или отключение микрофона ✔️ ✔️ ✔️ ✔️
Переключение между камерами ✔️ ✔️ ✔️ ✔️
Локальное удержание/отмена удержания ✔️ ✔️ ✔️ ✔️
Активный динамик ✔️ ✔️ ✔️ ✔️
Выбор динамика для вызовов ✔️ ✔️ ✔️ ✔️
Выбор микрофона для вызовов ✔️ ✔️ ✔️ ✔️
Отображение состояния участника
Бездействие, Предварительные сигналы и сообщения, Подключение, Подключено, На удержании, В зале ожидания, Разъединенный
✔️ ✔️ ✔️ ✔️
Отображение состояния вызова
Предварительные сигналы и сообщения, Входящий, Подключение, Звонок, Подключено, На удержании, Отключение, Разъединенный
✔️ ✔️ ✔️ ✔️
Отображение того, отключен ли у участника микрофон ✔️ ✔️ ✔️ ✔️
Отображение причины, по которой участник закончил вызов ✔️ ✔️ ✔️ ✔️
Общий доступ к экрану Общий доступ ко всему экрану в приложении ✔️
Предоставление общего доступа к определенному приложению (из списка запущенных приложений) ✔️
Предоставление общего доступа к вкладке веб-браузера из списка открытых вкладок ✔️
Общий доступ к системным звукам во время демонстрации экрана
Участник может просмотреть демонстрацию удаленного экрана ✔️ ✔️ ✔️ ✔️
Список Список участников ✔️ ✔️ ✔️ ✔️
Удалить участника ✔️ ✔️ ✔️ ✔️
ТСОП Создать индивидуальный вызов с участником ТСОП ✔️ ✔️ ✔️ ✔️
Создать групповой вызов с участниками ТСОП ✔️ ✔️ ✔️ ✔️
Перевести индивидуальный вызов с участником ТСОП в групповой вызов ✔️ ✔️ ✔️ ✔️
Возможность отключиться от группового вызова в качестве участника ТСОП ✔️ ✔️ ✔️ ✔️
Поддержка ранних носителей ✔️ ✔️ ✔️ ✔️
Общие сведения Проверьте микрофон, динамик и камеру с помощью службы проверки звука (доступна по вызову 8:echo123) ✔️ ✔️ ✔️ ✔️
Управление устройствами Запрос разрешения на использование звука и видео ✔️ ✔️ ✔️ ✔️
Получение списка камер ✔️ ✔️ ✔️ ✔️
Настройка камеры ✔️ ✔️ ✔️ ✔️
Получение выбранной камеры ✔️ ✔️ ✔️ ✔️
Получение списка микрофонов ✔️ ✔️
Настройка микрофона ✔️ ✔️
Получение выбранного микрофона ✔️ ✔️
Получение списка докладчиков ✔️ ✔️
Настройка параметров докладчика ✔️ ✔️
Получение выбранного докладчика ✔️ ✔️
Рендеринг видео Рендеринг одного видео во многих расположениях (локальная камера или удаленный поток) ✔️ ✔️ ✔️ ✔️
Настройка или обновление режима масштабирования ✔️ ✔️ ✔️ ✔️
Рендеринг удаленного видеопотока ✔️ ✔️ ✔️ ✔️

Поддержки потоковой передачи пакетом SDK для вызовов

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

Ограничение Интернет Windows/Android/iOS
Максимальное число исходящих локальных потоков, которые можно отправить одновременно 1 видео и 1 демонстрация экрана 1 видео и 1 совместное использование экрана
Максимальное число исходящих удаленных потоков, которые можно одновременно преобразовать для просмотра 4 видео и 1 совместное использование экрана 6 видео и 1 совместное использование экрана

Хотя пакет SDK для вызовов не предполагает таких ограничений, пользователи могут столкнуться со снижением производительности, если эти ограничения превышены.

Время ожидания пакета SDK для вызовов

К пакетам SDK для вызовов Служб коммуникации применяются следующие значения времени ожидания:

Действие Время ожидания в секундах
Повторное подключение или удаление участника 120
Добавление новой модальности в вызов или ее удаление из него (запуск или завершение видео либо общий доступ к экрану) 40
Время ожидания операции передачи вызова 60
Время ожидания установки вызова в формате 1:1 85
Время ожидания установки группового вызова 85
Время ожидания установки вызова ТСОП 115
Время ожидания перевода вызова из формата 1:1 в формат группового вызова 115

Максимальная продолжительность вызова:

Максимальная продолжительность звонка составляет 30 часов. Участники, достигающие максимальной продолжительности звонка в 30 часов, будут отключены от звонка.

Поддержка пакета SDK JavaScript для вызовов в ОС и браузерах

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

Платформа Chrome Safari Microsoft Microsoft Edge (Chromium) Firefox
Android ✔️
iOS ✔️
macOS ✔️ ✔️ ✔️ ✔️
Windows ✔️ ✔️ ✔️
Ubuntu/Linux ✔️

Поддержка Android Calling SDK

  • Поддержка Android API уровня 21 или выше

  • Поддержка Java 7 или более поздней версии

  • Поддержка Android Studio 2.0

Поддержка iOS Calling SDK

  • Поддержка iOS 10.0+ во время сборки и iOS 12.0+ во время выполнения

  • Xcode 12.0+

Модель безопасности вызова между клиентом и браузером

Работа с WebRTC по протоколу HTTPS

Интерфейсы API WebRTC, например getUserMedia, требуют, чтобы вызывающее их приложение обслуживалось по протоколу HTTPS.

Для локальной разработки можно использовать http://localhost.

Внедрение пакета SDK для вызова Служб коммуникации в iframe

В различных браузерах была внедрена новая политика разрешений (также называемая политикой компонентов). Эта политика влияет на сценарии вызова, контролируя то, как приложения могут получать доступ к камере и микрофону устройства через элемент iframe с различными источниками.

Если вы хотите использовать элемент iframe для размещения части приложения из другого домена, необходимо добавить в него атрибут allow с правильным значением.

Например, этот iframe обеспечивает доступ как к камере, так и к микрофону:

<iframe allow="camera *; microphone *">

Дальнейшие действия

Дополнительные сведения см. в следующих статьях: