Пакеты SDK и интерфейсы REST API
Службы коммуникации Azure возможности концептуально организованы в дискретные области на основе их функциональной области. Большинство областей имеют полностью пакеты SDK с открытым исходным кодом, программируемые для опубликованных ИНТЕРФЕЙСов REST API, которые можно использовать непосредственно через Интернет. Вызывающий пакет SDK использует собственные сетевые интерфейсы и является пакетом с закрытым исходным кодом.
В приведенных ниже таблицах в сводном виде представлены области и доступность интерфейсов REST API и библиотек SDK. Обратите внимание, что API и пакеты SDK предназначены для клиентов конечных пользователей или доверенных сред служб. ТАКИЕ API, как SMS, не должны напрямую обращаться к устройствам конечных пользователей в средах с низким уровнем доверия.
Разработка приложений для звонков и чатов может быть ускорена библиотекой пользовательского интерфейса Службы коммуникации Azure. Настраиваемая библиотека пользовательского интерфейса предоставляет компоненты пользовательского интерфейса с открытым исходным кодом для веб-приложений и мобильных приложений, а также тему Microsoft Teams.
Пакеты SDK
| Сборка | Протоколы | Среда | Возможности |
|---|---|---|---|
| Azure Resource Manager | REST | Service | Создание ресурсов служб коммуникации Azure и управление ими |
| Распространенный почтовый сервис | Н/П | Клиент и служба | Предоставление базовых типов для других пакетов SDK |
| Идентификация | REST | Service | Управление пользователями и маркерами доступа |
| Номера телефонов | REST | Service | Получение номеров телефонов и управление ими |
| SMS | REST | Service | Отправка и получение текстовых сообщений |
| Эл. почта | REST | Service | Отправка и получение статуса в сообщениях электронной почты |
| Чат | REST с собственной системой сигналов | Клиент и служба | Добавление в приложения текстового чата, работающего в режиме реального времени |
| Совершение вызовов | Собственный транспорт | Клиент | Голосовая связь, видео, совместное использование экрана и другие возможности обмена данными в реальном времени |
| Автоматизация вызовов | REST | Service | Создание настраиваемых рабочих процессов звонков для вызовов ТСОП и VoIP |
| Маршрутизатор заданий | REST | Service | Оптимизация управления взаимодействием с клиентами в различных приложениях |
| Rooms | REST | Service | Создание структурированных комнат коммуникации и управление ими |
| Библиотека пользовательского интерфейса | Н/П | Клиент | Готовые к работе компоненты пользовательского интерфейса для приложений чата и вызовов |
| Расширенное обмен сообщениями | REST | Service | Отправка и получение сообщений WhatsApp Business |
Языки и места публикации
Расположения публикации для отдельных пакетов SDK:
| Площадь | JavaScript | .NET | Python | Java SE | iOS | Android | Другие |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | Через GitHub |
| Распространенный почтовый сервис | npm | NuGet | Н/П | Maven | GitHub | Maven | - |
| Идентификация | npm | NuGet | PyPi | Maven | - | - | - |
| Номера телефонов | npm | NuGet | PyPi | Maven | - | - | - |
| Чат | npm | NuGet | PyPi | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| Эл. почта | npm | NuGet | PyPi | Maven | - | - | - |
| Совершение вызовов | npm | NuGet | - | - | CocoaPods | Maven | - |
| Автоматизация вызовов | npm | NuGet | PyPi | Maven | |||
| Маршрутизатор заданий | npm | NuGet | PyPi | Maven | |||
| Rooms | npm | NuGet | PyPi | Maven | - | - | - |
| Библиотека пользовательского интерфейса | npm | - | - | - | GitHub | GitHub | GitHub, Storybook |
| Расширенное обмен сообщениями | npm | NuGet | PyPi | Maven | - | - | - |
| Справочная документация | Документация | Документация | Документация | Документация | Документация | Документация | - |
Сведения о поддержке платформы пакетов SDK
Поддержка Android Calling SDK
- Поддержка Android API уровня 21 или выше
- Поддержка Java 7 или более поздней версии
- Поддержка Android Studio 2.0
- Устройства Android Auto (AAOS) и IoT под управлением 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.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 с пакетом обновления 1
- Поддержка через .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
| SDK | Сжатый размер (МБ) | Несжатый размер (МБ) |
|---|---|---|
| Пакет SDK для iOS | ARM64 — 17.1 МБ | ARM64 — 61.1 МБ |
| Пакет SDK для Android | x86 – 13.3 МБ | x86 – 33.75 МБ |
| x86_64 – 13.3 МБ | x86_64 – 35.75 МБ | |
| ARM64-v8a – 13.1 МБ | ARM64-v8a – 37.02 МБ | |
| armeabi-v7a – 11.4 МБ | armeabi-v7a – 23.97 МБ |
Если вы хотите улучшить приложение, мы рекомендуем ознакомиться со статьей о рекомендациях. Он предоставляет рекомендации и список проверка для проверки перед выпуском приложения.
Интерфейсы REST API
API служб коммуникации документируются вместе с другими ИНТЕРФЕЙСами REST API Azure. В этой документации рассказывается, как структурировать HTTP-сообщения и предлагает рекомендации по использованию Postman. Документация по интерфейсу REST также опубликована в формате Swagger на сайте GitHub. Ограничения регулирования для отдельных API можно найти на странице ограничений службы.
Ожидание стабильных API
Внимание
В этом разделе содержатся рекомендации по API-интерфейсам REST и пакетам SDK, помеченным как стабильные. API-интерфейсы, помеченные как предварительный выпуск, предварительная версия или бета-версия, могут быть изменены или устареть без предварительного уведомления.
В будущем мы можем прекратить поддержку версий пакетов SDK для служб коммуникации Azure, а также внести существенные изменения в свои API-интерфейсы REST и выпущенные пакеты SDK. Службы коммуникации Azure обычно следует двум политикам поддержки для выхода версий служб.
- Вы получите оповещение по крайней мере за три года, прежде чем потребуется изменить код из-за изменения интерфейса служб коммуникации Azure. Все документированные API-интерфейсы REST и API-интерфейсы пакетов SDK обычно работают по крайней мере три года до списания интерфейсов.
- Вы получите оповещение по крайней мере за один год, прежде чем придется обновить сборки пакета SDK до последнего дополнительного номера версии. Эти необходимые обновления не должны требовать никаких изменений в коде, так как основной номер версии сохраняется. Использование новейшего пакета SDK особенно важно для библиотек вызовов и чатов как компонентов, работающих в реальном времени, которым часто требуются обновления безопасности и производительности. Мы настоятельно рекомендуем своевременно обновлять все пакеты SDK для Служб коммуникации Azure.
Примеры списания API и пакета SDK
Вы интегрировали версию 24 REST API SMS в приложение. Служба коммуникации Azure выпускает версии 25.
Вы получите предупреждение за три года до того, как эти API-интерфейсы перестанут работать и принудительно будут обновлены до v25. Это обновление может потребовать внести изменения в код.
Вы интегрировали версию 2.02 пакета SDK для вызовов в приложение. Выпуски Azure Communication версии 2.05.
Может понадобиться обновить пакет SDK до версии v2.05 в течение 12 месяцев после выпуска v2.05. Обновление должно быть заменой артефакта без необходимости изменения кода, так как версия 2.05 находится в основной версии 2 и не имеет критических изменений.
Следующие шаги
Дополнительные сведения см. в следующих обзорах пакетов SDK:
- Основные сведения о пакете SDK для вызовов
- Обзор пакета SDK службы автоматизации вызовов
- Общие сведения о пакете SDK для маршрутизатора заданий
- Основные сведения о пакете SDK для чатов
- Основные сведения о пакете SDK для SMS
- Обзор пакета SDK для электронной почты
- Общие сведения о пакете SDK для расширенного обмена сообщениями
Чтобы начать работу со службами коммуникации Azure, выполните следующие действия.