Kits SDK et API REST
Les fonctionnalités d’Azure Communication Services sont organisées de façon conceptuelle en zones discrètes en fonction de leur domaine fonctionnel. La plupart des domaines possèdent des kits de développement logiciel (SDK) entièrement open source, programmés sur des API REST publiées que vous pouvez utiliser directement sur Internet. Le Kit de développement logiciel (SDK) Appel utilise des interfaces réseau privées et est fermé.
Dans les tableaux suivants, nous résumons ces zones et la disponibilité des API REST et des bibliothèques du kit de développement logiciel (SDK). Nous notons si les API et les kits SDK sont destinés aux clients finaux ou aux environnements de service approuvés. Vous ne devez pas accéder directement aux API telles que SMS à l’aide d’appareils des utilisateurs finaux dans les environnements à faible niveau de confiance.
Vous pouvez accélérer le développement d’applications d’appel et de conversation à l’aide de la bibliothèque d’interface utilisateur Azure Communication Services. Cette bibliothèque d’interface utilisateur personnalisable fournit des composants d’interface utilisateur open source pour les applications web et mobiles, ainsi qu’un thème Microsoft Teams.
Création d’une pratique pour utiliser le kit de développement logiciel (SDK) le plus récent
Les navigateurs et les systèmes d’exploitation évoluent constamment pour prendre en charge les dernières améliorations et corriger les bogues existants. L’utilisation du SDK Azure Communication Services le plus récent peut vous aider à obtenir la meilleure expérience globale de l’utilisateur final pour votre application lorsqu'il est utilisé avec des navigateurs et des systèmes d'exploitation mis à jour. Le SDK Azure Communication Services le plus récent offre de nombreux avantages, tels qu'une meilleure performance, sécurité, compatibilité, qualité et facilité d'utilisation. La mise à jour vous permet d’accéder aux fonctionnalités et mises à jour les plus récentes qui sont régulièrement ajoutées au navigateur et au système d’exploitation. Les kits SDK Azure Communication Services sont fréquemment mis à jour (environ toutes les six semaines à une fois par trimestre). Nous vous recommandons de créer un processus pour vous assurer que vous effectuez toujours la mise à jour vers les kits SDK les plus récents.
SDK
| Assembly | Protocoles | Environnement | Fonctionnalités |
|---|---|---|---|
| Azure Resource Manager | REST | Service | Approvisionner et gérer les ressources Azure Communication Services. |
| Courant | S/O | Client et service | Fournit des types de base pour d’autres kits SDK. |
| Identité | REST | Service | Gérer les utilisateurs et les jetons d’accès. |
| Numéros de téléphone | REST | Service | Acquérir et gérer des numéros de téléphone. |
| SMS | REST | Service | Envoyer et recevoir des messages SMS. |
| REST | Service | Envoyer des e-mails et obtenir leur état. | |
| Conversation instantanée | REST avec signalisation protégée | Client et service | Ajouter des conversations texte en temps réel dans vos applications. |
| Appel | Transport propriétaire | Client | Voix, vidéo, partage d’écran et autres communications en temps réel. |
| Automatisation des appels | REST | Service | Créer des workflows d’appel personnalisés pour les appels RTC et VoIP. |
| Routeur de tâches | REST | Service | Optimiser la gestion des interactions client entre différentes applications. |
| Salles | REST | Service | Créer et gérer des salles de communication structurées. |
| Bibliothèque d’interface utilisateur | S/O | Client | Composants d’interface utilisateur prêts pour la production pour les applications d’appel et de conversation. |
| Messagerie avancée | REST | Service | Envoyer et recevoir des messages WhatsApp Business. |
Langages et emplacements de publication
Emplacements de publication pour les packages de kit de développement logiciel (SDK) individuels :
| Zone | JavaScript | .NET | Python | Java SE | iOS | Android | Autres |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPI | Maven | - | - | Go via GitHub |
| Courant | npm | NuGet | S/O | Maven | GitHub | Maven | - |
| Identité | npm | NuGet | PyPI | Maven | - | - | - |
| Numéros de téléphone | npm | NuGet | PyPI | Maven | - | - | - |
| Converser | npm | NuGet | PyPI | Maven | GitHub | Maven | - |
| sms | npm | NuGet | PyPI | Maven | - | - | - |
| npm | NuGet | PyPI | Maven | - | - | - | |
| Appel | npm | NuGet | - | - | CocoaPods | Maven | - |
| Automatisation des appels | npm | NuGet | PyPI | Maven | |||
| Routeur de tâches | npm | NuGet | PyPI | Maven | |||
| Salles | npm | NuGet | PyPI | Maven | - | - | - |
| Bibliothèque d’interface utilisateur | npm | - | - | - | GitHub | GitHub | GitHub, Storybook |
| Messagerie avancée | npm | NuGet | PyPI | Maven | - | - | - |
| Documentation de référence | docs | docs | docs | docs | docs | docs | - |
Détails de la prise en charge de la plateforme des Kits de développement logiciel (SDK)
Prise en charge du SDK d’appel Android
- Prise en charge de l’API Android Niveau 21 ou ultérieur
- Prise en charge de Java 7 ou version ultérieure
- Prise en charge d'Android Studio 2.0
Prise en charge des plateformes Android
L’écosystème Android est vaste, englobant différentes versions et plateformes spécialisées conçues pour divers types d’appareils. Le tableau suivant répertorie les plateformes Android actuellement prises en charge :
| Appareils | Description | Support |
|---|---|---|
| Téléphones et tablettes | Appareils standard exécutant Android Commercial. | Prise en charge complète de la résolution vidéo. |
Remarque
Nous ne prenons en charge que les appels vidéo sur les téléphones et les tablettes.. Pour les cas d’usage impliquant la vidéo sur des appareils ou plateformes non standard (comme des lunettes intelligentes ou des appareils personnalisés), nous vous suggérons de nous contacter au début de votre processus de développement pour vous aider à déterminer l’approche d’intégration la plus appropriée.
Si vous avez détecté des problèmes pendant votre implémentation, consultez le guide de résolution des problèmes.
Prise en charge du SDK d’appel iOS
- Prise en charge d’iOS 10.0 et versions ultérieures au moment de la génération et d’iOS 12.0 et versions ultérieures au moment de l’exécution
- XCode 12.0 et versions ultérieures
- Prise en charge pour iPadOS 13.0+
.NET
L’appel prend en charge les plateformes suivantes :
- UWP avec .NET Native ou C++/WinRT
- Windows 10/11 10.0.17763 – 10.0.22621.0
- Windows Server 2019/2022 10.0.17763 – 10.0.22621.0
- WinUI3 avec .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.22621.0
Tous les autres packages Communication Services ciblent .NET Standard 2.0, qui prend en charge les plateformes suivantes :
- Prise en charge via .NET Framework 4.6.1
- Windows 10, 8.1, 8 et 7
- Windows Server 2012 R2, 2012 et 2008 R2 SP1
- Prise en charge via .NET Core 2.0 :
- Windows 10 (1607 et plus), 7 SP1 et plus, 8.1
- Windows Server 2008 R2 SP1+
- Max OS X 10.12 et plus
- Versions/distributions multiples de Linux
- UWP 10.0.16299 (RS3) Septembre 2017
- Unity 2018.1
- Mono 5.4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
Taille du package SDK
| Kit SDK | Taille compressée (Mo) | Taille non compressée (Mo) |
|---|---|---|
| Kit de développement logiciel (SDK) iOS | Arm64 : 17,1 Mo | Arm64 : 61,1 Mo |
| Android SDK | x86 : 13,3 Mo | x86 – 33,75 Mo |
| x86_64 – 13,3 Mo | x86_64 – 35,75 Mo | |
| Arm64-v8a : 13,1 Mo | Arm64-v8a : 37,02 Mo | |
| armeabi-v7a – 11,4 Mo | armeabi-v7a – 23,97 Mo |
Si vous souhaitez améliorer votre application, consultez l’article sur les meilleures pratiques. Vous y trouverez des recommandations et une liste de contrôle à examiner avant de publier votre application.
API REST
Les API Communication Services sont documentées avec d’autres API REST Azure. Cette documentation décrit comment structurer vos messages HTTP et fournit une aide pour utiliser Postman. La documentation de l’interface REST est également publiée au format OpenAPI sur GitHub. Vous trouverez les seuils de limitation pour les différentes API dans Limites du service.
Attentes en matière de stabilité des API
Important
Cette section fournit une aide sur les API REST et les Kits de développement logiciel (SDK) ayant l’indication stable. Les API ayant l’indication version préliminaire, préversion ou bêta sont susceptibles d’être modifiées ou déconseillées sans préavis.
À l’avenir, il est possible que des versions des Kits de développement logiciel (SDK) Communication Services soient mises hors service et que des changements cassants soient apportés à nos API REST et aux Kits de développement logiciel (SDK) publiés. Les Azure Communication Services respectent généralement deux stratégies de prise en charge pour la suppression de versions de service :
- En cas de modification de l’interface Communication Services nécessitant un changement de code, vous êtes informé au moins trois ans à l’avance. Toutes les API REST et API de Kit de développement logiciel (SDK) documentées reçoivent généralement un avertissement trois ans avant la suppression d’une interface.
- Vous êtes informé au moins un an avant d’avoir à mettre à jour les assemblys de Kits de développement logiciel (SDK) vers la dernière version mineure. Ces mises à jour obligatoires ne doivent nécessiter aucune modification de code, car elles ont lieu dans la même version principale. L’utilisation de la dernière version du SDK est particulièrement importante pour les bibliothèques d’appel et de conversation qui requièrent souvent des mises à jour de sécurité et de performances. Nous vous encourageons vivement à maintenir à jour vos SDK Communication Services.
Exemples de suppression d’API et de Kit de développement logiciel (SDK)
Vous avez intégré la version v24 de l’API REST SMS à votre application. Azure Communication publie la version v25.
Vous êtes averti 3 ans avant la mise hors service de ces API et la mise à niveau forcée vers la version 25. Cette mise à jour peut nécessiter une modification du code.
Vous avez intégré la version v2.02 du SDK Appel à votre application. Azure Communication publie la version v2.05.
Vous serez probablement invité à effectuer une mise à jour vers la version 2.05 du Kit de développement logiciel (SDK) Appel dans les 12 mois suivant la publication de cette version. La mise à jour doit être un remplacement de l’artefact sans nécessiter de modification de code, car la version v2.05 se trouve dans la version principale v2 et n’a aucun changement cassant.
Étapes suivantes
Pour plus d’informations, consultez les présentations de Kit de développement logiciel (SDK) suivantes :
- Vue d’ensemble du Kit de développement logiciel (SDK) Appel
- Vue d’ensemble du SDK Call Automation
- Vue d’ensemble du SDK Job Router
- Vue d’ensemble du Kit de développement logiciel (SDK) Conversation
- Vue d’ensemble du Kit de développement logiciel (SDK) SMS
- Vue d’ensemble du SDK E-mail
- Vue d’ensemble du kit de développement logiciel (SDK) de messagerie avancée
Pour prendre en main Azure Communication Services :