Översikt av SDK för samtal

Med Azure Communication Services kan slutanvändares webbläsare, appar och tjänster driva röst- och videokommunikation. Den här sidan fokuserar på anropande klient-SDK, som kan bäddas in på webbplatser och interna program. Den här sidan innehåller detaljerade beskrivningar av klientfunktioner för samtal, till exempel supportinformation för plattform och webbläsare. Tjänster hanterar och kommer åt samtal programmatiskt med hjälp av API:erna för samtalsautomatisering. Rooms API är ett valfritt Azure Communication Services-API som lägger till ytterligare funktioner i ett röst- eller videosamtal, till exempel roller och behörigheter.

Om du vill skapa en egen användarupplevelse med Calling SDK kan du titta på Snabbstarter för samtal eller Anropa hero.

Om du vill ha hjälp med slutanvändarupplevelsen tillhandahåller Azure Communication Services UI Library en samling produktionsklara gränssnittskomponenter med öppen källkod som kan tas bort i ditt program. Med den här uppsättningen fördefinierade kontroller kan du skapa snygga kommunikationsupplevelser med microsofts fluent-designspråk. Om du vill veta mer om användargränssnittsbiblioteket går du till översiktswebbplatsen.

När du har börjat utveckla kan du titta på sidan med kända problem för att hitta buggar som vi arbetar med.

SDK-länkar

Huvudfunktioner    

• Enhetshantering och Media – Calling SDK tillhandahåller funktioner för bindning till ljud- och videoenheter, kodar innehåll för effektiv överföring via kommunikationsdataplanen och återger innehåll till utdataenheter och vyer som du anger. API:er tillhandahålls också för skärm- och programdelning.
• PSTN – Calling SDK kan initiera röstsamtal med det traditionella offentligt växlade telefonnätet med hjälp av telefonnummer som du skaffar i Azure Portal eller programmatiskt. Du kan också ta med egna nummer med hjälp av sessionsgränskontrollanter.
• Teams möten och samtal – Den anropande SDK:n kan ansluta till Teams-möten och interagera med Teams röst- och videodataplan.
• Kryptering – Anropande SDK krypterar trafik och förhindrar manipulering av kabeln.
• Adressering – Azure Communication Services tillhandahåller allmänna identiteter som används för att hantera kommunikationsslutpunkter. Klienter använder dessa identiteter för att autentisera till tjänsten och kommunicera med varandra. Dessa identiteter används i ANROPANDE API:er som ger klienter insyn i vem som är ansluten till ett anrop (listan).
• Säkerhet för användaråtkomst
  • Schemakontroll , schemakontroll och användarroller /behörigheter tillämpas via virtuella rum.
  • Möjligheten för en användare att initiera ett nytt anrop eller ansluta till ett befintligt anrop kan hanteras via användaridentiteter och token
• Meddelanden – Anropande SDK tillhandahåller API:er som gör att klienter kan meddelas om ett inkommande samtal. I situationer där din app inte körs i förgrunden är mönster tillgängliga för att utlösa popup-meddelanden ("popup-fönster") för att informera slutanvändarna om ett inkommande samtal.
• Mediestatistik – Calling SDK ger omfattande insikter om måtten för dina VoIP- och videosamtal. Med den här informationen har utvecklare en tydligare förståelse för samtalskvalitet och kan fatta välgrundade beslut för att ytterligare förbättra sin kommunikationsupplevelse.
• Videobegränsningar – Calling SDK tillhandahåller API:er som kan reglera videokvaliteten bland andra parametrar under videosamtal genom att justera parametrar som upplösning och bildfrekvens som stöder olika samtalssituationer för olika nivåer av videokvalitet
• Användarinriktad diagnostik (UFD) – Anropande SDK tillhandahåller händelser som är utformade för att ge insikter om underliggande problem som kan påverka samtalskvaliteten. Utvecklare kan prenumerera på utlösare som svaga nätverkssignaler eller dämpade mikrofoner, vilket säkerställer att de alltid är medvetna om faktorer som påverkar anropen.

Detaljerade funktioner

I följande lista visas den uppsättning funktioner som för närvarande är tillgängliga i Azure Communication Services Calling SDK:er.

¹ Funktionen för att stänga av andra är för närvarande i offentlig förhandsversion.

² Funktionen Dela skärm kan uppnås med hjälp av RAW Media-API:er. Mer information finns i snabbstartsguiden för rå mediaåtkomst.

³ Calling SDK har inte något explicit API för dessa funktioner. Du bör använda API:erna för Android- och iOS-operativsystemet för att uppnå det i stället.

⁴ Det maximala värdet för TTL på interna plattformar är 180 dagar (15 552 000 sekunder) och minimivärdet är 5 minuter (300 sekunder).. För CTE (Custom Teams Endpoint)/M365 Identity är det maximala TTL-värdet 24 timmar (86 400 sekunder).

Stöd för JavaScript Calling SDK per operativsystem och webbläsare

Följande tabell representerar den uppsättning webbläsare som stöds, som för närvarande är tillgängliga. Vi stöder de senaste tre huvudversionerna av webbläsaren (de senaste tre delversionerna för Safari) om inget annat anges.

• Utgående skärmdelning stöds inte i iOS- eller Android-mobila webbläsare.
• Firefox-stöd finns i offentlig förhandsversion.
• För närvarande stöder anropande SDK endast Android System WebView på Android, iOS WebView (WKWebView) i offentlig förhandsversion. Andra typer av inbäddade webbläsare eller WebView på andra operativsystemplattformar stöds inte officiellt, till exempel GeckoView, Chromium Embedded Framework (CEF), Microsoft Edge WebView2. Körning av JavaScript Calling SDK på dessa plattformar testas inte aktivt, det kanske eller kanske inte fungerar.
• En iOS-app i Safari kan inte räkna upp/välja mikrofon- och talarenheter (till exempel Bluetooth). Det här problemet är en begränsning för iOS och operativsystemet styr standardalternativet för enheten.

Anropa klient – webbläsarsäkerhetsmodell

Använda WebRTC via HTTPS

WebRTC-API:er som getUserMedia kräver att appen som anropar dessa API:er hanteras via HTTPS. För lokal utveckling kan du använda http://localhost.

Bädda in Communication Services Calling SDK i en iframe

En ny behörighetsprincip (kallas även för en funktionsprincip) är tillgänglig i olika webbläsare. Den här principen påverkar samtalsscenarier genom att styra hur program kan komma åt en enhets kamera och mikrofon via ett korsande iframe-element.

Om du vill använda en iframe som värd för en del av appen från en annan domän måste du lägga till allow attributet med rätt värde i din iframe.

Till exempel tillåter den här iframe både kamera- och mikrofonåtkomst:

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

Stöd för Android Calling SDK

• Stöd för Android API-nivå 21 eller senare
• Stöd för Java 7 eller senare
• Stöd för Android Studio 2.0

Vi rekommenderar starkt att du identifierar och validerar ditt scenario genom att besöka androidplattformar som stöds

Stöd för iOS-samtals-SDK

• Stöd för iOS 10.0+ vid byggtid och iOS 12.0+ vid körning
• Xcode 12.0+
• Stöd för iPadOS 13.0+

Maximal samtalsvaraktighet

Den maximala samtalsvaraktigheten är 30 timmar, deltagare som når den maximala samtalstiden på 30 timmar kopplas från samtalet.

Antal inkommande videoströmmar som stöds

Azure Communication Services Calling SDK stöder följande strömningskonfigurationer:

* Från och med Azure Communication Services Web Calling SDK version 1.16.3 Även om anropande SDK inte tillämpar dessa gränser kan användarna uppleva prestandaförsämring om de överskrids. Använd API :et optimalt antal video för att avgöra hur många aktuella inkommande videoströmmar som din webbmiljö kan stödja. För att korrekt stödja 16 inkommande videor datorn bör ha en mimimum på 16 GB RAM och en 4-kärnor eller större CPU som inte är äldre än 3 år gammal

Videoupplösningar som stöds

Azure Communication Services Calling SDK justerar automatiskt upplösningar för video- och skärmdelningsströmmar under samtalet.

Azure Communication Services Calling SDK stöder sändning av följande videoupplösningar

Antal deltagare i ett samtalsstöd

• Upp till 350 användare kan ansluta till ett gruppsamtal, Rum eller Teams + ACS-samtal.
• När samtalsstorleken når 100+ deltagare i ett samtal kan endast de 4 mest dominerande talarna som har sin videokamera vänd ses.
• När antalet personer i samtalet är 100+ minskar det visningsbara antalet inkommande videor automatiskt från 4x4 (16 inkommande videor) ned till 2x2 (4 inkommande videor).
• När antalet användare understiger 100 går antalet inkommande videor som stöds tillbaka upp till 4 x 4 (16 inkommande videor).

Anropa SDK-timeouter

Följande tidsgränser gäller för SDK:er för kommunikationstjänster som anropar:

Nästa steg

Mer information finns i följande artiklar:

• Bekanta dig med allmänna samtalsflöden
• Läs mer om samtalstyper
• Lär dig mer om API för samtalsautomatisering som gör att du kan skapa serverbaserade samtalsarbetsflöden som kan dirigera och styra anrop med klientprogram.
• Planera din PSTN-lösning