Che cos'è la libreria client JavaScript di Teams?
La piattaforma di sviluppo Teams offre la libreria client JavaScript di Teams come libreria JavaScript per le applicazioni client. La libreria è una raccolta di funzioni JavaScript tramite le quali è possibile usare l'API Teams per integrare funzionalità e funzionalità nelle applicazioni di Teams. Le funzionalità e le funzionalità vengono visualizzate come native del client teams. La libreria garantisce che le applicazioni compilate con essa abbiano un'esperienza coerente e intuitiva per gli utenti di Teams.
In questa unità si apprenderà come usare la libreria in un'applicazione.
Ottenere la libreria nell'app
Verranno ora esaminati i diversi modi in cui è possibile installare la libreria in un'applicazione.
È possibile installare la versione LTS della libreria client JavaScript di Teams usando npm o yarn.
Per installare la libreria usando npm:
npm install --save @microsoft/teams-js
Per installare la libreria usando yarn:
yarn add @microsoft/teams-js
Se si creano app Web senza usare un bundler, è possibile caricare la libreria direttamente dalla rete di distribuzione del contenuto. Aggiungere il frammento di codice seguente all'app Web:
<script src="https://res.cdn.office.net/teams-js/2.7.1/js/MicrosoftTeams.min.js "></script>
Come usare la libreria
La libreria client JavaScript di Teams include API raggruppate logicamente in funzionalità. Queste funzionalità sono spazi dei nomi all'interno della libreria. L'app dello spazio dei nomi di primo livello contiene tutte le API necessarie per l'utilizzo complessivo dell'app.
È possibile inizializzare la libreria usando app.Initialize(). Dopo l'inizializzazione della libreria, è possibile iniziare a usare lo spazio dei nomi per accedere a tutte le API e le funzionalità incluse nella libreria. Per ottenere le informazioni contestuali di base dell'app, effettuare una chiamata a app.getContext(). Per generare e visualizzare un collegamento copiabile alle informazioni che l'utente può condividere, chiamare pages.shareDeepLink().
Per ottenere le informazioni di contesto dell'app, eseguire questo codice:
await app.initialize();
const context = await app.getContext();
Ottenere informazioni di contesto su Microsoft Teams consente all'app Teams di offrire un'esperienza migliore e più personalizzata per gli utenti. Ad esempio, con le informazioni di contesto, l'app può comprendere l'ambiente specifico in cui è in esecuzione, ad esempio in Teams o in un browser, un team o un canale o anche l'utente con cui l'app interagisce. Queste informazioni dettagliate sono utili per determinare come configurare e visualizzare correttamente funzionalità o funzionalità pertinenti e personalizzate per l'utente.
Funzionalità
Le API nell'SDK sono raggruppate logicamente e sono denominate funzionalità. Esempi di funzionalità sono chat, dialoghi e autenticazione. Ogni funzionalità ha i propri spazi dei nomi; ad esempio chat, dialogo o pagina.
Nota
La libreria client JavaScript di Teams versione 2.0.0 e successive consente l'esecuzione delle app Teams in altre app host, ad esempio Outlook e Office.com. Queste funzionalità di estendibilità sono attualmente in anteprima in queste app.
Considera Microsoft Teams come l'host corrente per la tua app. L'host ha alcune funzionalità che possono essere integrate nell'app. Ad esempio, l'app può avviare una nuova chat chiamando la chat.openChat() funzione della funzionalità di chat di Microsoft Teams. Verrà aperta una nuova chat 1:1 con un utente.
È possibile usare la <the-capability>.isSupported() funzione per ogni funzionalità per verificare se la funzionalità è supportata dall'host. Ad esempio, prima di effettuare la chiamata a chat.openChat(), è possibile verificare se la chat è supportata nell'app host in cui è in esecuzione l'app. Per controllare, chiamare la funzione chat.isSupported(). Restituisce true se la chat è supportata e false se la chat non è supportata. Questo controllo consente all'app di eseguire solo le funzionalità supportate nelle app host, in modo che gli utenti abbiano un'esperienza più naturale in ogni host.