Funzionalità di chiamata supportate per gli utenti di Teams in Calling SDK
Azure Communication Services Calling SDK consente ai dispositivi utente di Teams di guidare esperienze di comunicazione vocale e video. Questa pagina fornisce descrizioni dettagliate delle funzionalità di chiamata, incluse le informazioni sul supporto della piattaforma e del browser. Per iniziare subito a usare JavaScript, vedere Avvio rapido per chiamate.
Funzionalità chiave di Calling SDK:
- Indirizzamento - Servizi di comunicazione di Azure usa identificatore utente di Microsoft Entra per indirizzare gli endpoint di comunicazione. I client usano le identità di Microsoft Entra per eseguire l'autenticazione al servizio e comunicare tra loro. Queste identità vengono usate nelle API chiamanti che forniscono ai client visibilità su chi è connesso a una chiamata (elenco partecipanti). E vengono usate anche in API Microsoft Graph.
- Crittografia: l'SDK chiamante esegue la crittografia del traffico e impedisce la manomissione in transito.
- Gestione dei dispositivi e dei file multimediali: l'SDK chiamante offre funzionalità per l'associazione a dispositivi audio e video, codifica il contenuto per una trasmissione efficiente sul piano dati delle comunicazioni ed esegue il rendering del contenuto nei dispositivi di output e nelle visualizzazioni specificate. Sono disponibili anche API per la condivisione dello schermo e dell'applicazione.
- Notifiche: l'SDK chiamante fornisce API che consentono ai client di ricevere la notifica di una chiamata in arrivo. In situazioni in cui l'app non è in esecuzione in primo piano, i modelli sono disponibili per attivare le notifiche popup ("avvisi popup") per informare gli utenti di una chiamata in arrivo.
Funzionalità di chiamata
L'elenco seguente presenta il set di funzionalità attualmente disponibili nell'SDK per chiamate di Servizi di comunicazione di Azure quando si partecipa alle chiamate VoIP (Voice Over IP) 1:1 o VoIP di gruppo.
| Gruppo di funzionalità | Funzionalità | JavaScript | Finestre | Java (Android) | Objective-C (iOS) |
|---|---|---|---|---|---|
| Funzionalità principali | Effettuare una chiamata uno-a-uno all'utente di Teams | ✔️ | ✔️ | ✔️ | ✔️ |
| Effettuare una chiamata uno-a-uno all'utente di Servizi di comunicazione di Azure | ❌ | ❌ | ❌ | ❌ | |
| Effettuare una chiamata di gruppo con più di due utenti (fino a 350 utenti) | ✔️ | ✔️ | ✔️ | ✔️ | |
| Trasformare una chiamata uno-a-uno con due utenti Teams in una chiamata di gruppo con più di due utenti Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| Partecipare a una chiamata di gruppo dopo che è stata avviata | ❌ | ❌ | ❌ | ❌ | |
| Invitare un altro utente VoIP a partecipare a una chiamata di gruppo in corso | ✔️ | ✔️ | ✔️ | ✔️ | |
| Testare microfono, altoparlante e fotocamera con un servizio di test audio (disponibile chiamando 8:echo123) | ✔️ | ✔️ | ✔️ | ✔️ | |
| L'effettuazione di una chiamata rispetta la configurazione dell'accesso esterno di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| L'effettuazione di una chiamata rispetta la configurazione dell'accesso ospite di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| Controlli durante la chiamata | Attivare/Disattivare il video | ✔️ | ✔️ | ✔️ | ✔️ |
| Attivare/Disattivare il microfono | ✔️ | ✔️ | ✔️ | ✔️ | |
| Passare da una fotocamera all'altra | ✔️ | ✔️ | ✔️ | ✔️ | |
| Bloccare/Sbloccare chiamata locale | ✔️ | ✔️ | ✔️ | ✔️ | |
| Indicatore di interlocutori dominanti nella chiamata | ✔️ | ✔️ | ✔️ | ✔️ | |
| Scegliere il dispositivo altoparlante per le chiamate | ✔️ | ✔️ | ❌2 | ❌2 | |
| Scegliere il microfono per le chiamate | ✔️ | ✔️ | ❌2 | ❌2 | |
| Indicatore dello stato del partecipante Inattivo, Contenuto multimediale anticipato, Connessione in corso, Connesso, In attesa, In sala di attesa, Disconnesso |
✔️ | ✔️ | ✔️ | ✔️ | |
| Indicatore dello stato della chiamata Contenuto multimediale anticipato, In arrivo, Connessione in corso, Chiamata in corso, Connesso, In attesa, Disconnessione in corso, Disconnesso |
✔️ | ✔️ | ✔️ | ✔️ | |
| Indicare i partecipanti con audio disattivato | ✔️ | ✔️ | ✔️ | ✔️ | |
| Indicare i motivi per cui i partecipanti hanno terminato la chiamata | ✔️ | ✔️ | ✔️ | ✔️ | |
| Condivisione dello schermo | Condividere l'intero schermo dall'applicazione | ✔️ | ✔️1 | ✔️1 | ✔️1 |
| Condividere un'applicazione specifica (dall'elenco delle applicazioni in esecuzione) | ✔️ | ✔️1 | ❌ | ❌ | |
| Condividere una scheda del Web browser dall'elenco delle schede aperte | ✔️ | ✔️ | ✔️ | ✔️ | |
| Ricevere il flusso di condivisione dello schermo | ❌ | ❌ | ❌ | ❌ | |
| Condividere il contenuto in modalità "solo contenuto" | ✔️ | ✔️ | ✔️ | ✔️ | |
| Ricevere un flusso video con contenuto per l'esperienza di condivisione dello schermo "solo contenuto" | ✔️ | ✔️ | ✔️ | ✔️ | |
| Condividere il contenuto in modalità "standout" | ❌ | ❌ | ❌ | ❌ | |
| Ricevere un flusso video con contenuto per l'esperienza di condivisione dello schermo "standout" | ❌ | ❌ | ❌ | ❌ | |
| Condividere il contenuto in modalità "side-by-side" | ❌ | ❌ | ❌ | ❌ | |
| Ricevere un flusso video con contenuto per l'esperienza di condivisione dello schermo "side-by-side" | ❌ | ❌ | ❌ | ❌ | |
| Condividere il contenuto in modalità "reporter" | ❌ | ❌ | ❌ | ❌ | |
| Ricevere un flusso video con contenuto per l'esperienza di condivisione dello schermo "reporter" | ❌ | ❌ | ❌ | ❌ | |
| Condividere l'audio di sistema durante la condivisione dello schermo | ✔️ | ❌ | ❌ | ❌ | |
| Registro | Elencare i partecipanti | ✔️ | ✔️ | ✔️ | ✔️ |
| Aggiungere un utente dei Servizi di comunicazione di Azure | ❌ | ❌ | ❌ | ❌ | |
| Aggiungere un utente di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| L'aggiunta di utenti Teams rispetta la configurazione dell'accesso esterno di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| L'aggiunta di utenti Teams rispetta la configurazione dell'accesso ospite di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| Aggiungere un numero di telefono | ✔️ | ✔️ | ✔️ | ✔️ | |
| Rimuovere un partecipante | ✔️ | ✔️ | ✔️ | ✔️ | |
| Ammettere i partecipanti alla sala di attesa nella riunione di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| Essere ammessi alla riunione di Teams dalla sala di attesa | ✔️ | ✔️ | ✔️ | ✔️ | |
| L'aggiunta di utenti di Teams rispetta le barriere informative | ✔️ | ✔️ | ✔️ | ✔️ | |
| Gestione dei dispositivi | Chiedere l'autorizzazione per l'uso di audio e/o video | ✔️ | ✔️ | ✔️ | ✔️ |
| Ottenere l'elenco delle videocamere | ✔️ | ✔️ | ✔️ | ✔️ | |
| Impostare la videocamera | ✔️ | ✔️ | ✔️ | ✔️ | |
| Ottenere la videocamera selezionata | ✔️ | ✔️ | ✔️ | ✔️ | |
| Ottenere l'elenco dei microfoni | ✔️ | ✔️ | ✔️ | ✔️ | |
| Configurare il microfono | ✔️ | ✔️ | ✔️ | ✔️ | |
| Ottenere il microfono selezionato | ✔️ | ✔️ | ✔️ | ✔️ | |
| Ottenere l'elenco degli altoparlanti | ✔️ | ✔️ | ✔️ | ✔️ | |
| Impostare l'altoparlante | ✔️ | ✔️ | ✔️ | ✔️ | |
| Ottenere l'altoparlante selezionato | ✔️ | ✔️ | ✔️ | ✔️ | |
| Rendering video | Eseguire il rendering di un video singolo in più posizioni (videocamera locale o flusso remoto) | ✔️ | ✔️ | ✔️ | ✔️ |
| Impostare/Aggiornare la modalità di ridimensionamento | ✔️ | ✔️ | ✔️ | ✔️ | |
| Eseguire il rendering del flusso video remoto | ✔️ | ✔️ | ✔️ | ✔️ | |
| Vedere il flusso video in modalità Insieme | ✔️ | ❌ | ❌ | ❌ | |
| Vedere la visualizzazione Galleria estesa | ❌ | ❌ | ❌ | ❌ | |
| Ricevere il flusso video dal bot multimediale di Teams | ❌ | ❌ | ❌ | ❌ | |
| Ricevere un flusso regolato per "contenuto dalla fotocamera" | ❌ | ❌ | ❌ | ❌ | |
| Aggiungere e rimuovere il flusso video dai contenuti in evidenza | ✔️ | ✔️ | ✔️ | ✔️ | |
| Consentire la selezione del flusso video per i contenuti in evidenza | ✔️ | ✔️ | ✔️ | ✔️ | |
| Effetti video | Sfocatura dello sfondo | ✔️ | ✔️ | ✔️ | ✔️ |
| Immagine di sfondo personalizzata | ✔️ | ❌ | ❌ | ❌ | |
| Registrazione e trascrizione | Gestire la registrazione cloud di Teams | ❌ | ❌ | ❌ | ❌ |
| Ricevere informazioni sulla chiamata registrata nel cloud | ✔️ | ✔️ | ✔️ | ✔️ | |
| Concedere il consenso esplicito alla registrazione cloud di Teams | ✔️ | ❌ | ❌ | ❌ | |
| Gestire la trascrizione di Teams | ❌ | ❌ | ❌ | ❌ | |
| Ricevere informazioni sulla trascrizione della chiamata | ✔️ | ✔️ | ✔️ | ✔️ | |
| Concedere il consenso esplicito alla trascrizione di Teams | ✔️ | ❌ | ❌ | ❌ | |
| Gestire i sottotitoli di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| Supporto per la registrazione della conformità | ✔️ | ✔️ | ✔️ | ✔️ | |
| Interazione | Alzare e abbassare la mano | ✔️ | ✔️ | ✔️ | ✔️ |
| Indicare le mani alzate e abbassate di altri partecipanti | ✔️ | ✔️ | ✔️ | ✔️ | |
| Attivare le reazioni | ❌ | ❌ | ❌ | ❌ | |
| Indicare le reazioni di altri partecipanti | ❌ | ❌ | ❌ | ❌ | |
| Integrazioni | Controllare le applicazioni Teams di terze parti | ❌ | ❌ | ❌ | ❌ |
| Ricevere lo streaming live di PowerPoint | ❌ | ❌ | ❌ | ❌ | |
| Ricevere il flusso Whiteboard | ❌ | ❌ | ❌ | ❌ | |
| Interagire con un sondaggio | ❌ | ❌ | ❌ | ❌ | |
| Interagire con un domande e risposte | ❌ | ❌ | ❌ | ❌ | |
| Routing delle chiamate avanzato | L'avvio di una chiamata e l'aggiunta delle operazioni utente rispettano le regole di inoltro | ✔️ | ✔️ | ✔️ | ✔️ |
| Leggere e configurare le regole di inoltro delle chiamate | ❌ | ❌ | ❌ | ❌ | |
| L'avvio di una chiamata e l'aggiunta delle operazioni utente rispettano lo squillo simultaneo | ✔️ | ✔️ | ✔️ | ✔️ | |
| Leggere e configurare lo squillo simultaneo | ❌ | ❌ | ❌ | ❌ | |
| L'avvio di una chiamata e l'aggiunta delle operazioni utente rispettano lo stato "Non disturbare" | ✔️ | ✔️ | ✔️ | ✔️ | |
| Mettendo in attesa il partecipante si riproduce musica di attesa | ✔️ | ❌ | ❌ | ❌ | |
| Quando si viene inseriti dall'utente di Teams sul client Teams in attesa, viene riprodotta la musica di attesa | ✔️ | ✔️ | ✔️ | ✔️ | |
| Parcheggiare una chiamata | ❌ | ❌ | ❌ | ❌ | |
| Essere parcheggiati | ✔️ | ✔️ | ✔️ | ✔️ | |
| Trasferire una chiamata a un utente | ✔️ | ✔️ | ✔️ | ✔️ | |
| Essere trasferiti a un utente o a una chiamata | ✔️ | ✔️ | ✔️ | ✔️ | |
| Trasferire una chiamata a una chiamata | ✔️ | ✔️ | ✔️ | ✔️ | |
| Trasferire una chiamata alla segreteria telefonica | ✔️ | ✔️ | ✔️ | ✔️ | |
| Essere trasferiti alla segreteria telefonica | ✔️ | ✔️ | ✔️ | ✔️ | |
| Unire le chiamate in corso | ❌ | ❌ | ❌ | ❌ | |
| Avviare una chiamata e aggiungere operazioni utente rispetta la configurazione della riga condivisa | ✔️ | ✔️ | ✔️ | ✔️ | |
| Avviare una chiamata per conto dell'utente di Teams | ❌ | ❌ | ❌ | ❌ | |
| Leggere e configurare la configurazione della riga condivisa | ❌ | ❌ | ❌ | ❌ | |
| Ricevere una chiamata dall'operatore automatico di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| Trasferire una chiamata all'operatore automatico di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| Ricevere una chiamata dalla coda delle chiamate di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| Trasferire una chiamata dalla coda delle chiamate di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| Criteri di chiamata Teams | Rispetta "Effettua chiamate private" | ✔️ | ✔️ | ✔️ | ✔️ |
| Rispetta l'impostazione "Registrazione cloud per le chiamate" | Nessuna API disponibile | Nessuna API disponibile | Nessuna API disponibile | Nessuna API disponibile | |
| Rispetta l'impostazione "Trascrizione" | Nessuna API disponibile | Nessuna API disponibile | Nessuna API disponibile | Nessuna API disponibile | |
| Rispettare l'impostazione "Inoltro di chiamata e squillo simultaneo alle persone dell'organizzazione" | ✔️ | ✔️ | ✔️ | ✔️ | |
| Rispetta l'impostazione "Inoltro di chiamata e squillo simultaneo verso numeri di telefono esterni" | ✔️ | ✔️ | ✔️ | ✔️ | |
| Rispetta l'impostazione "Segreteria telefonica disponibile per il routing delle chiamate in ingresso" | ✔️ | ✔️ | ✔️ | ✔️ | |
| Rispetta l'impostazione "Le chiamate in ingresso possono essere instradate ai gruppi di chiamate" | ✔️ | ✔️ | ✔️ | ✔️ | |
| Rispetta l'impostazione "Delega per le chiamate in ingresso e in uscita" | ✔️ | ✔️ | ✔️ | ✔️ | |
| Rispetta l'impostazione "Impedisci bypass tariffa e invia chiamate tramite PSTN" | ❌ | ❌ | ❌ | ❌ | |
| Rispetta l'impostazione "Musica in attesa" | ❌ | ❌ | ❌ | ❌ | |
| Rispetta l'impostazione "Occupato in caso di chiamata" | ❌ | ❌ | ❌ | ❌ | |
| Rispetta l'impostazione "Sottotitoli in tempo reale nelle chiamate di Teams" | Nessuna API disponibile | Nessuna API disponibile | Nessuna API disponibile | Nessuna API disponibile | |
| Rispetta l'impostazione "Filtro chiamata indesiderata" | ✔️ | ✔️ | ✔️ | ✔️ | |
| Rispetta l'impostazione "I dispositivi SIP possono essere usati per le chiamate" | ✔️ | ✔️ | ✔️ | ✔️ | |
| DevOps | Metriche di Azure | ✔️ | ✔️ | ✔️ | ✔️ |
| Monitoraggio di Azure | ✔️ | ✔️ | ✔️ | ✔️ | |
| Informazioni sui servizi di comunicazione di Azure | ✔️ | ✔️ | ✔️ | ✔️ | |
| Eventi delle chiamate vocali e delle videochiamate di Servizi di comunicazione di Azure | ❌ | ❌ | ❌ | ❌ | |
| Analisi delle chiamate di Teams | ✔️ | ✔️ | ✔️ | ✔️ | |
| Analisi in tempo reale di Teams | ❌ | ❌ | ❌ | ❌ |
- La funzionalità Condividi schermo può essere ottenuta usando Raw Media, se si vuole imparare come aggiungere Raw Media, consultare la guida introduttiva.
- L'SDK chiamante non ha un'API esplicita, è necessario usare l'API del sistema operativo (android & iOS) per ottenerla.
Il supporto per lo streaming, i timeout, le piattaforme e i browser viene condiviso con panoramica dell'SDK per chiamate a Servizi di comunicazione.
Passaggi successivi
Per altre informazioni, vedere gli articoli seguenti:
- Acquisire familiarità con i flussi di chiamate generali
- Informazioni sui tipi di chiamate