Megosztás a következőn keresztül:

SDK-k és REST API-k

  • Cikk

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. Felhívjuk a figyelmét arra, 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. Az OLYAN API-kat, mint az SMS, nem szabad közvetlenül elérni a végfelhasználói eszközök számára alacsony megbízhatósági környezetben.

A hívás- és csevegési alkalmazások fejlesztését felgyorsíthatja az Azure Communication Services felhasználói felületi kódtára. 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 6 hetente negyedenként). Javasoljuk, hogy hozzon létre egy folyamatot, amely biztosítja, hogy mindig a legújabb SDK-ra frissítsen.

SDK-k

Szerelvény Protokollok Környezet Képességek
Azure Resource Manager REST Szolgáltatás Kommunikációs szolgáltatások erőforrásainak kiépítése és kezelése
Közös n/a Ügyfél - szolgáltatás Alaptípusokat biztosít más SDK-khoz
Identitás REST Szolgáltatás Felhasználók kezelése, jogkivonatok elérése
Telefonszámok REST Szolgáltatás Telefonszámok beszerzése és kezelése
SMS REST Szolgáltatás SMS-üzenetek küldése és fogadása
E-mail REST Szolgáltatás Állapot küldése és lekérése e-mailekben
Csevegés REST védett jelzéssel Ügyfél - szolgáltatás Valós idejű szöveges csevegés hozzáadása az alkalmazásokhoz
Hívó Védett szállítás Ügyfél Hang-, video-, képernyőmegosztás és egyéb valós idejű kommunikáció
Automation hívása REST Szolgáltatás Testre szabott hívási munkafolyamatok létrehozása PSTN- és VoIP-hívásokhoz
Feladat útválasztója REST Szolgáltatás Az ügyfél-interakciók kezelésének optimalizálása különböző alkalmazásokban
Szobák REST Szolgáltatás Strukturált kommunikációs helyiségek létrehozása és kezelése
Felhasználói felületi kódtár n/a Ügyfél Éles használatra kész felhasználói felületi összetevők csevegéshez és alkalmazások hívásához
Speciális üzenetkezelés REST Szolgáltatás WhatsApp Business-üzenetek küldése és fogadása

Nyelvek és közzétételi helyek

Az egyes SDK-csomagok közzétételi helyei:

Terület JavaScript .NET Python Java SE iOS Android Egyéb
Azure Resource Manager npm NuGet PyPi Maven - - Ugrás a GitHubon keresztül
Közös npm NuGet n/a Maven GitHub Maven -
Identitás npm NuGet PyPi Maven - - -
Telefonszámok npm NuGet PyPi Maven - - -
Csevegés npm NuGet PyPi Maven GitHub Maven -
SMS npm NuGet PyPi Maven - - -
E-mail npm NuGet PyPi Maven - - -
Hívó npm NuGet - - CocoaPods Maven -
Automation hívása npm NuGet PyPi Maven
Feladat útválasztója npm NuGet PyPi Maven
Szobák npm NuGet PyPi Maven - - -
Felhasználói felületi kódtár npm - - - GitHub GitHub GitHub, mesekönyv
Speciális üzenetkezelés npm NuGet PyPi Maven - - -
Referenciadokumentáció Dokik Dokik Dokik Dokik Dokik Dokik -

Az SDK platform támogatási adatai

Android-hívó SDK-támogatás

  • Android API 21-es vagy újabb szintű támogatása
  • Java 7 vagy újabb verzió támogatása
  • Az Android Studio 2.0 támogatása
  • Az Androidot futtató Android Auto (AAOS) és IoT-eszközök jelenleg nem támogatottak

iOS-hívó SDK-támogatás

  • 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, javasoljuk, hogy olvassa el 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-k mellett 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 Swagger formátumban is közzé van téve a GitHubon. Az egyes API-k szabályozási korlátait a szolgáltatáskorlátok oldalon 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. A kiadás előtt, előzetes verzióban vagy bétaverzióban megjelö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:

Az Azure Communication Services használatának első lépései: