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.
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
- Android Auto -enheter (AAOS) och IoT-enheter som kör Android stöds för närvarande inte
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: