Az Azure Communication Services funkciói elméletileg különálló területekre vannak rendszerezve funkcionális területük alapján. A legtöbb területen teljesen nyílt forráskódú SDK-k vannak programozva a közzétett REST API-kra, amelyeket közvetlenül az interneten keresztül használhat. A hívó SDK védett hálózati adaptereket használ, és zárt forráskódú.
Az alábbi táblázatokban összefoglaljuk ezeket a területeket és a REST API-k és SDK-kódtárak rendelkezésre állását. Megjegyezzük, hogy az API-k és az SDK-k végfelhasználói ügyfeleknek vagy megbízható szolgáltatási környezeteknek vannak-e szánva. Nem szabad közvetlenül hozzáférnie az API-khoz, például az SMS-hez alacsony megbízhatósági környezetben lévő végfelhasználói eszközökkel.
Az Azure Communication Services felhasználói felületi kódtárával felgyorsíthatja a hívás- és csevegési alkalmazások fejlesztését. A testre szabható felhasználói felületi kódtár nyílt forráskódú felhasználói felületi összetevőket biztosít a web- és mobilalkalmazásokhoz, valamint egy Microsoft Teams-témát.
Gyakorlat létrehozása a legújabb SDK használatára
A böngészők és az operációs rendszerek folyamatosan fejlődnek a legújabb fejlesztések támogatása és a meglévő hibák javítása érdekében. A legújabb Azure Communication Services SDK-val a legjobb általános végfelhasználói élményt érheti el az alkalmazás számára, ha frissített böngészőkkel és operációsrendszer-frissítésekkel használja. A legfrissítésesebb Azure Communication Services SDK számos előnyt kínál, például jobb teljesítményt, biztonságot, kompatibilitást, minőséget és használhatóságot. A frissítéssel hozzáférhet a böngészőhöz és az operációs rendszerhez rendszeresen hozzáadott legújabb funkciókhoz és frissítésekhez. Az Azure Communication Services SDK-k gyakran frissülnek (körülbelül hathetente, negyedévente egyszer). Javasoljuk, hogy hozzon létre egy folyamatot, amely biztosítja, hogy mindig a legújabb SDK-ra frissítsen.
Az Android-ökoszisztéma széles körű, magában foglalja a különböző típusú eszközökhöz tervezett különböző verziókat és speciális platformokat. A következő táblázat a jelenleg támogatott Android-platformokat sorolja fel:
Eszközök
Leírás
Támogatás
Telefonok és tabletek
Az Android Commercialet futtató standard eszközök.
Csak telefonokon és táblagépeken történő videohívásokat támogatunk. Nem szabványos eszközökön vagy platformokon (például intelligens szemüvegen vagy egyéni eszközökön) készült videós esetek esetén javasoljuk, hogy a fejlesztési folyamat korai szakaszában vegye fel velünk a kapcsolatot a legmegfelelőbb integrációs megközelítés meghatározásához.
Az iOS 10.0+ támogatása a buildeléskor, az iOS 12.0+ pedig futásidőben
Xcode 12.0+
Az iPadOS 13.0+ támogatása
.NET
A hívás a következő platformokat támogatja:
UWP .NET natív vagy C++/WinRT használatával
Windows 10/11 10.0.17763 – 10.0.22621.0
Windows Server 2019/2022 10.0.17763 – 10.0.22621.0
WinUI3 a .NET 6-tal
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
Minden más Communication Services-csomag a .NET Standard 2.0-t célozza, amely a következő platformokat támogatja:
Támogatás a .NET-keretrendszer 4.6.1-en keresztül
Windows 10, 8.1, 8 és 7
Windows Server 2012 R2, 2012 és 2008 R2 SP1
Támogatás a .NET Core 2.0-val:
Windows 10 (1607+), 7 SP1+, 8.1
Windows Server 2008 R2 SP1+
Max OS X 10.12+
Linux több verzió/disztribúció
UWP 10.0.16299 (RS3) 2017. szeptember
Unity 2018.1
Mono 5.4
Xamarin iOS 10.14
Xamarin Mac 3.8
SDK-csomag mérete
SDK
Tömörített méret (MB)
Tömörítetlen méret (MB)
iOS SDK
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
Ha javítani szeretné az alkalmazást, tekintse meg az ajánlott eljárásokat ismertető cikket. Javaslatokat és ellenőrzőlistát biztosít az alkalmazás közzététele előtt.
REST API-k
A Communication Services API-k más Azure REST API-kkal vannak dokumentálva. Ez a dokumentáció bemutatja, hogyan strukturálhatja a HTTP-üzeneteket, és útmutatást nyújt a Postman használatához. A REST-felület dokumentációja OpenAPI formátumban is közzé van téve a GitHubon. Az egyes API-k szabályozási korlátait a szolgáltatási korlátok között találja.
API-stabilitási elvárások
Fontos
Ez a szakasz útmutatást nyújt a stabilként megjelölt REST API-król és SDK-król. Az előzetes, előzetes, előzetes vagy bétaverzióval jelölt API-k értesítés nélkül módosíthatók vagy elavultak lehetnek.
A jövőben kivonhatjuk a Communication Services SDK-k verzióit, és a REST API-k és a kiadott SDK-k kompatibilitástörő változásait is bevezethetjük. Az Azure Communication Services általában két támogatási szabályzatot követ a szolgáltatásverziók kivonásához:
Legalább három évvel azelőtt értesítést kap, hogy módosítania kell a kódot a Communication Services felületének módosítása miatt. A dokumentált REST API-k és az SDK API-k általában legalább hároméves figyelmeztetést élveznek a felületek leszerelése előtt.
Legalább egy évvel azelőtt értesítést kap, hogy frissítenie kell az SDK-szerelvényeket a legújabb alverzióra. Ezek a szükséges frissítések nem igényelnek kódmódosítást, mert ugyanabban a főverzióban vannak. A legújabb SDK használata különösen fontos a hívás- és csevegési kódtárak esetében, amelyek valós idejű összetevők, amelyek gyakran igényelnek biztonsági és teljesítményfrissítéseket. Határozottan javasoljuk, hogy tartsa naprakészen a Communication Services SDK-jait.
API- és SDK-leszerelési példák
Integrálta az SMS REST API v24-es verzióját az alkalmazásba. Az Azure Communication 25-ös verziót ad ki.
Három év figyelmeztetést kap, mielőtt ezek az API-k leállnak, és a v25-ös verzióra kell frissíteniük őket. Ez a frissítés kódmódosítást igényelhet.
Integrálta a hívó SDK 2.02-es verzióját az alkalmazásba. Az Azure Communication 2.05-ös verziójának kiadása.
Előfordulhat, hogy a hívó SDK 2.05-ös verziójára kell frissítenie a 2.05-ös verzió megjelenésétől számított 12 hónapon belül. A frissítésnek kódmódosítás nélkül kell lecserélnie az összetevőt, mert a 2.05-ös verzió a v2 főverzióban található, és nem változik kompatibilitástörő változásokkal.
Következő lépések
További információkért tekintse meg az SDK alábbi áttekintéseit:
Ismerje meg azokat a kulcsfontosságú termékeket és szolgáltatásokat, amelyek segíthetnek kommunikációs alkalmazások létrehozásában az Azure-ban a Communication Services használatával.
Hatékony lekérdezések írása, indexelési szabályzatok létrehozása, erőforrások kezelése és kiépítése az SQL API-ban és az SDK-ban a Microsoft Azure Cosmos DB-vel.