SDK:er och REST-API:er
Funktionerna i Azure Communication Services är konceptuellt ordnade i diskreta områden baserat på deras funktionella område. De flesta områden har fullständigt SDK:er med öppen källkod programmerade mot publicerade REST-API:er som du kan använda direkt via Internet. Anropande SDK använder egna nätverksgränssnitt och är sluten källkod.
I tabellerna nedan sammanfattar vi dessa områden och tillgängligheten för REST-API:er och SDK-bibliotek. Vi noterar om API:er och SDK:er är avsedda för slutanvändarens klienter eller betrodda tjänstmiljöer. API:er som SMS bör inte nås direkt av slutanvändarenheter i miljöer med lågt förtroende.
Utvecklingen av samtals- och chattprogram kan påskyndas av Azure Communication Services UI-biblioteket. Det anpassningsbara användargränssnittsbiblioteket innehåller gränssnittskomponenter med öppen källkod för webb- och mobilappar och ett Microsoft Teams-tema.
Skapa en metod för att använda den senaste SDK:en
Webbläsare och operativsystem utvecklas ständigt för att stödja de senaste förbättringarna och åtgärda befintliga buggar. Med den senaste SDK:t för Azure Communication Services kan du få den bästa övergripande slutanvändarupplevelsen för ditt program när det används med uppdaterade webbläsare och uppdateringar av operativsystemet. Den mest uppdaterade SDK:t för Azure Communication Services har många fördelar, till exempel bättre prestanda, säkerhet, kompatibilitet, kvalitet och användbarhet. Med uppdateringen kan du komma åt de senaste funktionerna och uppdateringarna som regelbundet läggs till i webbläsaren och operativsystemet. Azure Communication Services SDK:er uppdateras ofta (ungefär var 6:e vecka till en gång i kvartalet). Vi rekommenderar att du skapar en process för att säkerställa att du alltid uppdaterar till de senaste SDK:erna.
SDK:er
| Sammansättning | Protokoll | Environment | Funktioner |
|---|---|---|---|
| Azure Resource Manager | REST | Tjänst | Etablera och hantera Communication Services-resurser |
| Vanlig | Ej tillämpligt | Klient och tjänst | Tillhandahåller bastyper för andra SDK:er |
| Identitet | REST | Tjänst | Hantera användare, åtkomsttoken |
| Telefonnummer | REST | Tjänst | Hämta och hantera telefonnummer |
| SMS | REST | Tjänst | Skicka och ta emot SMS |
| REST | Tjänst | Skicka och hämta status för e-postmeddelanden | |
| Chatt | REST med proprietär signalering | Klient och tjänst | Lägga till textchatt i realtid i dina program |
| Samtal | Proprietär transport | Klient | Röst, video, skärmdelning och annan realtidskommunikation |
| Anropa Automation | REST | Tjänst | Skapa anpassade samtalsarbetsflöden för PSTN- och VoIP-anrop |
| Jobbrouter | REST | Tjänst | Optimera hanteringen av kundinteraktioner i olika program |
| Rum | REST | Tjänst | Skapa och hantera strukturerade kommunikationsrum |
| UI-bibliotek | Ej tillämpligt | Klient | Produktionsklara gränssnittskomponenter för chatt- och samtalsappar |
| Avancerade meddelanden | REST | Tjänst | Skicka och ta emot WhatsApp Business-meddelanden |
Språk och publiceringsplatser
Publiceringsplatser för enskilda SDK-paket:
| Ytdiagram | JavaScript | .NET | Python | Java SE | iOS | Android | Övrigt |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | Gå via GitHub |
| Vanlig | npm | NuGet | Ej tillämpligt | Maven | GitHub | Maven | - |
| Identitet | npm | NuGet | PyPi | Maven | - | - | - |
| Telefonnummer | npm | NuGet | PyPi | Maven | - | - | - |
| Chatt | npm | NuGet | PyPi | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| npm | NuGet | PyPi | Maven | - | - | - | |
| Samtal | npm | NuGet | - | - | CocoaPods | Maven | - |
| Anropa Automation | npm | NuGet | PyPi | Maven | |||
| Jobbrouter | npm | NuGet | PyPi | Maven | |||
| Rum | npm | NuGet | PyPi | Maven | - | - | - |
| UI-bibliotek | npm | - | - | - | GitHub | GitHub | GitHub, Storybook |
| Avancerade meddelanden | npm | NuGet | PyPi | Maven | - | - | - |
| Referensdokumentation | Docs | Docs | Docs | Docs | Docs | Docs | - |
Supportinformation för SDK-plattformen
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
Stöd för Android-plattform
Android-ekosystemet är omfattande och omfattar olika versioner och specialiserade plattformar som är utformade för olika typer av enheter. I nästa tabell visas de Android-plattformar som stöds för närvarande:
| Enheter | beskrivning | Support |
|---|---|---|
| Telefoner och surfplattor | Standardenheter som kör Android Commercial. | Fullständigt stöd med videoupplösningen. |
Kommentar
Vi stöder endast videosamtal på telefoner och surfplattor. För användningsfall som rör video på icke-standardenheter eller plattformar (till exempel smarta glasögon eller anpassade enheter) föreslår vi att du kontaktar oss tidigt i utvecklingsprocessen för att fastställa den lämpligaste integreringsmetoden.
Om du hittar problem under implementeringen rekommenderar vi att du går till felsökningsguiden.
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+
.NET
Samtal stöder följande plattformar:
- UWP med .NET Native eller C++/WinRT
- Windows 10/11 10.0.17763 – 10.0.22621.0
- Windows Server 2019/2022 10.0.17763 – 10.0.22621.0
- WinUI3 med .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
Alla andra Communication Services-paket riktar in sig på .NET Standard 2.0, som stöder följande plattformar:
- Stöd via .NET Framework 4.6.1
- Windows 10, 8.1, 8 och 7
- Windows Server 2012 R2, 2012 och 2008 R2 SP1
- Stöd via .NET Core 2.0:
- Windows 10 (1607+), 7 SP1+, 8.1
- Windows Server 2008 R2 SP1+
- Max OS X 10.12+
- Linux flera versioner/distributioner
- UWP 10.0.16299 (RS3) September 2017
- Unity 2018.1
- Mono 5.4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
SDK-paketstorlek
| SDK | Komprimerad storlek (MB) | Okomprimerad storlek (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 |
Om du vill förbättra din app rekommenderar vi att du läser artikeln Metodtips. Den innehåller rekommendationer och en checklista att granska innan du släpper din app.
REST API:er
API:er för Kommunikationstjänster dokumenteras tillsammans med andra Azure REST-API:er. Den här dokumentationen beskriver hur du strukturerar DINA HTTP-meddelanden och ger vägledning för hur du använder Postman. Dokumentation om REST-gränssnittet publiceras också i Swagger-format på GitHub. Du hittar begränsningsgränser för enskilda API:er på sidan tjänstbegränsningar.
Förväntningar på API-stabilitet
Viktigt!
Det här avsnittet innehåller vägledning om REST-API:er och SDK:er som markerats som stabila. API:er som har markerats som förhandsversioner, förhandsversioner eller betaversioner kan ändras eller inaktuella utan föregående meddelande.
I framtiden kan vi dra tillbaka versioner av Communication Services SDK:er och vi kan komma att införa icke-bakåtkompatibla ändringar i våra REST-API:er och släppta SDK:er. Azure Communication Services följer vanligtvis två supportprinciper för att dra tillbaka tjänstversioner:
- Du meddelas minst tre år innan du måste ändra kod på grund av en ändring av kommunikationstjänsternas gränssnitt. Alla dokumenterade REST-API:er och SDK-API:er har vanligtvis minst tre års varning innan gränssnitt inaktiveras.
- Du meddelas minst ett år innan du måste uppdatera SDK-sammansättningar till den senaste delversionen. Dessa nödvändiga uppdateringar bör inte kräva några kodändringar eftersom de är i samma huvudversion. Att använda den senaste SDK:n är särskilt viktigt för biblioteken samtal och chatt som realtidskomponenter som ofta kräver säkerhets- och prestandauppdateringar. Vi rekommenderar starkt att du håller alla dina Communication Services SDK:er uppdaterade.
Exempel på avaktivering av API och SDK
Du har integrerat v24-versionen av SMS REST API i ditt program. Azure Communication-versioner v25.
Du får tre års varning innan dessa API:er slutar fungera och tvingas uppdatera till v25. Den här uppdateringen kan kräva en kodändring.
Du har integrerat v2.02-versionen av Calling SDK i ditt program. Azure Communication-versioner v2.05.
Du kan behöva uppdatera till v2.05-versionen av Calling SDK inom 12 månader efter lanseringen av v2.05. Uppdateringen bör vara en ersättning av artefakten utan att kräva en kodändring eftersom v2.05 är i v2-huvudversionen och inte har några icke-bakåtkompatibla ändringar.
Nästa steg
Mer information finns i följande SDK-översikter:
- Översikt över SDK för samtal
- Översikt över Call Automation SDK
- Översikt över Job Router SDK
- Översikt över chatt-SDK
- Översikt över SMS SDK
- Översikt över E-post-SDK
- Översikt över SDK för avancerade meddelanden
Så här kommer du igång med Azure Communication Services: