Abilitare la condivisione di file tramite la libreria dell'interfaccia utente nella chat di interoperabilità di Teams - An Azure Communication Services tutorial

Articolo
07/25/2024

Nella chat di interoperabilità di Teams è possibile abilitare la condivisione di file tra gli utenti finali di Servizi di comunicazione di Azure e gli utenti di Teams. Nota: La chat di interoperabilità è diversa dalla chat di Servizi di comunicazione di Azure. Per abilitare la condivisione di file in una chat di Servizi di comunicazione di Azure, vedere Aggiungere la condivisione di file tramite la libreria dell'interfaccia utente nella chat di Servizi di comunicazione di Azure. Attualmente, l'utente finale di Servizi di comunicazione di Azure può solo ricevere allegati di file dall'utente di Teams. Per altre informazioni vedere Casi d'uso della libreria dell'interfaccia utente.

Importante

La funzionalità di condivisione file include l’insieme CallWithChat senza configurazioni aggiuntive.

Scaricare il codice

Per questa esercitazione accedere al codice su GitHub.

Prerequisiti

Un account Azure con una sottoscrizione attiva. Per informazioni dettagliate vedere Creare un account gratuito.
Visual Studio Code in una delle piattaforme supportate.
Node.js, versione Active LTS e versione Maintenance LTS. Usare il comando node --version per controllare la versione in uso.
Una stringa di connessione e una risorsa attiva di Servizi di comunicazione. Creare una risorsa di Servizi di comunicazione.
Uso della libreria dell'interfaccia utente versione 1.17.0 o più recente.
Creare una riunione di Teams e preparare il collegamento alla riunione.
Acquisire familiarità con il funzionamento dell’insieme ChatWithChat.

Background

La chat di interoperabilità di Teams deve prima essere parte di una riunione di Teams. Quando l'utente di Teams crea una conferenza Web, viene creato e associato un thread di chat alla riunione. Per abilitare l'utente finale di Servizi di comunicazione di Azure a partecipare alla chat e iniziare a inviare/ricevere messaggi, un partecipante alla riunione (un utente di Teams) deve prima essere ammesso alla chiamata. In caso contrario, non ha accesso alla chat.

Dopo che l'utente finale di Servizi di comunicazione di Azure è ammesso alla chiamata, potrà iniziare a chattare con altri partecipanti alla chiamata. In questa esercitazione viene mostrato il funzionamento dell'immagine in linea con il testo nella chat di interoperabilità.

Panoramica

Analogamente all’ Aggiunta del supporto delle immagini in linea con il testo alla libreria dell'interfaccia utente è necessario creare un insieme CallWithChat. Di seguito è riportato l'esempio di base della pagina dello storybook per creare un insieme ChatWithChat.

Dal codice di esempio è richiesto CallWithChatExampleProps, definito come nel frammento di codice seguente:

export type CallWithChatExampleProps = {
  // Props needed for the construction of the CallWithChatAdapter
  userId: CommunicationUserIdentifier;
  token: string;
  displayName: string;
  endpointUrl: string;
  locator: TeamsMeetingLinkLocator | TeamsMeetingIdLocator | CallAndChatLocator;

  // Props to customize the CallWithChatComposite experience
  fluentTheme?: PartialTheme | Theme;
  compositeOptions?: CallWithChatCompositeOptions;
  callInvitationURL?: string;
};

Per poter avviare l’insieme ChatWithChat per la chat della riunione, è necessario passare TeamsMeetingLinkLocator o TeamsMeetingIdLocator, che ha un aspetto simile al seguente:

{ "meetingLink": "<TEAMS_MEETING_LINK>" }

{ "meetingId": "<TEAMS_MEETING_ID>", "passcode": "<TEAMS_MEETING_PASSCODE>"}

Non serve altro! Non è necessaria alcuna altra configurazione per consentire a un utente finale di Servizi di comunicazione di Azure di ricevere allegati di file da un utente di Teams.

Autorizzazioni

Quando il file viene condiviso da un client Teams, l'utente di Teams dispone di diverse opzioni per impostare le autorizzazioni per i file nel modo seguente:

"Chiunque"
"Persone dell'organizzazione"
"Persone attualmente in questa chat"
"Persone con accesso esistente"
"Persone scelte"

In particolare, la libreria dell'interfaccia utente attualmente supporta solo "Chiunque" e "Persone scelte" (con indirizzo di posta elettronica); tutte le altre autorizzazioni non sono supportate. Se l'utente di Teams invia un file con autorizzazioni non supportate, all'utente finale di Servizi di comunicazione di Azure viene richiesto di accedere a una pagina di accesso o viene negato l'accesso quando fa clic sull'allegato di file nel thread di chat.

Ritaglio di schermata di un client Teams che elenca le autorizzazioni per i file.

Inoltre, l'amministratore tenant dell'utente di Teams può limitare la condivisione di file,disabilitare alcune autorizzazioni per i file o disabilitare tutte le opzioni di condivisione di file.

Eseguire il codice

Eseguire npm run start per poter accedere all'app di esempio tramite localhost:3000 come mostra il ritaglio di schermata seguente:

Ritaglio di schermata di una libreria dell'interfaccia utente di Servizi di comunicazione di Azure.

Basta fare clic sul pulsante della chat nella parte inferiore per visualizzare il pannello della chat; se l'utente di Teams invia alcuni file, viene visualizzato un ritaglio di schermata simile al seguente:

Ritaglio di schermata di un client Teams che invia un file.