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
E-mail 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 - - -
E-mail 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:

Začínáme s Azure Communication Services: