Overzicht van de aanroep-SDK

  • Artikel

Met Azure Communication Services kunnen browsers, apps en services van eindgebruikers spraak- en videocommunicatie stimuleren. Deze pagina is gericht op het aanroepen van client-SDK, die kan worden ingesloten in websites en systeemeigen toepassingen. Deze pagina bevat gedetailleerde beschrijvingen van belclientfuncties, zoals platform- en browserondersteuningsinformatie. Services beheren en openen van aanroepen via programmacode met behulp van de Call Automation-API's. De Rooms-API is een optionele Azure Communication Services-API die extra functies toevoegt aan een spraak- of videogesprek, zoals rollen en machtigingen.

Notitie

Deel uw ideeën en feedback over Azure Communication Services met ons door deze korte enquête te nemen.

Als u uw eigen gebruikerservaring wilt bouwen met de Calling SDK, bekijkt u de quickstarts of het voorbeeld van een aanroepende hero.

Als u hulp nodig hebt bij de eindgebruikerservaring, biedt de Ui-bibliotheek van Azure Communication Services een verzameling opensource-ui-onderdelen die gereed zijn voor productie in uw toepassing. Met deze set vooraf samengestelde besturingselementen kunt u prachtige communicatie-ervaringen maken met behulp van de Fluent-ontwerptaal van Microsoft. Als u meer wilt weten over de UI-bibliotheek, gaat u naar de overzichtssite of het artikelboek.

Zodra u begint met ontwikkelen, bekijkt u de pagina bekende problemen om fouten te vinden waaraan we werken.

SDK-koppelingen

Platform Web (JavaScript) Windows (.NET) iOS Android Overige
Bellen npm NuGet GitHub Maven
UI-bibliotheek npm - GitHub GitHub GitHub, Storybook

Belangrijke functies

  • Apparaatbeheer en Media: de Calling SDK biedt faciliteiten voor binding met audio- en videoapparaten, codeert inhoud voor efficiënte overdracht via het communicatiegegevensvlak en geeft inhoud weer voor uitvoerapparaten en weergaven die u opgeeft. API's zijn ook beschikbaar voor het delen van schermen en toepassingen.
  • PSTN : de Calling SDK kan spraakoproepen initiëren met het traditionele, openbaar geschakelde telefoonnetwerk, met behulp van telefoonnummers die u in Azure Portal aanschaft of programmatisch. U kunt ook uw eigen nummers meenemen met behulp van sessierandcontrollers.
  • Teams-vergaderingen en -gesprekken : de Bel-SDK kan deelnemen aan Teams-vergaderingen en communiceren met het teams-gegevensvlak voor spraak en video.
  • Versleuteling : de Calling SDK versleutelt verkeer en voorkomt manipulatie op de kabel.
  • Adressering : Azure Communication Services biedt algemene identiteiten die worden gebruikt om communicatie-eindpunten aan te pakken. Clients gebruiken deze identiteiten om te verifiëren bij de service en met elkaar te communiceren. Deze identiteiten worden gebruikt in aanroepende API's die clients inzicht geven in wie is verbonden met een aanroep (het rooster).
  • Beveiliging van gebruikerstoegang
    • Roosterbeheer, planningsbeheer en gebruikersrollen/machtigingen worden afgedwongen via virtuele ruimten.
    • De mogelijkheid voor een gebruiker om een nieuwe aanroep te initiëren of om lid te worden van een bestaande aanroep kan worden beheerd via gebruikersidentiteiten en tokens
  • Meldingen : de Calling SDK biedt API's waarmee clients op de hoogte kunnen worden gesteld van een binnenkomende oproep. In situaties waarin uw app niet op de voorgrond wordt uitgevoerd, zijn patronen beschikbaar om pop-upmeldingen ('pop-upmeldingen ') te activeren om eindgebruikers te informeren over een inkomende oproep.
  • Media Stats : de Calling SDK biedt uitgebreide inzichten in de metrische gegevens van uw VoIP- en videogesprekken. Met deze informatie hebben ontwikkelaars een duidelijker begrip van de gesprekskwaliteit en kunnen ze weloverwogen beslissingen nemen om hun communicatie-ervaring verder te verbeteren.
  • Videobeperkingen - De Calling SDK biedt API's die de mogelijkheid krijgen om de videokwaliteit te reguleren onder andere parameters tijdens videogesprekken door parameters zoals resolutie en framesnelheid aan te passen die verschillende oproepsituaties ondersteunen voor verschillende niveaus van videokwaliteit
  • User Facing Diagnostics (UFD): de Calling SDK biedt gebeurtenissen die zijn ontworpen om inzicht te krijgen in onderliggende problemen die van invloed kunnen zijn op de gesprekskwaliteit. Ontwikkelaars kunnen zich abonneren op triggers zoals zwakke netwerksignalen of gedempte microfoons, zodat ze altijd op de hoogte zijn van alle factoren die van invloed zijn op de aanroepen.

Gedetailleerde mogelijkheden

De volgende lijst bevat de set functies die momenteel beschikbaar zijn in de Aanroepende SDK's van Azure Communication Services.

Groep van functies Mogelijkheid JS Windows Java (Android) Objective-C (iOS)
Belangrijkste mogelijkheden Een een-op-een-oproep tussen twee gebruikers plaatsen ✔️ ✔️ ✔️ ✔️
Een groepsgesprek plaatsen met meer dan twee gebruikers (maximaal 100 gebruikers) ✔️ ✔️ ✔️ ✔️
Een een-op-een-oproep promoten met twee gebruikers in een groepsaanroep met meer dan twee gebruikers ✔️ ✔️ ✔️ ✔️
Een groepsoproep toevoegen nadat deze is gestart ✔️ ✔️ ✔️ ✔️
Een andere VoIP-deelnemer uitnodigen om deel te nemen aan een actieve groepsoproep ✔️ ✔️ ✔️ ✔️
Midden gespreksbeheer Video in- of uitschakelen ✔️ ✔️ ✔️ ✔️
Microfoon dempen/dempen opheffen ✔️ ✔️ ✔️ ✔️
Andere deelnemers dempen ✔️1 ✔️1 ✔️1 ✔️1
Schakelen tussen camera's ✔️ ✔️ ✔️ ✔️
Lokaal vasthouden/opheffen ✔️ ✔️ ✔️ ✔️
Actieve luidspreker ✔️ ✔️ ✔️ ✔️
Een spreker kiezen voor aanroepen ✔️ ✔️ ✔️ ✔️
Microfoon kiezen voor aanroepen ✔️ ✔️ ✔️ ✔️
Status van een deelnemer weergeven
Niet-actief, vroege media, verbinding maken, verbonden, in de wacht, in lobby, verbroken		 ✔️ ✔️ ✔️ ✔️
Status van een aanroep weergeven
Vroege media, binnenkomend, verbinden, rinkelen, verbonden, in de wacht, verbinding verbreken, verbroken		 ✔️ ✔️ ✔️ ✔️
Weergeven als een deelnemer is gedempt ✔️ ✔️ ✔️ ✔️
De reden weergeven waarom een deelnemer een gesprek heeft verlaten ✔️ ✔️ ✔️ ✔️
Scherm delen Het volledige scherm delen vanuit de toepassing ✔️ ✔️2 ✔️2 ✔️2
Een specifieke toepassing delen (in de lijst met actieve toepassingen) ✔️ ✔️2 ❌ ❌
Een tabblad van webbrowser delen vanuit de lijst met geopende tabbladen ✔️
Systeemaudio delen tijdens het delen van het scherm ✔️ ❌ ❌ ❌
Deelnemer kan externe schermdeling weergeven ✔️ ✔️ ✔️ ✔️
Rooster Deelnemers weergeven ✔️ ✔️ ✔️ ✔️
Een deelnemer verwijderen ✔️ ✔️ ✔️ ✔️
PSTN Een een-op-een-aanroep met een PSTN-deelnemer plaatsen ✔️ ✔️ ✔️ ✔️
Een groepsaanroep met PSTN-deelnemers plaatsen ✔️ ✔️ ✔️ ✔️
Een een-op-een-aanroep promoten met een PSTN-deelnemer in een groepsaanroep ✔️ ✔️ ✔️ ✔️
Inbellen vanuit een groepsaanroep als een PSTN-deelnemer ✔️ ✔️ ✔️ ✔️
Ondersteuning voor vroege media ✔️ ✔️ ✔️ ✔️
Algemeen Uw microfoon, spreker en camera testen met een service voor audio testen (beschikbaar door het aanroepen van 8:echo123) ✔️ ✔️ ✔️ ✔️
Apparaatbeheer Vragen om toestemming om audio en/of video te gebruiken ✔️ ✔️ ✔️ ✔️
Cameralijst ophalen ✔️ ✔️ ✔️ ✔️
Camera instellen ✔️ ✔️ ✔️ ✔️
Geselecteerde camera ophalen ✔️ ✔️ ✔️ ✔️
Microfoonlijst ophalen ✔️ ✔️ ❌3 ❌3
Microfoon instellen ✔️ ✔️ ❌3 ❌3
Geselecteerde microfoon ophalen ✔️ ✔️ ❌3 ❌3
Lijst met sprekers ophalen ✔️ ✔️ ❌3 ❌3
Luidspreker instellen ✔️ ✔️ ❌3 ❌3
Geselecteerde spreker ophalen ✔️ ✔️ ❌3 ❌3
Videorendering Eén video weergeven op veel plaatsen (lokale camera of externe stream) ✔️ ✔️ ✔️ ✔️
Schaalmodus instellen/bijwerken ✔️ ✔️ ✔️ ✔️
Externe videostream weergeven ✔️ ✔️ ✔️ ✔️
Video-effecten Achtergrond vervagen ✔️ ✔️ ✔️ ✔️
Aangepaste achtergrondafbeelding ✔️ ✔️ ✔️ ✔️
Audio-effecten Muziek modus ❌ ✔️ ✔️ ✔️
Echoannulering ❌ ✔️ ✔️ ✔️
Ruisonderdrukking ✔️ ✔️ ✔️ ✔️
AGC (Automatic Gain Control) ❌ ✔️ ✔️ ✔️
Meldingen 4 Pushmeldingen ✔️ ✔️ ✔️ ✔️

1 De mogelijkheid om anderen te dempen is momenteel beschikbaar als openbare preview.

2 De mogelijkheid voor het delen van het scherm kan worden bereikt met raw media-API's. Ga voor meer informatie naar de snelstartgids voor onbewerkte mediatoegang.

3 De Aanroepende SDK heeft geen expliciete API voor deze functies. Gebruik in plaats daarvan de Api's van het Android- en iOS-besturingssysteem om te bereiken.

4 De maximumwaarde voor TTL in systeemeigen platforms is 180 dagen (15.552.000 seconden) en de minimale waarde is 5 minuten (300 seconden). Voor CTE (Custom Teams Endpoint)/M365 Identity is de maximale TTL-waarde 24 uur (86.400 seconden).

JavaScript Calling SDK-ondersteuning per besturingssysteem en browser

De volgende tabel vertegenwoordigt de set ondersteunde browsers, die momenteel beschikbaar zijn. We ondersteunen de meest recente drie primaire versies van de browser (meest recente drie secundaire versies voor Safari), tenzij anders aangegeven.

Platform Chrome Safari Edge Firefox Webview Electron
Android ✔️ ❌ ✔️ ❌ ✔️ ❌
iOS ✔️ ✔️ ❌ ❌ ✔️ ❌
macOS ✔️ ✔️ ✔️ ✔️ ❌ ✔️
Windows ✔️ ❌ ✔️ ✔️ ❌ ✔️
Ubuntu/Linux ✔️ ❌ ❌ ❌ ❌ ❌
  • Uitgaand scherm delen wordt niet ondersteund in mobiele iOS- of Android-browsers.
  • Firefox-ondersteuning bevindt zich in openbare preview.
  • Momenteel ondersteunt de aanroepende SDK alleen Android System WebView op Android, iOS WebView (WKWebView) in openbare preview. Andere typen ingesloten browsers of WebView op andere besturingssysteemplatforms worden niet officieel ondersteund, bijvoorbeeld GeckoView, Chromium Embedded Framework (CEF), Microsoft Edge WebView2. Het uitvoeren van de JavaScript Calling SDK op deze platforms wordt niet actief getest. Het werkt mogelijk of niet.
  • Een iOS-app in Safari kan geen microfoon- en luidsprekerapparaten opsommen/selecteren (bijvoorbeeld Bluetooth). Dit probleem is een beperking van iOS en het besturingssysteem bepaalt standaardapparaatselectie.

Aanroepende client - beveiligingsmodel voor browsers

WebRTC via HTTPS gebruiken

WebRTC-API's zoals getUserMedia vereisen dat de app die deze API's aanroept, geleverd wordt via HTTPS. Voor lokale ontwikkeling kunt u http://localhost gebruiken.

De aanroepende SDK voor communicatieservices insluiten in een iframe

Er is een nieuw machtigingsbeleid (ook wel een functiebeleid genoemd) beschikbaar in verschillende browsers. Dit beleid is van invloed op het aanroepen van scenario's door te bepalen hoe toepassingen toegang hebben tot de camera en microfoon van een apparaat via een cross-origin iframe-element.

Als u een iframe wilt gebruiken om een deel van de app te hosten vanuit een ander domein, moet u het allow-kenmerk met de juiste waarde toevoegen aan uw iframe.

Met deze iframe kunt u bijvoorbeeld toegang tot de camera en microfoon toestaan:

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

Android Calling SDK-ondersteuning

  • Ondersteuning voor Android-API-niveau 21 of hoger
  • Ondersteuning voor Java 7 of hoger
  • Ondersteuning voor Android Studio 2.0
  • Android Auto - en IoT-apparaten met Android worden momenteel niet ondersteund

Ondersteuning voor aanroepende SDK voor iOS

  • Ondersteuning voor iOS 10.0+ tijdens de build en iOS 12.0+ tijdens runtime
  • Xcode 12.0+
  • Ondersteuning voor iPadOS 13.0+

Maximale gespreksduur

De maximale gespreksduur is 30 uur, deelnemers die de maximale duur van de oproepduur van 30 uur bereiken, worden losgekoppeld van het gesprek.

Ondersteund aantal binnenkomende videostreams

De Azure Communication Services Calling SDK ondersteunt de volgende streamingconfiguraties:

Grenswaarde Web Windows/Android/iOS
Maximum aantal uitgaande lokale streams dat tegelijkertijd kan worden verzonden 1 video en 1 scherm delen 1 video + 1 scherm delen
Maximum aantal binnenkomende externe streams dat tegelijkertijd kan worden weergegeven 9 video's + 1 scherm delen in desktopbrowsers*, 4 video's + 1 scherm delen in mobiele webbrowsers 9 video's + 1 scherm delen

* Vanaf Azure Communication Services Web Calling SDK versie 1.16.3 Terwijl de Calling SDK deze limieten niet afdwingt, kunnen uw gebruikers prestatievermindering ervaren als ze worden overschreden. Gebruik de API van Optimaal aantal video's om te bepalen hoeveel huidige binnenkomende videostreams uw webomgeving kan ondersteunen.

Ondersteunde videoresoluties

De Azure Communication Services Calling SDK past tijdens het gesprek automatisch oplossingen aan van video- en schermsharestreams.

Notitie

De resolutie kan variëren, afhankelijk van het aantal deelnemers aan een gesprek, de hoeveelheid bandbreedte die beschikbaar is voor de client, hardwaremogelijkheden van lokale deelnemers die externe video streans en andere algemene oproepparameters renderen.

De Azure Communication Services Calling SDK biedt ondersteuning voor het verzenden van de volgende videoresoluties

Maximale videoresolutie WebJS iOS Android Windows
Video verzenden 720P 720P 720P 1080P
Schermshare verzenden 1080P 1080P 1080P 1080P
Een externe videostream of schermshare ontvangen 1080P 1080P 1080P 1080P

Aantal deelnemers aan een telefonische ondersteuning

  • Maximaal 350 gebruikers kunnen deelnemen aan een groepsgesprek, ruimte of Teams + ACS-oproep.
  • Zodra de gespreksgrootte 100+ deelnemers in een gesprek bereikt, kunnen alleen de top 4 meest dominante sprekers met hun videocamera worden gezien.
  • Wanneer het aantal personen in de oproep 100+ is, neemt het zichtbare aantal binnenkomende video's automatisch af van 3x3 (9 binnenkomende video's) tot 2x2 (4 inkomende video's).
  • Wanneer het aantal gebruikers lager is dan 100, wordt het aantal ondersteunde binnenkomende video's maximaal 3x3 (9 binnenkomende video's) geretourneerd.

Time-outs voor aanroepen van SDK

De volgende time-outs zijn van toepassing op de Communication Services Calling SDK's:

Actie Time-out in seconden
Deelnemer opnieuw verbinden/verwijderen 60
Nieuwe modaliteit toevoegen aan of verwijderen uit een gesprek (video starten/stoppen of scherm delen) 40
Time-out voor oproepoverdracht 60
Time-out voor 1:1 oproepinrichting 85
Time-out voor het instellen van groepsoproepen 85
Time-out voor het instellen van PSTN-oproepen 115
1:1-oproep verhogen naar een time-out voor groepsgesprekken 115

Volgende stappen

Aan de slag met oproepen

Raadpleeg voor meer informatie de volgende artikelen: