Sady SDK a rozhraní REST API
Azure Communication Services schopnosti 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. Sada SDK pro volání používá proprietární síťová rozhraní a je uzavřeným zdrojem.
V následujících tabulkách shrneme tyto oblasti a dostupnost rozhraní REST API a knihoven sdk. Upozorňujeme, jestli jsou rozhraní API a sady SDK určené pro klienty koncových uživatelů nebo prostředí důvěryhodných služeb. K rozhraním API, jako je sms, by zařízení koncových uživatelů v prostředích s nízkou důvěryhodností neměla přímo přistupovat.
Vývoj aplikací pro volání a chat je možné urychlit pomocí knihovny uživatelského rozhraní Azure Communication Services. Přizpůsobitelná knihovna uživatelského rozhraní poskytuje opensourcové komponenty uživatelského rozhraní pro webové a mobilní aplikace a Microsoft motiv 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 |
| Společné | – | Klientská & služba | Poskytuje základní typy pro jiné sady SDK. |
| Identita | REST | Služba | Správa uživatelů, přístupové tokeny |
| 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ání stavu Email zpráv | |
| Chat | REST s proprietární signalizací | Klientská & služba | Přidání textového chatu v reálném čase do aplikací |
| Volání | Proprietární transport | Klient | Hlasová komunikace, video, sdílení obrazovky a další komunikace v reálném čase |
| Automatizace volání | REST | Služba | Sestavení přizpůsobených pracovních postupů volání pro volání do veřejné telefonní sítě a VoIP |
| Network Traversal | REST | Služba | Přístup k serverům TURN pro přenos dat nízké úrovně |
| Knihovna uživatelského rozhraní | – | Klient | Komponenty uživatelského rozhraní připraveného pro produkční prostředí pro chatovací a volací aplikace |
Jazyky a umístění publikování
Umístění publikování pro jednotlivé balíčky sady SDK jsou podrobně popsána níže.
| Plošný | JavaScript | .NET | Python | Java SE | iOS | Android | Jiné |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | Přejít přes GitHub |
| Společ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 | - | - | GitHub | Maven | - |
| Automatizace volání | NuGet | Maven | |||||
| Network Traversal | npm | NuGet | PyPi | Maven | - | - | - |
| Knihovna uživatelského rozhraní | npm | - | - | - | GitHub | GitHub | GitHub, Storybook |
| Referenční dokumentace | dokumentace | dokumentace | - | dokumentace | dokumentace | dokumentace | - |
Podrobnosti o podpoře platformy SADY SDK
iOS a Android
- Sady SDK služby Communication Services pro iOS cílí na iOS verze 13 a novější a Xcode 11 nebo novější.
- Sady Java SDK pro Android cílí na android API úrovně 21 nebo novější a Android Studio 4.0 nebo novější.
.NET
S výjimkou volání cílí balíčky komunikačních služeb na .NET Standard 2.0, které podporují níže uvedené 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 nebo novější
- Maximální operační systém X 10.12 nebo novější
- Více verzí/distribucí Linuxu
- UPW 10.0.16299 (RS3) září 2017
- Unity 2018.1
- Mono 5.4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
Volající balíček podporuje sestavení aplikací pro UPW s .NET Native nebo C++/WinRT na:
- Windows 10 10.0.17763
- Windows Server 2019 10.0.17763
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 najdete pokyny k používání nástroje Postman. Dokumentace k rozhraní REST je také publikovaná ve formátu Swagger na GitHubu. Limity omezení pro jednotlivá rozhraní API najdete na stránce s limity 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 je možné změnit nebo vyřadit bez předchozího upozornění.
V budoucnu můžeme vyřadit verze sad SDK komunikačních služeb a do našich rozhraní REST API a vydaných sad SDK můžeme zavést zásadní změny. Azure Communication Services obecně platí pro vyřazování verzí služby dvě zásady podpory:
- Budete upozorněni nejméně tři roky před tím, 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 obvykle před vyřazením rozhraní z provozu používají upozornění alespoň tři roky.
- Budete upozorněni alespoň jeden rok před tím, než budete muset aktualizovat sestavení SADY SDK na nejnovější podverzi. 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 obzvláště důležité pro knihovny pro volání a chat, které v reálném čase vyžadují aktualizace zabezpečení a výkonu. Důrazně vám doporučujeme, abyste všechny sady SDK komunikačních služeb aktualizovali.
Příklady vyřazení rozhraní API a sady SDK z provozu
Integrovali jste do své aplikace verzi v24 rozhraní SMS REST API. Verze Azure Communication v25.
Než tato rozhraní API přestanou fungovat a vynutí se aktualizovat na verzi 25, zobrazí se upozornění tři roky. Tato aktualizace může vyžadovat změnu kódu.
Do své aplikace jste integrovali verzi sady SDK pro volání v2.02. Verze Azure Communication v2.05
Do 12 měsíců od vydání verze 2.05 možná budete muset aktualizovat na verzi 2.05 sady SDK pro volání. Mělo by se jednat o jednoduché nahrazení artefaktu bez nutnosti změny kódu, protože verze 2.05 je v 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 sady SDK pro volání
- Přehled sady SDK pro automatizaci volání
- Přehled sady SDK pro chat
- Přehled sady SMS SDK
- Přehled sady Email SDK
Začínáme s Azure Communication Services: