SDKs und REST-APIs
Funktionen von Azure Communication Services sind konzeptionell basierend auf ihrem Funktionsbereich in diskreten Bereichen organisiert. Die meisten Bereiche weisen reine Open-Source-SDKs auf, die für veröffentlichte REST-APIs programmiert sind, und die Sie direkt über das Internet nutzen können. Das Calling SDK verwendet proprietäre Netzwerkschnittstellen und ist Closed-Source.
In den folgenden Tabellen sind diese Bereiche und die Verfügbarkeit von REST-APIs und SDK-Bibliotheken zusammengefasst. Es wird jeweils darauf hingewiesen, ob APIs und SDKs für Endbenutzerclients oder vertrauenswürdige Dienstumgebungen bestimmt sind. Von Endbenutzergeräten darf in Umgebungen mit niedriger Vertrauenswürdigkeit nicht direkt auf APIs wie SMS zugegriffen werden.
Die Entwicklung von Anruf- und Chatanwendungen kann durch die UI-Bibliothek von Azure Communication Services beschleunigt werden. Die anpassbare UI-Bibliothek bietet Open-Source-Komponenten für die Benutzeroberfläche für Web- und mobile Apps sowie ein Microsoft Teams-Design.
Erstellen einer Praxis für die Verwendung des neuesten SDK
Browser und Betriebssysteme entwickeln sich ständig weiter, um die neuesten Verbesserungen zu unterstützen und vorhandene Fehler zu beheben. Die Verwendung des neuesten Azure Communication Services SDK kann Ihnen helfen, die beste Funktionalität für Endbenutzer für Ihre Anwendung zu erzielen, wenn sie mit aktualisierten Browsern und Betriebssystemupdates verwendet wird. Das neueste Azure Communication Services SDK bietet viele Vorteile, z. B. bessere Leistung, Sicherheit, Kompatibilität, Qualität und Benutzerfreundlichkeit. Durch das Aktualisieren können Sie auf die neuesten Features und Updates zugreifen, die dem Browser und Betriebssystem regelmäßig hinzugefügt werden. Azure Communication Services SDKs werden häufig aktualisiert (ungefähr alle 6 Wochen bis einmal pro Quartal). Es wird empfohlen, einen Prozess einzurichten, der sicherstellt, dass Sie immer auf die neuesten SDKs aktualisieren.
SDKs
| Assembly | Protokolle | Environment | Capabilities |
|---|---|---|---|
| Azure Resource Manager | REST | Dienst | Dient zum Bereitstellen und Verwalten von Communication Services-Ressourcen |
| Allgemein | N/V | Client und Dienst | Stellt Basistypen für andere SDKs zur Verfügung |
| Identität | REST | Dienst | Verwalten von Benutzern, Zugriffstoken |
| Telefonnummern | REST | Dienst | Erfassen und Verwalten von Telefonnummern |
| SMS | REST | Dienst | Senden und Empfangen von SMS-Nachrichten |
| E‑Mail | REST | Dienst | Senden und Abrufen des Status von E-Mail-Nachrichten |
| Chat | REST mit proprietärer Signalisierung | Client und Dienst | Dient zum Hinzufügen von Textchat in Echtzeit zu Ihren Anwendungen |
| Calling | Proprietärer Transport | Client | Sprache, Video, Bildschirmfreigabe und andere Echtzeitkommunikation |
| Anrufautomatisierung | REST | Dienst | Erstellen angepasster Anrufworkflows für PSTN- und VoIP-Anrufe |
| Auftragsrouter | REST | Dienst | Optimieren der Verwaltung von Kundeninteraktionen über verschiedene Anwendungen hinweg |
| Räume | REST | Dienst | Erstellen und Verwalten strukturierter Kommunikationsräume |
| UI-Bibliothek | N/V | Client | Produktionsbereite UI-Komponenten für Chat- und Anruf-Apps |
| Erweitertes Messaging | REST | Dienst | Senden und Empfangen von WhatsApp Business-Nachrichten |
Sprachen und Veröffentlichungsspeicherorte
Veröffentlichungsspeicherorte für einzelne SDK-Pakete:
| Bereich | JavaScript | .NET | Python | Java SE | iOS | Android | Andere |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | Go über GitHub |
| Allgemein | npm | NuGet | N/V | Maven | GitHub | Maven | - |
| Identität | npm | NuGet | PyPi | Maven | - | - | - |
| Telefonnummern | npm | NuGet | PyPi | Maven | - | - | - |
| Chat | npm | NuGet | PyPi | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| E‑Mail | npm | NuGet | PyPi | Maven | - | - | - |
| Aufrufen | npm | NuGet | - | - | CocoaPods | Maven | - |
| Anrufautomatisierung | npm | NuGet | PyPi | Maven | |||
| Auftragsrouter | npm | NuGet | PyPi | Maven | |||
| Räume | npm | NuGet | PyPi | Maven | - | - | - |
| UI-Bibliothek | npm | - | - | - | GitHub | GitHub | GitHub, Storybook |
| Erweitertes Messaging | npm | NuGet | PyPi | Maven | - | - | - |
| Referenzdokumentation | docs | docs | docs | docs | docs | docs | - |
Details zur SDK-Plattformunterstützung
Android Calling SDK-Unterstützung
- Unterstützung für Android-API Level 21 oder höher
- Unterstützung für Java 7 oder höher
- Unterstützung für Android Studio 2.0
Android-Plattformunterstützung
Das Android-Ökosystem ist umfangreich und umfasst verschiedene Versionen sowie spezialisierte Plattformen, die für verschiedene Arten von Geräten entwickelt wurden. In der nächsten Tabelle sind die derzeit unterstützten Android-Plattformen aufgeführt:
| Geräte | Beschreibung | Unterstützung |
|---|---|---|
| Smartphones und Tablets | Standardgeräte, auf denen Android Commercial ausgeführt wird. | Vollständige Unterstützung der Videoauflösung. |
Hinweis
Videoanrufe werden nur auf Smartphones und Tablets unterstützt. Für Anwendungsfälle mit Videos auf Geräten, bei denen es sich nicht um Standardgeräte oder -plattformen handelt (z. B. Smartglasses oder benutzerdefinierte Geräte), sollten Sie sich frühzeitig im Entwicklungsprozess an uns wenden, damit wir Ihnen dabei helfen können, den am besten geeigneten Integrationsansatz zu ermitteln.
Falls während der Implementierung Probleme aufgetreten sind, empfehlen wir Ihnen, den Leitfaden zur Problembehandlung zu nutzen.
iOS Calling SDK-Unterstützung
- Unterstützung für iOS 10.0 und höher zur Erstellungszeit und iOS 12.0 und höher zur Laufzeit
- Xcode 12.0 oder höher
- Unterstützung für iPadOS 13.0+
.NET
Aufrufe werden auf den folgenden Plattformen unterstützt:
- UWP mit .NET Native oder C++/WinRT
- Windows 10/11 10.0.17763 – 10.0.22621.0
- Windows Server 2019/2022 10.0.17763 - 10.0.22621.0
- WinUI3 mit .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
Alle anderen Communication Services-Pakete zielen ab auf .NET Standard 2.0 ab, das die folgenden Plattformen unterstützt:
- Unterstützung über .NET Framework 4.6.1
- Windows 10, 8.1, 8 und 7
- Windows Server 2012 R2, 2012 und 2008 R2 SP1
- Unterstützung über .NET Core 2.0:
- Windows 10 (ab 1607), 7 SP1+, 8.1
- Windows Server 2008 R2 SP1+
- Mac OS X ab 10.12
- Mehrere Versionen/Distributionen von Linux
- UWP 10.0.16299 (RS3) September 2017
- Unity 2018.1
- Mono 5.4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
Größe des SDK-Pakets
| SDK | Komprimiert (MB) | Unkomprimiert (MB) |
|---|---|---|
| iOS SDK | ARM64: 17,1 MB | ARM64: 61,1 MB |
| Android-SDK | x86: 13,3 MB | x86: 33,75 MB |
| x86_64: 13,3 MB | x86_64: 35,75 MB | |
| ARM64-v8a: 13,1 MB | ARM64-v8a: 37,02 MB | |
| armeabi-v7a: 11,4 MB | armeabi-v7a: 23,97 MB |
Informationen zur Verbesserung Ihrer App finden Sie in diesem Artikel zu bewährten Methoden. Er enthält Empfehlungen und eine Prüfliste, die Sie vor dem Veröffentlichen Ihrer App durchgehen können.
REST-APIs
Communication Services-APIs sind neben anderen Azure-REST-APIs dokumentiert. In dieser Dokumentation wird die Strukturierung Ihrer HTTP-Nachrichten erläutert und ein Leitfaden zur Verwendung von Postman bereitgestellt. Die Dokumentation zur REST-Schnittstelle wurde auch im Swagger-Format auf GitHub veröffentlicht. Sie finden Drosselungseinschränkungen für einzelne APIs auf der Seite „Diensteinschränkungen“.
Erwartungen an die API-Stabilität
Wichtig
Dieser Abschnitt enthält Anleitungen zu REST-APIs und SDKs, die als stabil gekennzeichnet sind. APIs, die als Vorabversion, Vorschau oder Beta gekennzeichnet sind, können ohne Vorankündigung geändert oder als veraltet eingestuft werden.
In der Zukunft werden wir möglicherweise Versionen der SDKs für Kommunikationsdienste außer Betrieb nehmen, und wir könnten bahnbrechende Veränderungen an unseren REST-APIs und veröffentlichten SDKs vornehmen. Für Azure Communication Services gelten zwei allgemeine Richtlinien zur Unterstützung des Zurückziehens von Dienstversionen:
- Sie werden mindestens drei Jahre vorher benachrichtigt, ehe Sie aufgrund einer Änderung einer Communication Services-Schnittstelle Code ändern müssen. Bei allen dokumentierten REST-APIs und SDK-APIs wird in der Regel eine mindestens dreijährige Vorwarnzeit eingehalten, bevor Schnittstellen ausgemustert werden.
- Sie werden mindestens ein Jahr, bevor Sie SDK-Assemblys auf die neueste Nebenversion aktualisieren müssen, benachrichtigt. Diese erforderlichen Aktualisierungen sollten keine Codeänderungen erfordern, da sie zur gleichen Hauptversion gehören. Die Verwendung des neuesten SDK ist besonders wichtig für die Bibliotheken „Calling“ und „Chat“, die über Echtzeitkomponenten verfügen, bei denen häufig Sicherheits- und Leistungsaktualisierungen erforderlich sind. Wir empfehlen Ihnen nachdrücklich, sämtliche Ihrer Communication Services-SDKs auf dem neuesten Stand zu halten.
Beispiele für die Außerbetriebnahme von API und SDK
Sie haben Version 24 der REST-API „SMS“ in Ihre Anwendung integriert. Azure Communication veröffentlicht Version 25.
Sie erhalten eine dreijährige Vorwarnung, bevor diese APIs nicht mehr funktionieren und Sie gezwungen sind, auf v25 upzudaten. Dieses Update erfordert möglicherweise eine Codeänderung.
Sie haben die Version 2.02 vom Calling-SDK in Ihre Anwendung integriert. Azure Communication veröffentlicht Version 2.05.
Es kann erforderlich sein, dass Sie innerhalb von 12 Monaten nach der Freigabe des v2.05 auf die Version v2.05 des Calling SDK aktualisieren müssen. Bei dem Update sollte es sich um einen Austausch des Artefakts handeln, ohne dass eine Codeänderung erforderlich ist, da die Version 2.05 zur Hauptversion 2 gehört und keine Breaking Changes enthält.
Nächste Schritte
Weitere Informationen finden Sie in den folgenden SDK-Übersichten:
- Calling SDK Übersicht
- Übersicht über das Anrufautomatisierungs-SDK
- Übersicht über das Job Router SDK
- Chat SDK Übersicht
- SMS SDK Übersicht
- Übersicht über das Email SDK
- Übersicht über das SDK für erweitertes Messaging
Für den Einstieg in Azure Communication Services: