Пакеты SDK и интерфейсы REST API

Службы связи Azure концептуально организованы в отдельные функциональные разделы на основе их области применения. Большинство областей представляют полный набор SDK с открытым исходным кодом, предназначенный для работы с опубликованными интерфейсами REST API, которые можно использовать непосредственно через Интернет. Calling SDK использует собственные сетевые интерфейсы и имеет закрытый исходный код.

В следующих таблицах приведён краткий обзор этих областей и наличия интерфейсов REST API и библиотек SDK. Обратите внимание, предназначены ли API и пакеты SDK для клиентов конечных пользователей или доверенных сред служб. Не следует напрямую обращаться к ТАКИМ API, как SMS, с помощью устройств конечных пользователей в средах с низким уровнем доверия.

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

Создание практики использования последнего пакета SDK

Браузеры и операционные системы постоянно развиваются для поддержки последних улучшений и устранения существующих ошибок. Используя самый последний пакет SDK для Службы коммуникации Azure, вы можете добиться оптимального общего взаимодействия с приложением при использовании с обновленными браузерами и обновлениями операционной системы. Большинство обновлений Службы коммуникации Azure SDK предлагает множество преимуществ, таких как улучшенная производительность, безопасность, совместимость, качество и удобство использования. Обновление позволяет получать доступ к новейшим функциям и обновлениям, которые регулярно добавляются в браузер и операционную систему. Пакеты SDK для служб коммуникации Azure обновляются часто (примерно каждые шесть недель или один раз в квартал). Мы рекомендуем создать процесс, чтобы убедиться, что вы всегда обновляете последние пакеты SDK.

Пакеты SDK

Языки и места публикации

Расположения публикации для отдельных пакетов SDK:

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

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

• Поддержка Android API уровня 21 или выше
• Поддержка Java 7 или более поздней версии
• Поддержка Android Studio 2.0

Поддержка платформы Android

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

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

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

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

.NET

Функция вызовов поддерживает следующие платформы:

• UWP с .NET Native или C++/WinRT
  • Windows 10/11 10.0.17763 — 10.0.22621.0
  • Windows Server 2019/2022 10.0.17763 — 10.0.22621.0
• WinUI3 с .NET 6
  • Windows 10/11 10.0.17763.0 — net6.0-windows10.0.22621.0
  • Windows Server 2019/2022 10.0.17763.0 — net6.0-windows10.0.0.22621.0

Все остальные пакеты служб коммуникации предназначены для .NET Standard 2.0, которая поддерживает следующие платформы:

• Поддержка в платформе .NET Framework 4.6.1
  • Windows 10, 8.1, 8 и 7
  • Windows Server 2012 R2, 2012 и 2008 R2 SP1
• Поддержка через .NET Core 2.0:
  • Windows 10 (1607+), 7 с пакетом обновления 1 (SP1) или более поздняя версия, 8.1
  • Windows Server 2008 R2 с пакетом обновления 1 (SP1) и выше.
  • Mac OS X 10.12+
  • Несколько версий и дистрибутивов Linux
  • UWP 10.0.16299 (RS3), сентябрь 2017 г.
  • Unity 2018.1.
  • Mono 5.4
  • Xamarin iOS 10.14
  • Xamarin Mac 3.8

Размер пакета SDK

Если вы хотите улучшить приложение, ознакомьтесь со статьей "Рекомендации". Он предоставляет рекомендации и контрольный список перед выпуском приложения.

REST API

API служб коммуникации описаны вместе с другими REST API Azure. В этой документации описывается структура HTTP-сообщений и рекомендации по использованию Postman. Документация по интерфейсу REST также опубликована в формате OpenAPI на сайте GitHub. Ограничения регулирования для отдельных API можно найти в ограничениях службы.

Ожидания стабильности API

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

• Вас уведомляют по крайней мере за три года до того, как потребуется изменить код из-за изменения интерфейса служб связи. Все документированные API-интерфейсы REST и API-интерфейсы пакетов SDK обычно получают как минимум трехлетнее предупреждение перед выводом интерфейсов из эксплуатации.
• Вас уведомляют по крайней мере за один год до того, как необходимо обновить сборки SDK до последней минорной версии. Эти необходимые обновления не должны требовать никаких изменений в коде, потому что они относятся к той же основной версии. Использование новейшего пакета SDK особенно важно для библиотек вызовов и чатов как компонентов, работающих в реальном времени, которым часто требуются обновления безопасности и производительности. Мы настоятельно рекомендуем своевременно обновлять все ваши SDK для служб связи.

Примеры списания API и пакета SDK

Вы интегрировали версию 24 REST API SMS в приложение. Azure Communication выпускает версию 25.

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

Вы интегрировали версию 2.02 пакета SDK для вызовов в приложение. Выпуск Azure Communication версии 2.05.

Вам может понадобиться обновить Calling SDK до версии v2.05 в течение 12 месяцев после выпуска v2.05. Обновление должно быть заменой артефакта без необходимости изменения кода, так как версия 2.05 находится в основной версии 2 и не имеет критических изменений.

Следующие шаги

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

• Основные сведения о пакете SDK для вызовов
• Обзор пакета SDK службы автоматизации вызовов
• Обзор SDK маршрутизатора заданий
• Основные сведения о пакете SDK для чатов
• Основные сведения о пакете SDK для SMS
• Обзор пакета SDK для электронной почты
• Общие сведения о пакете SDK для расширенного обмена сообщениями

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

• Создайте ресурс Служб коммуникации Azure.
• Создайте Маркеры доступа пользователей.