SDK e API REST
Servizi di comunicazione di Azure funzionalità sono concettualmente organizzate in aree discrete in base all'area funzionale. La maggior parte delle aree dispone di SDK completamente open source programmati rispetto alle API REST pubblicate che è possibile usare direttamente su Internet. L'SDK chiamante usa interfacce di rete proprietarie ed è closed source.
Nelle tabelle seguenti vengono riepilogate queste aree e la disponibilità delle API REST e delle librerie SDK. Si noti se le API e gli SDK sono destinati ai client degli utenti finali o agli ambienti di servizi attendibili. Le API come SMS non devono essere accessibili direttamente dai dispositivi degli utenti finali in ambienti con attendibilità bassa.
Lo sviluppo di applicazioni di chiamata e chat può essere accelerato dalla libreria dell'interfaccia utente Servizi di comunicazione di Azure. La libreria personalizzabile dell'interfaccia utente fornisce componenti dell'interfaccia utente open source per le app Web e per dispositivi mobili e un tema di Microsoft Teams.
SDK
| Assemblaggio | Protocolli | Ambiente | Funzionalità |
|---|---|---|---|
| Azure Resource Manager | REST | Service | Effettuare il provisioning e gestire le risorse di Servizi di comunicazione |
| Comune | N/D | Client & Service | Fornisce tipi di base per altri SDK |
| Identità | REST | Service | Gestire utenti, token di accesso |
| Numeri di telefono | REST | Service | Acquisire e gestire i numeri di telefono |
| SMS | REST | Service | Inviare e ricevere messaggi SMS |
| REST | Service | Inviare e ottenere lo stato nei messaggi di posta elettronica | |
| Chat | REST con segnalazione proprietaria | Client & Service | Aggiungere chat di testo in tempo reale alle applicazioni |
| Chiamata in corso | Trasporto proprietario | Client | Comunicazione vocale, video, condivisione dello schermo e altre comunicazioni in tempo reale |
| Automazione delle chiamate | REST | Service | Creare flussi di lavoro di chiamata personalizzati per chiamate PSTN e VoIP |
| Router processo | REST | Service | Ottimizzare la gestione delle interazioni con i clienti tra varie applicazioni |
| Sale | REST | Service | Creare e gestire sale di comunicazione strutturate |
| Libreria dell'interfaccia utente | N/D | Client | Componenti dell'interfaccia utente pronti per la produzione per le app per chat e chiamate |
| Messaggistica avanzata | REST | Service | Inviare e ricevere messaggi WhatsApp Business |
Lingue e percorsi di pubblicazione
Percorsi di pubblicazione per singoli pacchetti SDK:
| Area | JavaScript | .NET | Python | Java SE | iOS | Android | Altro |
|---|---|---|---|---|---|---|---|
| Azure Resource Manager | npm | NuGet | PyPi | Maven | - | - | Go tramite GitHub |
| Comune | npm | NuGet | N/D | Maven | GitHub | Maven | - |
| Identità | npm | NuGet | PyPi | Maven | - | - | - |
| Numeri di telefono | npm | NuGet | PyPi | Maven | - | - | - |
| Chat | npm | NuGet | PyPi | Maven | GitHub | Maven | - |
| SMS | npm | NuGet | PyPi | Maven | - | - | - |
| npm | NuGet | PyPi | Maven | - | - | - | |
| Chiamata in corso | npm | NuGet | - | - | CocoaPods | Maven | - |
| Automazione delle chiamate | npm | NuGet | PyPi | Maven | |||
| Router processo | npm | NuGet | PyPi | Maven | |||
| Sale | npm | NuGet | PyPi | Maven | - | - | - |
| Libreria dell'interfaccia utente | npm | - | - | - | GitHub | GitHub | GitHub, Storybook |
| Messaggistica avanzata | npm | NuGet | PyPi | Maven | - | - | - |
| Documentazione di riferimento | Documentazione | Documentazione | Documentazione | Documentazione | Documentazione | Documentazione | - |
Dettagli del supporto della piattaforma SDK
Supporto di Android Calling SDK
- Supporto per Android API Livello 21 o superiore
- Supporto per Java 7 o versione successiva
- Supporto per Android Studio 2.0
- I dispositivi Android Auto (AAOS) e IoT che eseguono Android non sono attualmente supportati
Supporto di iOS Calling SDK
- Supporto per iOS 10.0+ in fase di compilazione e iOS 12.0+ in fase di esecuzione
- Xcode 12.0+
- Supporto per iPadOS 13.0+
.NET
La chiamata supporta le piattaforme seguenti:
- UWP con .NET Native o C++/WinRT
- Windows 10/11 10.0.17763 - 10.0.22621.0
- Windows Server 2019/2022 10.0.17763 - 10.0.22621.0
- WinUI3 con .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
Tutti gli altri pacchetti di Servizi di comunicazione sono destinati a .NET Standard 2.0, che supporta le piattaforme seguenti:
- Supporto tramite .NET Framework 4.6.1
- Windows 10, 8.1, 8 e 7
- Windows Server 2012 R2, 2012 e 2008 R2 SP1
- Supporto tramite .NET Core 2.0:
- Windows 10 (1607+), 7 SP1+, 8.1
- Windows Server 2008 R2 SP1+
- Max OS X 10.12+
- Versioni/distribuzioni di Linux multiple
- UWP 10.0.16299 (RS3) settembre 2017
- Unity 2018.1
- Mono 5.4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
API REST
Le API di Servizi di comunicazione sono documentate insieme ad altre API REST di Azure. Questa documentazione descrive come strutturare i messaggi HTTP e offre indicazioni per l'uso di Postman. La documentazione dell'interfaccia REST è pubblicata anche in formato Swagger in GitHub. È possibile trovare limiti di limitazione per le singole API nella pagina dei limiti del servizio.
Aspettative di stabilità delle API
Importante
Questa sezione fornisce indicazioni sulle API REST e gli SDK contrassegnati come stabili. Le API contrassegnate come versioni non definitive, di anteprima o beta possono essere modificate o deprecate senza preavviso.
In futuro è possibile ritirare le versioni degli SDK di Servizi di comunicazione e introdurre modifiche di rilievo alle API REST e agli SDK rilasciati. Servizi di comunicazione di Azure segue in genere due criteri di supporto per il ritiro delle versioni del servizio:
- Si riceverà una notifica almeno tre anni prima di dover modificare il codice a causa di una modifica dell'interfaccia di Servizi di comunicazione. Tutte le API REST documentate e le API SDK in genere godono di almeno tre anni di avviso prima che le interfacce vengano rimosse.
- Si riceverà una notifica almeno un anno prima di dover aggiornare gli assembly SDK alla versione secondaria più recente. Questi aggiornamenti necessari non devono richiedere modifiche al codice perché si trovano nella stessa versione principale. L'uso dell'SDK più recente è particolarmente importante per le librerie di chiamate e chat che spesso richiedono aggiornamenti della sicurezza e delle prestazioni. È consigliabile mantenere aggiornati tutti gli SDK di Servizi di comunicazione.
Esempi di rimozione delle autorizzazioni dell'API e dell'SDK
È stata integrata la versione 24 dell'API REST SMS nell'applicazione. Versioni di Comunicazione di Azure v25.
Si riceverà tre anni di avviso prima che queste API interrompano il funzionamento e siano costrette ad eseguire l'aggiornamento alla versione 25. Questo aggiornamento potrebbe richiedere una modifica del codice.
È stata integrata la versione 2.02 di Calling SDK nell'applicazione. Azure Communication rilascia la versione 2.05.
Potrebbe essere necessario eseguire l'aggiornamento alla versione 2.05 di Calling SDK entro 12 mesi dalla versione 2.05. L'aggiornamento deve essere una semplice sostituzione dell'artefatto senza richiedere una modifica del codice perché la versione 2.05 si trova nella versione principale v2 e non presenta modifiche di rilievo.
Passaggi successivi
Per altre informazioni, vedere le panoramiche dell'SDK seguenti:
- Panoramica di Calling SDK
- Panoramica di Call Automation SDK
- Panoramica di Job Router SDK
- Panoramica di Chat SDK
- Panoramica di SMS SDK
- Panoramica di Email SDK
- Panoramica di Advanced Messaging SDK
Per iniziare a usare Servizi di comunicazione di Azure: