Übersicht über das Calling SDK

Mit Azure Communication Services können Endbenutzerbrowser, Anwendungen und Dienste die Sprach- und Videokommunikation steuern. Diese Seite konzentriert sich auf das Aufrufen des Client-SDK, das in Websites und systemeigene Anwendungen eingebettet werden kann. Auf dieser Seite finden Sie ausführliche Beschreibungen der Client-Anruffunktionen, z. B. Informationen zur Plattform- und Browserunterstützung. Dienste verwalten Anrufe programmatisch und greifen darauf zu, indem sie die Anrufautomatisierungs-APIs verwenden. Die Räume-API ist eine optionale Azure Communication Services-API, die einem Sprach- oder Videoanruf zusätzliche Funktionen hinzufügt, z. B. Rollen und Berechtigungen.

Wenn Sie ihre eigene Benutzererfahrung mit dem Anruf-SDK erstellen möchten, schauen Sie sich Anrufschnellstarts oder Anruf-Hero-Beispiel an.

Wenn Sie Hilfe bei der Endbenutzererfahrung benötigen, bietet die Azure Communication Services UI-Bibliothek eine Sammlung von produktionsfertigen Open-Source-UI-Komponenten, die Sie in Ihre Anwendung einfügen können. Mit dieser Reihe vordefinierter Steuerelemente können Sie mithilfe der Fluent-Entwurfssprache von Microsoft ansprechende Kommunikationserfahrungen erstellen. Wenn Sie mehr über die UI-Bibliothek erfahren möchten, besuchen Sie die Übersichtswebsite.

Sobald Sie mit der Entwicklung beginnen, können Sie auf der Seite mit den bekannten Problemen nach Fehlern suchen, an denen wir arbeiten.

SDK-Links

Schlüsselfunktionen

• Geräteverwaltung und Medien: Das Calling SDK ermöglicht die Bindung an Audio- und Videogeräte, codiert Inhalte für eine effiziente Übertragung über die Kommunikationsdatenebene und rendert Inhalte für von Ihnen angegebene Ausgabegeräte und Ansichten. Darüber hinaus stehen APIs für die Bildschirm- und Anwendungsfreigabe zur Verfügung.
• Telefonfestnetz: Das Calling SDK kann Sprachanrufe über das herkömmliche Telefonfestnetz empfangen und tätigen – entweder unter Verwendung von Telefonnummern, die über das Azure-Portal beschafft wurden, oder programmgesteuert. Sie können auch eigene Nummern mit Session Border Controllern mitbringen.
• Teams Meetings und Calling – Das Calling SDK kann an Teams Meetings teilnehmen und mit der Sprach- und Videodatenebene von Teams interagieren.
• Verschlüsselung: Datenverkehr wird durch das Calling SDK verschlüsselt, um Manipulationen bei der Übertragung zu verhindern.
• Adressierung: Azure Communication Services bietet generische Identitäten zur Adressierung von Kommunikationsendpunkten. Clients nutzen diese Identitäten, um sich bei dem Dienst zu authentifizieren und miteinander zu kommunizieren. Diese Identitäten werden in Anruf-APIs verwendet, mit denen Clients die Anrufteilnehmer*innen (die Teilnehmerliste) ermitteln können.
• Sicherheit für den Benutzerzugriff
  • Roster-Kontrolle, Zeitplan-Kontrolle und Benutzer-Rollen/Berechtigungen werden über Virtual Rooms durchgesetzt.
  • Die Fähigkeit eines Benutzers, einen neuen Anruf einzuleiten oder einem bestehenden Anruf beizutreten, kann über Benutzeridentitäten und Token verwaltet werden
• Benachrichtigungen: Das Calling SDK stellt APIs bereit, die es ermöglichen, Clients über einen eingehenden Anruf zu informieren. In Situationen, in denen Ihre Anwendung nicht im Vordergrund läuft, stehen Muster zur Verfügung, um Popupbenachrichtigungen („Toasts“) auszulösen, die den Endbenutzer über einen eingehenden Anruf informieren.
• Medienstatistiken – Das Calling SDK bietet umfassende Einblicke in die Metriken Ihrer VoIP- und Videoanrufe. Mit diesen Informationen verfügen Entwickler über ein klareres Verständnis der Anrufqualität und können fundierte Entscheidungen treffen, um ihre Kommunikationserfahrung weiter zu verbessern.
• Videoeinschränkungen – Das Calling SDK bietet APIs, mit denen Sie die Videoqualität und andere Parameter während eines Videoanrufs regulieren können, indem Sie Parameter wie Auflösung und Bildfrequenz anpassen und so verschiedene Anrufsituationen für unterschiedliche Videoqualitätsebenen unterstützen
• Benutzerorientierte Diagnose (User Facing Diagnostics, UFD) – Das Calling SDK stellt Ereignisse bereit, die darauf ausgelegt sind, Einblicke in zugrundeliegende Probleme zu liefern, die sich auf die Anrufqualität auswirken können. Entwickler können Auslöser wie schwache Netzsignale oder stumm geschaltete Mikrofone abonnieren und so sicherstellen, dass sie immer über alle Faktoren informiert sind, welche die Anrufe beeinflussen.

Detaillierte Funktionen

Die folgende Liste enthält die Features, die aktuell in den Azure Communication Services Calling-SDKs verfügbar sind.

¹ Die Funktion zum Stummschalten anderer Personen befindet sich derzeit in der öffentlichen Vorschau.

² Die Freigabebildschirmfunktion kann mithilfe von Raw Media-APIs erreicht werden. Weitere Informationen finden Sie im Schnellstartleitfaden für den Rohmedienzugriff.

³ Das Calling SDK verfügt nicht über eine explizite API für diese Funktionen, Sie sollten stattdessen die Android- und iOS-Betriebssystem-APIs verwenden, um dies zu erreichen.

⁴ Der maximale TTL-Wert in nativen Plattformen beträgt 180 Tage (15.552.000 Sekunden), und der Mindestwert ist 5 Minuten (300 Sekunden). Für CTE (Custom Teams Endpoint)/M365 Identity beträgt der maximale TTL-Wert 24 Stunden (86.400 Sekunden).

JavaScript Calling SDK: Unterstützung nach Betriebssystem und Browser

Die folgende Tabelle enthält die unterstützten Browser, die derzeit verfügbar sind. Wir unterstützen die neuesten drei Hauptversionen des Browsers (zuletzt drei Nebenversionen für Safari), sofern nicht anders angegeben.

• Die ausgehende Bildschirmfreigabe wird in mobilen iOS- oder Android-Browsern nicht unterstützt.
• Firefox-Unterstützung befindet sich in der öffentlichen Vorschauphase.
• Derzeit unterstützt das aufrufende SDK nur Android System WebView unter Android, iOS WebView(WKWebView) in der öffentlichen Vorschau. Andere Arten von eingebetteten Browsern oder WebView auf anderen Betriebssystemplattformen werden offiziell nicht unterstützt, z. B. GeckoView, Chromium Embedded Framework (CEF), Microsoft Edge WebView2. Die Ausführung von JavaScript Calling SDK auf diesen Plattformen wird nicht aktiv getestet, es könnte also funktionieren oder auch nicht.
• Eine iOS-Anwendung auf Safari kann Mikrofon- und Lautsprechergeräte nicht aufzählen/auswählen (z. B. Bluetooth). Dieses Problem ist eine Einschränkung von iOS und das Betriebssystem steuert die Standardgeräteauswahl.

Anrufclient: Browsersicherheitsmodell

Verwenden Sie WebRTC über HTTPS

WebRTC-APIs wie getUserMedia setzen voraus, dass die App, von der diese APIs aufgerufen werden, über HTTPS bedient wird. Für die lokale Entwicklung können Sie http://localhost verwenden.

Einbetten des Anruf-SDK für Communication Services in ein iframe-Element

Eine neue Berechtigungsrichtlinie (auch Feature-Richtlinie genannt) ist in verschiedenen Browsern verfügbar. Durch diese Richtlinie wird über ein ursprungsübergreifendes iframe-Element gesteuert, wie Anwendungen auf die Kamera und das Mikrofon eines Geräts zugreifen können, was Auswirkungen auf Anrufszenarien hat.

Wenn Sie ein iframe-Element verwenden möchten, um einen Teil der App über eine andere Domäne zu hosten, müssen Sie Ihrem iframe-Element das Attribut allow mit dem korrekten Wert hinzufügen.

Durch das folgende iframe-Element wird beispielsweise sowohl Kamera- als auch Mikrofonzugriff gewährt:

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

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

Wir empfehlen dringend, Ihr Szenario zu bestimmen und zu validieren, indem Sie die unterstützten Android-Plattformen überprüfen.

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+

Maximale Anrufdauer

Die maximale Anrufdauer beträgt 30 Stunden, Teilnehmer, welche die maximale Dauer der Anrufdauer von 30 Stunden erreichen, werden vom Anruf getrennt.

Unterstützte Anzahl eingehender Videostreams

Das Calling SDK von Azure Communication Services unterstützt die folgenden Streamingkonfigurationen:

* Ab Azure Communication Services Web Calling SDK Version 1.16.3 Das Calling SDK erzwingt diese Grenzen zwar nicht, aber Ihre Benutzer könnten bei Überschreitung dieser Grenzen Leistungseinbußen erfahren. Verwenden Sie die API der Optimalen Videoanzahl, um zu bestimmen, wie viele aktuelle eingehende Videostreams Ihre Webumgebung unterstützen kann. Um 16 eingehende Videos ordnungsgemäß zu unterstützen, sollte der Computer mindestens 16 GB RAM und eine 4-Core- oder höhere CPU haben, die nicht älter als 3 Jahre ist.

Unterstützte Videoauflösungen

Das Azure Communication Services Calling SDK passt die Auflösungen von Video- und Bildschirmfreigabedatenströmen während des Anrufs automatisch an.

Das Azure Communication Services Calling SDK unterstützt maximal das Senden folgender Videoauflösungen

Anzahl unterstützter Teilnehmer bei einem Anruf

• Bis zu 350 Benutzer und Benutzerinnen können einem Gruppenanruf, einem Raum oder einem Teams + ACS-Anruf beitreten.
• Sobald der Anruf mehr 100 Teilnehmer erreicht hat, werden nur die 4 dominantesten Sprecher angezeigt, die ihre Videokamera aktiviert haben.
• Wenn die Anzahl der Personen im Anruf 100 übersteigt, verringert sich die sichtbare Anzahl eingehender Videos automatisch von 4x4 (16 eingehende Videos) auf 2x2 (4 eingehende Videos).
• Wenn die Anzahl der Benutzer unter 100 liegt, steigt die Anzahl der unterstützten eingehenden Videos wieder auf 4x4 (16 eingehende Videos).

Timeouts des Calling SDK

Für die Communication Services Calling SDKs gelten folgende Timeouts:

Nächste Schritte

Weitere Informationen finden Sie in den folgenden Artikeln:

• Machen Sie sich mit allgemeinen Anrufflows vertraut.
• Informieren Sie sich über Anruftypen.
• Erfahren Sie mehr über die Anrufautomatisierungs-API, mit der Sie serverbasierte Anrufworkflows erstellen können, die Anrufe mit Clientanwendungen weiterleiten und steuern können.
• Planen Sie Ihre PSTN-Lösung.