SDK e API REST
Le funzionalità di Servizi di comunicazione di Azure 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 è a origine chiusa.
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.
È possibile accelerare lo sviluppo di applicazioni Chiamata e Chat dalla libreria dell'interfaccia utente di 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.
Creazione di una procedura per l'uso dell'SDK più recente
I browser e i sistemi operativi sono in continua evoluzione per supportare i miglioramenti più recenti e correggere i bug esistenti. L'uso dell'SDK di Servizi di comunicazione di Azure più recente consente di ottenere la migliore esperienza utente finale complessiva per l'applicazione quando vengono usati con browser aggiornati e aggiornamenti del sistema operativo. L'SDK di Servizi di comunicazione di Azure più aggiornato offre diversi vantaggi, ad esempio prestazioni, sicurezza, compatibilità, qualità e usabilità migliorate. L'aggiornamento consente di accedere alle funzionalità e agli aggiornamenti più recenti aggiunti regolarmente al browser e al sistema operativo. Gli SDK di Servizi di comunicazione di Azure vengono aggiornati frequentemente (circa ogni 6 settimane a una volta al trimestre). È consigliabile creare un processo per assicurarsi di eseguire sempre l'aggiornamento agli SDK più recenti.
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 e servizio | 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 e-mail | |
| Chat | REST con segnalazione proprietaria | Client e servizio | 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 API Android Livello 21 o superiore
- Supporto per Java 7 o versione successiva
- Supporto per Android Studio 2.0
Supporto della piattaforma Android
L'ecosistema Android è ampio, che comprende varie versioni e piattaforme specializzate progettate per diversi tipi di dispositivi. La tabella successiva elenca le piattaforme Android attualmente supportate:
| Dispositivi | Descrizione | Supporto tecnico |
|---|---|---|
| Telefoni e tablet | Dispositivi standard che eseguono Android Commercial. | Supporto completo con la risoluzione video. |
Nota
Supportiamo solo videochiamate su telefoni e tablet. Per i casi d'uso che prevedono video su dispositivi o piattaforme non standard (ad esempio occhiali smart o dispositivi personalizzati), è consigliabile contattarci all'inizio del processo di sviluppo per determinare l'approccio di integrazione più adatto.
Nel caso in cui siano stati rilevati problemi durante l'implementazione, è consigliabile visitare la guida alla risoluzione dei problemi.
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:
- Piattaforma 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
- Piattaforma UWP 10.0.16299 (RS3) settembre 2017
- Unity 2018.1
- Mono 5.4
- Xamarin iOS 10.14
- Xamarin Mac 3.8
Dimensioni pacchetto SDK
| SDK | Dimensioni compresse (MB) | Dimensioni non compresse (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 |
Se si desidera migliorare la propria app, consigliamo di leggere l'articolo Procedure consigliate. Fornisce raccomandazioni e un elenco di controllo da rivedere prima di rilasciare l'app.
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 restrizione di limitazione delle richieste per le singole API nella pagina sui 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. In genere, Servizi di comunicazione di Azure segue due criteri di supporto per ritirare le versioni del servizio:
- Si riceve 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 riceve 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 Chiamate e Chat per i componenti in tempo reale 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 v24 dell'API REST SMS nell'applicazione. Versioni di Comunicazione di Azure v25.
Si riceve un avviso di tre anni prima che queste API smettano di funzionare e vengano forzate a eseguire l'aggiornamento a v25. Questo aggiornamento potrebbe richiedere una modifica del codice.
È stata integrata la versione v2.02 di Calling SDK nell'applicazione. Azure Communication rilascia v2.05.
Potrebbe essere necessario eseguire l'aggiornamento alla versione v2.05 di Calling SDK entro 12 mesi dalla versione v2.05. L'aggiornamento deve essere una sostituzione dell'artefatto senza richiedere una modifica del codice perché la versione v2.05 si trova nella versione principale v2 e non presenta modifiche di rilievo.
Passaggi successivi
Per ulteriori informazioni, vedere le panoramiche SDK seguenti:
- Panoramica dell'SDK di chiamata
- Panoramica di SDK Automazione delle chiamate
- Panoramica di SDK Router processi
- Panoramica dell'SDK di chat
- Panoramica dell'SDK di SMS
- Panoramica di SDK E-mail
- Panoramica di SDK Messaggistica avanzata
Per iniziare a usare Servizi di comunicazione di Azure: