Sdílet prostřednictvím


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.

Vytvoření praxe pro použití nejnovější sady SDK

Prohlížeče a operační systémy se neustále vyvíjejí, aby podporovaly nejnovější vylepšení a opravily stávající chyby. Použití nejnovější sady SDK služby Azure Communication Services vám pomůže dosáhnout nejlepšího celkového uživatelského prostředí pro vaši aplikaci při použití s aktualizovanými prohlížeči a aktualizacemi operačního systému. Sada SDK služby Azure Communication Services nabízí řadu výhod, jako je lepší výkon, zabezpečení, kompatibilita, kvalita a použitelnost. Aktualizace umožňuje přístup k nejnovějším funkcím a aktualizacím, které se pravidelně přidávají do prohlížeče a operačního systému. Sady SDK služby Azure Communication Services se často aktualizují (přibližně každých 6 týdnů až jednou za čtvrtletí). Doporučujeme vytvořit proces, abyste měli jistotu, že se vždy aktualizujete na nejnovější sady SDK.

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
E-mail 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í
Povolá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 - - -
E-mail npm NuGet PyPi Maven - - -
Povolá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
Podpora platformy Android

Ekosystém Androidu je rozsáhlý a zahrnuje různé verze a specializované platformy navržené pro různé typy zařízení. Následující tabulka uvádí aktuálně podporované platformy Android:

Zařízení Popis Technická podpora
Telefony a tablety Standardní zařízení s Androidem Commercial. Plně podporuje rozlišení videa.

Poznámka:

Podporujeme jenom videohovory na telefonech a tabletech. V případě případů použití zahrnujících video na nestandardních zařízeních nebo platformách (jako jsou inteligentní brýle nebo vlastní zařízení), doporučujeme kontaktovat nás v rané fázi procesu vývoje, abychom mohli určit nejvhodnější integrační přístup.

V případě, že během implementace narazíte na problémy, doporučujeme vám navštívit průvodce odstraňováním potíží.

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.

Zobrazí se upozornění na tři roky, než tato rozhraní API přestanou fungovat a jsou nuceni aktualizovat 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:

Začínáme se službou Azure Communication Services: