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. Calling SDK používá proprietární síťová rozhraní a je uzavřeným zdrojem.

Následující tabulky shrnují tyto oblasti a dostupnost rozhraní REST API a knihoven SDK. Všimněte si, jestli jsou rozhraní API a sady SDK určené pro klienty koncových uživatelů nebo důvěryhodná prostředí služeb. Neměli byste mít přímý přístup k rozhraním API, jako je například SMS, pomocí zařízení koncových uživatelů v prostředích s nízkou důvěryhodností.

Pomocí knihovny uživatelského rozhraní azure Communication Services můžete urychlit vývoj aplikací volání a chatu. 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 šest týdnů až jednou za čtvrtletí). Doporučujeme vytvořit proces, abyste měli jistotu, že vždy aktualizujete na nejnovější sady SDK.

SDKy

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ů a 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 sms zpráv.
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řidejte do svých aplikací textový chat v reálném čase.
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 Vytvořte přizpůsobené pracovní postupy volání pro volání do veřejné telefonní sítě a volání VoIP.
Směrovač úloh REST Služba Optimalizujte správu 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 chatování a volání aplikací
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ý
Azure Resource Manager npm NuGet PyPi Maven - - Přejít na GitHub
Běžný npm NuGet – Maven GitHub Maven -
Identita npm NuGet PyPi Maven - - -
Telefonní čísla npm NuGet PyPi Maven - - -
Konverzace 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.

Pokud jste během implementace našli problémy, prohlédněte si 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:

  • UWP 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

Poznámka:

Nezabalená aplikace není v současné době podporována.

Velikost balíčku SDK

SDK Komprimovaná velikost (MB) Nekomprimovaná velikost (MB)
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, přečtěte si článek o osvědčených postupech. Poskytuje doporučení a kontrolní seznam ke kontrole před vydáním aplikace.

RESTová rozhraní API

Rozhraní API komunikačních služeb jsou zdokumentovaná s dalšími rozhraními AZURE REST API. Tato dokumentace popisuje, jak strukturovat zprávy HTTP a nabízí pokyny k používání nástroje Postman. Dokumentace k rozhraní REST je také publikovaná ve formátu OpenAPI na GitHubu. Limity pro jednotlivé rozhraní API najdete v limitech služby.

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, náhled nebo beta verze mohou být změněna nebo ukončena bez předchozího upozornění.

V budoucnu můžeme vyřadit verze SDK pro komunikační služby a můžeme zavést významné změny našich rozhraní REST API a vydaných 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.
  • 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 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.

Upozornění obdržíte tři roky předtím, než tato rozhraní API přestanou fungovat a budete muset 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. Azure Communication vydává verzi 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: