Sady SDK a rozhraní REST API
Funkce Azure Communication Services jsou koncepčně uspořádané do samostatných oblastí na základě jejich funkční oblasti. Většina oblastí má plně opensourcové sady SDK naprogramované proti publikovaným rozhraním REST API, která můžete používat přímo přes internet. Volající sada SDK používá proprietární síťová rozhraní a je uzavřená.
V následujících tabulkách shrnujeme tyto oblasti a dostupnost rozhraní REST API a knihoven SDK. Upozorňujeme, že rozhraní API a sady SDK jsou určená pro klienty koncových uživatelů nebo důvěryhodná prostředí služeb. Rozhraní API, jako je například SMS, by neměla být přímo přístupná zařízeními koncových uživatelů v prostředích s nízkou důvěryhodností.
Vývoj aplikací pro volání a chat je možné urychlit knihovnou uživatelského rozhraní služeb Azure Communication Services. Přizpůsobitelná knihovna uživatelského rozhraní poskytuje opensourcové komponenty uživatelského rozhraní pro webové a mobilní aplikace a motiv Microsoft Teams.
Sady SDK
| Sestavení | Protokoly | Prostředí | Možnosti |
|---|---|---|---|
| Azure Resource Manager | REST | Služba | Zřizování a správa prostředků komunikačních služeb |
| Běžný | – | Klient a služba | Poskytuje základní typy pro jiné sady SDK. |
| Identita | REST | Služba | Správa uživatelů, přístupových tokenů |
| Telefonní čísla | REST | Služba | Získání a správa telefonních čísel |
| SMS | REST | Služba | Odesílání a příjem zpráv SMS |
| REST | Služba | Odesílání a získávání stavu u e-mailových zpráv | |
| Chat | REST s proprietárním signálem | Klient a služba | Přidání textového chatu v reálném čase do aplikací |
| Volání | Proprietární doprava | Klient | Hlas, video, sdílení obrazovky a další komunikace v reálném čase |
| Automatizace volání | REST | Služba | Vytváření přizpůsobených pracovních postupů volání pro volání do veřejné telefonní sítě a volání VoIP |
| Směrovač úloh | REST | Služba | Optimalizace správy interakcí zákazníků napříč různými aplikacemi |
| Pokoje | REST | Služba | Vytváření a správa strukturovaných komunikačních místností |
| Knihovna uživatelského rozhraní | – | Klient | Komponenty uživatelského rozhraní připravené pro produkční prostředí pro chatovací a volací aplikace |
| Rozšířené zasílání zpráv | REST | Služba | Odesílání a příjem zpráv WhatsApp Business |
Jazyky a umístění publikování
Umístění publikování pro jednotlivé balíčky SDK:
| Plocha | JavaScript | .NET | Python | Java SE | iOS | Android | Jiný důvod |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | Přejít přes GitHub |
| Běžný | npm | NuGet | – | Maven | GitHub | Maven | - |
| Identita | npm | NuGet | PyPi | Maven | - | - | - |
| Telefonní čísla | npm | NuGet | PyPi | Maven | - | - | - |
| Chat | npm | NuGet | PyPi | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| npm | NuGet | PyPi | Maven | - | - | - | |
| Volání | npm | NuGet | - | - | CocoaPods | Maven | - |
| Automatizace volání | npm | NuGet | PyPi | Maven | |||
| Směrovač úloh | npm | NuGet | PyPi | Maven | |||
| Pokoje | npm | NuGet | PyPi | Maven | - | - | - |
| Knihovna uživatelského rozhraní | npm | - | - | - | GitHub | GitHub | GitHub, Storybook |
| Rozšířené zasílání zpráv | npm | NuGet | PyPi | Maven | - | - | - |
| Referenční dokumentace | dokumentace | dokumentace | dokumentace | dokumentace | dokumentace | dokumentace | - |
Podrobnosti o podpoře platformy SDK
Podpora sady Android Call SDK
- Podpora rozhraní ANDROID API úrovně 21 nebo vyšší
- Podpora Pro Javu 7 nebo novější
- Podpora pro Android Studio 2.0
- Zařízení s Androidem Auto (AAOS) a IoT s Androidem se v současné době nepodporují.
Podpora volací sady SDK pro iOS
- Podpora pro iOS 10.0+ v době sestavení a iOS 12.0+ za běhu
- Xcode 12.0+
- Podpora pro iPadOS 13.0+
.NET
Volání podporuje následující platformy:
- UPW s .NET Native nebo C++/WinRT
- Windows 10/11 10.0.17763 – 10.0.22621.0
- Windows Server 2019/2022 10.0.17763 – 10.0.22621.0
- WinUI3 s .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
Všechny ostatní balíčky komunikačních služeb cílí na .NET Standard 2.0, které podporují následující platformy:
- Podpora prostřednictvím rozhraní .NET Framework 4.6.1
- Windows 10, 8.1, 8 a 7
- Windows Server 2012 R2, 2012 a 2008 R2 SP1
- Podpora prostřednictvím .NET Core 2.0:
- Windows 10 (1607+), 7 SP1+, 8.1
- Windows Server 2008 R2 SP1+
- Max OS X 10.12+
- Linux s více verzemi a distribucemi
- UPW 10.0.16299 (RS3) září 2017
- Unity 2018.1
- Mono 5.4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
Velikost balíčku SADY SDK
| Sada SDK | Komprimovaná velikost (MB) | Nekomprimovaná velikost (MB) |
|---|---|---|
| Sada SDK pro iOS | 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 |
Pokud chcete aplikaci vylepšit, doporučujeme si přečíst článek s osvědčenými postupy. Poskytuje doporučení a kontrolní seznam ke kontrole před vydáním aplikace.
Rozhraní REST API
Rozhraní API komunikačních služeb jsou zdokumentovaná společně s dalšími rozhraními AZURE REST API. V této dokumentaci se dozvíte, jak strukturovat zprávy HTTP a jak používat Postman. Dokumentace k rozhraní REST je také publikovaná ve formátu Swagger na GitHubu. Omezení omezení pro jednotlivá rozhraní API najdete na stránce omezení služeb.
Očekávání stability rozhraní API
Důležité
Tato část obsahuje pokyny k rozhraním REST API a sadám SDK označeným jako stabilní. Rozhraní API označená jako předběžná verze, verze Preview nebo beta verze se můžou změnit nebo přestat používat bez předchozího upozornění.
V budoucnu můžeme vyřadit verze sad SDK komunikačních služeb a můžeme zavést zásadní změny našich rozhraní REST API a vydaných sad SDK. Azure Communication Services se obecně řídí dvěma zásadami podpory pro vyřazení verzí služby:
- Budete upozorněni alespoň tři roky, než budete muset změnit kód kvůli změně rozhraní komunikačních služeb. Všechna zdokumentovaná rozhraní REST API a rozhraní API sady SDK mají obecně alespoň tři roky upozornění před vyřazením rozhraní z provozu.
- Než budete muset aktualizovat sestavení SADY SDK na nejnovější podverzi, budete upozorněni alespoň jeden rok. Tyto požadované aktualizace by neměly vyžadovat žádné změny kódu, protože jsou ve stejné hlavní verzi. Použití nejnovější sady SDK je zvlášť důležité pro knihovny volání a chatu, které často vyžadují aktualizace zabezpečení a výkonu v reálném čase. Důrazně doporučujeme udržovat všechny sady SDK komunikačních služeb aktualizované.
Příklady vyřazení rozhraní API a sady SDK z provozu
Do aplikace jste integrovali verzi rozhraní REST API sms v24. Verze Azure Communication v25.
Než tato rozhraní API přestanou fungovat, dostanete upozornění na tři roky a budou nuceni provést aktualizaci na verzi 25. Tato aktualizace může vyžadovat změnu kódu.
Do aplikace jste integrovali verzi sady SDK volání verze 2.02. Verze Azure Communication v2.05
Do 12 měsíců od vydání verze 2.05 se může vyžadovat aktualizace na verzi v2.05 sady SDK pro volání. Aktualizace by měla být nahrazením artefaktu bez nutnosti změny kódu, protože verze 2.05 je ve hlavní verzi v2 a neobsahuje žádné zásadní změny.
Další kroky
Další informace najdete v následujících přehledech sady SDK:
- Přehled volání sady SDK
- Přehled sady SDK pro automatizaci volání
- Přehled sady SDK směrovače úloh
- Přehled chatovací sady SDK
- Přehled sady SMS SDK
- Přehled e-mailové sady SDK
- Přehled sady SDK pro pokročilé zasílání zpráv
Začínáme se službou Azure Communication Services: