Overzicht van de aanroep-SDK
Belangrijk
Werk voor Azure Communication Services 31 juli 2021 bij naar de aanroepen van SDK 1.1.0 (of hoger) voor JavaScript.
De SDP-API (Plan B Session Description Protocol) wordt afgeschaft. Werk uw Communication Services aanroepende SDK's bij naar v1.1.0 (of hoger) voor 31 juli 2021 om te voorkomen dat deze afschaffing van invloed is op uw gebruikers. Zie de opmerkingen bij de release van de aanroepbibliotheek voor meer informatie.
Met de SDK voor oproepen kunnen apparaten van eindgebruikers spraak- en videocommunicatie-ervaringen aanroepen. Deze pagina bevat gedetailleerde beschrijvingen van het aanroepen van functies, waaronder informatie over platform- en browserondersteuning. Als u meteen aan de slag wilt gaan, raadpleegt u Calling quickstarts (Quickstarts aanroepen) of Calling hero sample (Hero-voorbeeld aanroepen).
Zodra u de ontwikkeling hebt gestart, bekijkt u de pagina met bekende problemen om te zoeken naar fouten waar we aan werken.
Belangrijkste functies van de aanroepen van de SDK:
- 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 bij het aanroepen van API's die clients inzicht geven in wie is verbonden met een oproep (het rooster).
- Versleuteling: de aanroepende SDK versleutelt verkeer en voorkomt manipulatie op de kabel.
- Apparaatbeheer en media: de aanroepende SDK biedt mogelijkheden voor binding met audio- en videoapparaten, codeert inhoud voor efficiënte verzending via het communicatiegegevensplane en geeft inhoud weer naar uitvoerapparaten en weergaven die u opgeeft. ER zijn ook API's beschikbaar voor het delen van schermen en toepassingen.
- PSTN: de SDK voor oproepen kan spraakoproepen ontvangen en initiëren met het traditionele openbaar geschakelde telefoonsysteem, met behulp van telefoonnummers die u in de Azure Portal of programmatisch hebt verkregen.
- Teams Meetings: de SDK voor oproepen kan deelnemen aan Teams vergaderingen en communiceren met Teams spraak- en videogegevensplane.
- Meldingen: de aanroep-SDK biedt API's waarmee clients op de hoogte kunnen worden gesteld van een binnenkomende aanroep. In situaties waarin uw app niet op de voorgrond wordt uitgevoerd, zijn patronen beschikbaar om pop-upmeldingen ('pop-upmeldingen') te geven om eindgebruikers te informeren over een binnenkomende oproep.
Gedetailleerde mogelijkheden
De volgende lijst bevat de set functies die momenteel beschikbaar zijn in de Azure Communication Services-SDK's voor oproepen.
| Groep van functies | Mogelijkheid | JS | Windows | Java (Android) | Objective-C (iOS) |
|---|---|---|---|---|---|
| Belangrijkste mogelijkheden | Een een-op-een-oproep tussen twee gebruikers plaatsen | ✔️ | ✔️ | ✔️ | ✔️ |
| Een oproep met meer dan twee gebruikers (Maximaal 350 gebruikers) plaatsen | ✔️ | ✔️ | ✔️ | ✔️ | |
| 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 | ✔️ | ✔️ | ✔️ | ✔️ | |
| Besturingselement voor aanroepen halverwege | Video in- of uitschakelen | ✔️ | ✔️ | ✔️ | ✔️ |
| Microfoon dempen/dempen opheffen | ✔️ | ✔️ | ✔️ | ✔️ | |
| Schakelen tussen camera's | ✔️ | ✔️ | ✔️ | ✔️ | |
| Lokaal vasthouden/opheffen | ✔️ | ✔️ | ✔️ | ✔️ | |
| Actieve spreker | ✔️ | ✔️ | ✔️ | ✔️ | |
| 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 | ✔️ | ❌ | ❌ | ❌ |
| Een specifieke toepassing delen (in de lijst met actieve toepassingen) | ✔️ | ❌ | ❌ | ❌ | |
| Een tabblad van webbrowser delen vanuit de lijst met geopende tabbladen | ✔️ | ❌ | ❌ | ❌ | |
| 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 | ✔️ | ✔️ | ✔️ | ✔️ | |
| Algemeen | Uw microfoon, spreker en camera testen met een service voor audio testen (beschikbaar door het aanroepen van 8:echo123) | ✔️ | ✔️ | ✔️ | ✔️ |
| Apparaatbeheer | Vragen om toestemming voor het gebruik van audio en/of video | ✔️ | ✔️ | ✔️ | ✔️ |
| Cameralijst op halen | ✔️ | ✔️ | ✔️ | ✔️ | |
| Camera instellen | ✔️ | ✔️ | ✔️ | ✔️ | |
| Geselecteerde camera selecteren | ✔️ | ✔️ | ✔️ | ✔️ | |
| Microfoonlijst op halen | ✔️ | ✔️ | ❌ | ❌ | |
| Microfoon instellen | ✔️ | ✔️ | ❌ | ❌ | |
| Geselecteerde microfoon selecteren | ✔️ | ✔️ | ❌ | ❌ | |
| Lijst met sprekers op halen | ✔️ | ✔️ | ❌ | ❌ | |
| Spreker instellen | ✔️ | ✔️ | ❌ | ❌ | |
| Geselecteerde spreker krijgen | ✔️ | ✔️ | ❌ | ❌ | |
| Videorendering | Eén video op veel plaatsen renderen (lokale camera of externe stream) | ✔️ | ✔️ | ✔️ | ✔️ |
| Schaalmodus instellen/bijwerken | ✔️ | ✔️ | ✔️ | ✔️ | |
| Externe videostream renderen | ✔️ | ✔️ | ✔️ | ✔️ |
Ondersteuning voor SDK-streaming aanroepen
De Communication Services Calling SDK ondersteunt de volgende streamingconfiguraties:
| Limiet | Web | Windows/Android/iOS |
|---|---|---|
| Maximumaantal uitgaande lokale stromen dat tegelijkertijd kan worden verzonden | 1 video of 1 scherm delen | 1 video + 1 scherm delen |
| Maximumaantal binnenkomende externe stromen dat tegelijkertijd kan worden weergegeven | 4 video's + 1 scherm delen | 6 video's + 1 scherm delen |
Hoewel deze limieten niet worden afgedwongen door de aanroep-SDK, kunnen uw gebruikers prestatievermindering ervaren als ze worden overschreden.
Time-outs van SDK aanroepen
De volgende time-outs zijn van toepassing op de Communication Services aanroepen van SDK's:
| Actie | Time-out in seconden |
|---|---|
| Deelnemer opnieuw verbinden/verwijderen | 120 |
| Nieuwe modaliteit toevoegen aan of verwijderen uit een aanroep (video starten/stoppen of scherm delen) | 40 |
| Time-out van bewerking voor aanroepoverdracht | 60 |
| 1:1 Time-out van instelling aanroepen | 85 |
| Time-out van instelling groepsoproep | 85 |
| Time-out van instelling van PSTN-aanroep | 115 |
| 1:1-aanroep naar een time-out voor groepsoproepen promoveren | 115 |
Ondersteuning voor JavaScript Calling SDK per besturingssysteem en browser
De volgende tabel vertegenwoordigt de set ondersteunde browsers die momenteel beschikbaar zijn. We ondersteunen de meest recente drie versies van de browser, tenzij anders aangegeven.
| Platform | Chrome | Safari | Edge (Chromium) |
|---|---|---|---|
| Android | ✔️ | ❌ | ❌ |
| iOS | ❌ | ✔️ | ❌ |
| macOS | ✔️ | ✔️ | ❌ |
| Windows | ✔️ | ❌ | ✔️ |
| Ubuntu/Linux | ✔️ | ❌ | ❌ |
- Delen van uitgaand scherm wordt niet ondersteund op iOS of Android.
- Een iOS-app in Safari kan microfoon- en sprekerapparaten niet opsnoemen/selecteren (bijvoorbeeld Bluetooth). Dit is een beperking van het besturingssysteem en er is altijd slechts één apparaat. Besturingssysteem bepaalt de standaardselectie van het apparaat.
Ondersteuning voor Android Calling SDK
Ondersteuning voor Android API Level 21 of hoger
Ondersteuning voor Java 7 of hoger
Ondersteuning voor Android Studio 2.0
Ondersteuning voor iOS-aanroepen van SDK
Ondersteuning voor iOS 10.0+ tijdens de build en iOS 12.0+ tijdens run time
Xcode 12.0+
Aanroepende client - beveiligingsmodel voor browsers
Gebruikers-WebRTC via HTTPS
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 wordt een nieuw machtigingsbeleid (ook wel functiebeleid genoemd) door verschillende browsers toegepast. 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 *">
Volgende stappen
Raadpleeg voor meer informatie de volgende artikelen:
- Stel u op de hoogte van algemene aanroepstromen
- Meer informatie over aanroeptypen
- Uw PSTN-oplossing plannen