Användningsfall för användargränssnittsbibliotek
Använd komponenter och kompositer i Användargränssnittsbiblioteket för Azure Communication Services för att skapa samtals- och chattfunktioner i dina program.
I en sammansatt funktion byggs samtals- och chattfunktioner in direkt och exponeras när du integrerar kompositen i ett program. I en UI-komponent exponeras samtals- och chattfunktioner via en kombination av användargränssnittsfunktioner och underliggande tillståndskänsliga bibliotek. För att dra full nytta av dessa funktioner rekommenderar vi att du använder gränssnittskomponenter med tillståndskänsliga samtals- och chattklientbibliotek.
Få mer konceptuell dokumentation, snabbstarter och exempel i användargränssnittsbibliotekets sagobok.
Användningsfall för samtal
| Ytdiagram | Användningsfall |
|---|---|
| Samtalstyper | Ansluta till ett Microsoft Teams-möte |
| Ansluta till ett Azure Communication Services-anrop med hjälp av ett grupp-ID | |
| Ansluta till ett Azure Communication Services-rum | |
| Starta ett utgående anrop till en annan Azure Communication Services-användare | |
| Starta ett utgående samtal till ett telefonnummer | |
| Teams-samverkan | Gå med i samtalslobbyn |
| Visa en transkriptions- och inspelningsaviseringsbanderoll | |
| Samtalskontroller | Stäng av och slå på ljudet för ett anrop |
| Aktivera och inaktivera video under ett samtal | |
| Aktivera skärmdelning | |
| Avsluta samtal | |
| Deltagargalleri | Visa fjärrdeltagare i ett rutnät |
| Gör videoförhandsgranskning tillgänglig under ett anrop för en lokal användare | |
| Gör standardavatar tillgängliga när videon är avstängd | |
| Visa delat skärminnehåll i deltagargalleriet | |
| Samtalskonfiguration | Hantera mikrofonenheten |
| Hantera kameraenheten | |
| Hantera talarenheten | |
| Gör lokal förhandsversion tillgänglig för användare att kontrollera video | |
| Deltagare | Visa en deltagarlista |
Chattanvändningsfall
| Ytdiagram | Azure Communication Services Chat | Samverkanschatt för Teams |
|---|---|---|
| Chatttyper | Ansluta till en Azure Communication Services-chatttråd | Delta i en Microsoft Teams-möteschatt |
| Chattåtgärder | Skicka och ta emot sms | Skicka och ta emot sms |
| Ta emot RTF-meddelanden | Ta emot RTF-meddelanden | |
| - | Ta emot infogade bilder* | |
| Skicka och ta emot bifogade filer | Ta emot bifogade filer* | |
| Chatthändelser | Indikatorer för att skicka och ta emot skrivningar | Indikatorer för att skicka och ta emot skrivningar** |
| Skicka och ta emot läskvitton | Skicka och ta emot läskvitton | |
| Visa när en deltagare läggs till eller tas bort | Visa när en deltagare läggs till eller tas bort | |
| Deltagare | Visa en deltagarlista | Visa en deltagarlista |
*Stöd för infogade bilder och bifogade filer finns för närvarande i offentlig förhandsversion. Förhandsversions-API:er och SDK:er tillhandahålls utan ett serviceavtal. Vi rekommenderar att du inte använder dem för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds, eller så kan de ha begränsade funktioner. Mer information finns i Kompletterande användningsvillkor för Förhandsversioner av Microsoft Azure.
**Visningsnamnet för att skriva händelse från Teams-användaren kanske inte visas korrekt.
Identiteter som stöds
För att initiera en sammansatt och autentisera till tjänsten måste en användare ha en Azure Communication Services-identitet. Mer information finns i Autentisera till Azure Communication Services och snabbstart: Skapa och hantera åtkomsttoken.
Samverkan mellan team
För Scenarier för Teams-samverkan kan du använda sammansatta gränssnittsbibliotek för att lägga till en användare i ett Teams-möte via Kommunikationstjänster. Om du vill aktivera Teams-samverkan använder du antingen standardfunktionerna i anropets sammansatta eller chattkomposit eller använder gränssnittskomponenter för att skapa en anpassad upplevelse.
När du lägger till både samtal och chatt i ett program är det viktigt att komma ihåg att chattklienten inte kan initieras förrän deltagaren har antagits till samtalet. När deltagaren har antagits kan chattklienten initieras för att ansluta till möteschatttråden. Mönstret visas i följande bild:
Om du använder gränssnittskomponenter för att leverera Teams-samverkansupplevelser börjar du med att använda UI-biblioteksexempel för att skapa viktiga delar av upplevelsen:
- Lobbyexempel. En exempellobby där en deltagare kan vänta med att bli antagen till ett samtal.
- Efterlevnadsbanderoll. En exempelbanderoll som visar användaren om anropet spelas in.
- Teams-tema. Ett exempeltema som får gränssnittsbibliotekselement att se ut som Microsoft Teams.
- Bilddelning*. Ett exempel på Azure Communication Service-slutanvändare kan ta emot bilder som skickas av Teams-användaren.
- Fildelning*. Ett exempel på azure communication service-slutanvändare kan ta emot bifogade filer som skickas av Teams-användaren.
Anpassning
Använd UI-biblioteksmönster för att ändra komponenter så att de matchar programmets utseende och känsla. Anpassning är en viktig skillnad mellan sammansatta komponenter och gränssnittskomponenter i Communication Services. Sammansatta objekt har färre anpassningsalternativ för en enklare integreringsupplevelse.
I följande tabell jämförs sammansatta komponenter och gränssnittskomponenter för anpassningsanvändningsfall:
| Användningsfall | Kompositer | UI-komponenter |
|---|---|---|
| Använda Fluent-baserad teman | X | X |
| Skapa upplevelselayouten | X | |
| Använda CSS-formatmall för att ändra formategenskaper | X | |
| Ersätt ikoner | X | |
| Ändra layouten för deltagargalleriet | X | |
| Ändra layouten för anropskontroll | X | X |
| Mata in datamodeller för att ändra användarmetadata | X | X |
Överskådlighet
Tillståndshanteringsarkitekturen för användargränssnittsbiblioteket är frikopplad, så du kan komma åt tillståndskänsliga samtals- och chattklienter direkt. Du kan ansluta till den tillståndskänsliga klienten för att läsa tillstånd, hantera händelser och åsidosätt beteende för att överföra till gränssnittskomponenterna.
I följande tabell jämförs sammansatta komponenter och gränssnittskomponenter för användningsfall med observerbarhet:
| Användningsfall | Kompositer | UI-komponenter |
|---|---|---|
| Åtkomst till samtals- och chattklienttillstånd | X | X |
| Komma åt och hantera klienthändelser | X | X |
| Komma åt och hantera användargränssnittshändelser | X | X |
Rekommenderad arkitektur
Initiera en sammansatt komponent och baskomponent med hjälp av en Åtkomsttoken för Azure Communication Services. Det är viktigt att få åtkomsttoken från Communication Services via en betrodd tjänst som du hanterar. Mer information finns i Snabbstart: Skapa och hantera åtkomsttoken och självstudien om betrodda tjänster.
Samtals- och chattklientbibliotek måste ha kontexten för samtalet eller chatten som de ansluter till. Precis som med användaråtkomsttoken sprider du kontexten till klienter med hjälp av din egen betrodda tjänst.
I följande tabell sammanfattas initierings- och resurshanteringsfunktioner som krävs för att lägga till kontext i ett klientbibliotek:
| Contosos ansvarsområden | Ansvarsområden för användargränssnittsbibliotek |
|---|---|
| Ange en åtkomsttoken från Azure | Gå igenom den angivna åtkomsttoken för att initiera komponenter |
| Ange en uppdateringsfunktion | Uppdatera åtkomsttoken med hjälp av en funktion som tillhandahålls av utvecklare |
| Hämta och skicka anslutningsinformation för samtalet eller chatten | Skicka samtals- och chattinformation för att initiera komponenter |
| Hämta och skicka användarinformation för alla anpassade datamodeller | Skicka en anpassad datamodell till komponenter som ska återges |
Plattformssupport
| SDK | Windows | macOS | Ubuntu | Linux | Android | iOS |
|---|---|---|---|---|---|---|
| UI SDK | Chrome*, Microsoft Edge | Chrome*, Safari** | Chrome* | Chrome* | Chrome* | Safari** |
* Den aktuella versionen av Chrome och de två föregående versionerna stöds.
** Safari version 13.1 och senare versioner stöds. Utgående video för Safari macOS stöds ännu inte, men den stöds för iOS. Utgående skärmdelning stöds endast på skrivbords-iOS.
Tillgänglighet
Tillgänglighet efter design är en princip för Microsoft-produkter. Användargränssnittsbiblioteket följer den här principen och alla gränssnittskomponenter är helt tillgängliga.
Lokalisering
Lokalisering är nyckeln till att göra produkter för användare runt om i världen och som talar olika språk. Användargränssnittsbiblioteket ger standardstöd för vissa språk och funktioner, inklusive höger-till-vänster-språk. Du kan ange egna lokaliseringsfiler som ska användas med användargränssnittsbiblioteket.
Kända problem
- Användargränssnittsbiblioteket stöder inte uppdatering av meddelandetyp när befintliga meddelanden redigeras just nu. Om du lägger till RTF-formatering i ett befintligt meddelande läggs html-formatering till textinnehållet. Eftersom detta inte ändrar meddelandetypen kan det leda till att html-innehåll visas som oformaterad text i meddelandetråden.
CallComposite Använd och ChatComposite i Azure Communication Services-användargränssnittsbiblioteket för att skapa samtalsupplevelser i dina iOS- och Android-program. Genom att använda några rader kod kan du enkelt integrera en hel samtals- och chattupplevelse i ditt program. Sammansatta objekt i Communication Services hanterar hela livscykeln för samtalet och chatten, från konfigurationen tills samtalet och chatten avslutas.
Samtalsanvändningsfall
Du kan använda anropet sammansatt i Communication Services för att skapa dessa användningsfall:
| Ytdiagram | Användningsfall |
|---|---|
| Samtalstyper | Ansluta till ett Microsoft Teams-möte |
| Anslut ett samtal med hjälp av ett grupp-ID | |
| Teams-samverkan | Gå med i samtalslobbyn |
| Visa en transkriptions- och inspelningsaviseringsbanderoll | |
| Deltagargalleri | Visa fjärrdeltagare i ett rutnät |
| Gör videoförhandsgranskning tillgänglig under ett anrop för en lokal användare | |
| Gör standardavatar tillgängliga när videon är avstängd | |
| Visa delat skärminnehåll i deltagargalleriet | |
| Aktivera anpassning av deltagaravatar | |
| Visa en deltagarlista | |
| Samtalskonfiguration | Hantera mikrofonenheten |
| Hantera kameraenheten | |
| Hantera talarenheten (kabelansluten eller Bluetooth) | |
| Gör lokal förhandsversion tillgänglig för en användare för att kontrollera video | |
| Samtalskontroller | Stäng av och slå på ljudet för ett anrop |
| Aktivera eller inaktivera video under ett samtal | |
| Avsluta samtal | |
| Pausa och återuppta ett samtal efter ljudavbrott |
Samverkan mellan team
För Scenarier för Teams-samverkan kan du använda sammansatta gränssnittsbibliotek för att lägga till en användare i ett Teams-möte via Kommunikationstjänster. Om du vill aktivera Teams-samverkan använder du anropets sammansatta. Den sammansatta hanterar hela livscykeln för att ansluta till ett Teams-samverkansanrop.
Följande bild visar ett exempel på användarupplevelsen innan en anropare läggs till i ett Teams-möte:
Visa delat innehåll
Via användargränssnittsbiblioteket för mobila inbyggda plattformar kan samtalsdeltagare visa delat innehåll när andra deltagare delar sina skärmar under ett Teams-samtal. En fjärrdeltagare kan använda stretch- och nypgester för att zooma in eller ut på det delade innehållet i samtalet.
Teman
Du kan använda UI Library-anropet sammansatt för iOS och Android för att skapa ett anpassat tema för en uppringare. För att skapa plattformsupplevelsen skickar du en uppsättning temafärger som visas i följande tabell. Mer information finns i Så här skapar du ditt tema.
| Android | iOS |
|---|---|
|
|
Skärmstorlek
Du kan anpassa Azure Communication Services-anropet sammansatt för att anpassa till skärmstorlekar från 5 tum till surfplattans storlek. Använd delningsläge och surfplattläge i anropskompositen för att få layouten för de dynamiska deltagarnas deltagarlista, ge klarhet i vyn och fokusera på konversationen.
| Delningsläge | Surfplattläge |
|---|---|
|
|
Lokalisering
Lokalisering är nyckeln till att göra produkter för användare runt om i världen och som talar olika språk. UI-biblioteket stöder 12 språk: engelska, spanska, franska, tyska, italienska, japanska, koreanska, nederländska, portugisiska, ryska, turkiska och kinesiska. Den stöder även höger-till-vänster-språk. Mer information finns i Lägga till lokalisering i din app.
Tillgänglighet
Hjälpmedel är ett viktigt fokus för samtalsbiblioteken. Du kan använda en skärmläsare för att göra viktiga meddelanden om samtalsstatus och för att säkerställa att användare med nedsatt syn kan delta effektivt när de använder programmet.
Visa datainmatning
Använd användargränssnittsbiblioteket för mobila interna plattformar för att ge lokala och fjärranslutna deltagare möjlighet att anpassa hur de visas som användare i ett samtal. En lokal deltagare kan välja en lokal avatar, anpassat visningsnamn, navigeringens rubrik och underrubrik på installationsskärmen när ett samtal börjar. En fjärranvändare kan skapa en anpassad avatar när de ansluter till mötet. Mer information finns i Anpassa vyn före mötet.
Hoppa över installationsskärmen
Användargränssnittsbiblioteket ger möjlighet att ansluta till ett samtal som hoppar över installationsskärmen för samtalsanslutningsupplevelsen. Som standard går användaren igenom en konfigurationsskärm för att ansluta till ett anrop. Här ställer användaren in samtalskonfigurationen, till exempel kameran slås på eller av, mikrofonen slås på eller av och val av ljudenhet innan du ansluter ett samtal. Den här skärmen kräver användarinteraktion för att ansluta till ett anrop, vilket kan vara onödigt för vissa användare. Därför ger vi möjlighet att ansluta till ett anrop genom att hoppa över installationsskärmen och tillhandahålla API:er för samtalskonfiguration. Mer information finns i Så här använder du funktionen Hoppa över konfigurationsskärmen
Endast ljudläge
Med läget Endast ljud i användargränssnittsbiblioteket kan deltagarna bara ansluta samtal med sitt ljud, utan att dela eller ta emot video. Den här funktionen används för att spara bandbredd och maximera sekretessen. När det aktiveras inaktiverar läget endast ljud automatiskt videofunktionerna för både sändning och mottagning av strömmar och justerar användargränssnittet så att det återspeglar den här ändringen genom att ta bort videorelaterade kontroller. Det här läget kan aktiveras via CallComposite-konfigurationen, mer information tillgänglig via snabbstarten Endast ljud
Orientering
Användargränssnittsbiblioteket stöder skärmorienteringskonfiguration för var och en av skärmen separat innan du startar biblioteksupplevelsen. Detta gör det möjligt för programutvecklare att konfigurera en fast orientering för anropsupplevelsen som skulle justera deras programorientering. Mer information om listan över orientering som stöds för både Android- och iOS-plattformen och användningen av API :et finns i Använda orienteringsfunktionen
Multitasking och Picture-in-Picture
Användargränssnittsbiblioteket stöder bild i bildläge för samtalsskärmen. När användaren är i samtalet kan användaren klicka tillbaka på samtalsskärmen för att aktivera multitasking, vilket tar användaren tillbaka till föregående skärm. Om Picture-in-Picture är aktiverat visas systemet Picture-in-Picture för anrop. Mer information om multitasking och Picture-in-Picture för både Android- och iOS-plattformen och användningen av API:et finns i Så här använder du Picture-in-Picture
CallKit-support
UI-biblioteket stöder CallKit-integrering för att hantera interaktion med CallKit för samtal. Mer information om integrering för iOS-plattform och användning av API :et finns i Använda CallKit
Stöd för ett-till-en-samtal och PUSH-meddelanden
UI-biblioteket stöder ett-till-ett VoIP-samtal för att ringa användare via kommunikationsidentifierare. Om du vill ta emot inkommande samtalsgränssnittsbibliotek har du även stöd för registrering för PUSH-meddelanden. Mer information om integrering för Android- och iOS-plattformen och användningen av API :et finns i Så här gör du ett-till-en-anrop och tar emot PUSH-meddelanden
Chattanvändningsfall
Viktigt!
Den här funktionen i Azure Communication Services är för närvarande i förhandsversion.
Förhandsversions-API:er och SDK:er tillhandahålls utan ett serviceavtal. Vi rekommenderar att du inte använder dem för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds, eller så kan de ha begränsade funktioner.
Mer information finns i Kompletterande användningsvillkor för Förhandsversioner av Microsoft Azure.
| Ytdiagram | Användningsfall |
|---|---|
| Chatttyper | Ansluta till en Azure Communication Services-chatttråd |
| Chattåtgärder | Skicka ett chattmeddelande |
| Ta emot ett chattmeddelande | |
| Chatthändelser | Visa inmatningsindikatorer |
| Visa ett läskvitto | |
| Visa när en deltagare läggs till eller tas bort | |
| Visa ändringar i chatttiteln |
Flexibilitet
Har ChatComposite utformats för att passa in i olika layouter och vyer i ditt program. Du kan till exempel välja att placera Chatt i en navigeringsvy, en modal vy eller någon annan vy. Skulle ChatComposite justera sig själv och se till att användaren har en sömlös upplevelse.
| I navigeringsvyn | I modal vy |
|---|---|
|
|
Identiteter som stöds
För att initiera en sammansatt och autentisera till tjänsten måste en användare ha en Azure Communication Services-identitet. Mer information finns i Autentisera till Azure Communication Services och snabbstart: Skapa och hantera åtkomsttoken.
Rekommenderad arkitektur
Initiera en sammansatt med hjälp av en Åtkomsttoken för Azure Communication Services. Det är viktigt att få åtkomsttoken från Azure Communication Services via en betrodd tjänst som du hanterar. Mer information finns i Snabbstart: Skapa och hantera åtkomsttoken och självstudien om betrodda tjänster.
Samtals- och chattklientbibliotek måste ha kontexten för samtalet de ansluter till. Precis som med användaråtkomsttoken sprider du kontexten till klienter med hjälp av din egen betrodda tjänst. I följande tabell sammanfattas de initierings- och resurshanteringsfunktioner som krävs för att lägga till kontext i ett klientbibliotek:
| Contosos ansvarsområden | Ansvarsområden för användargränssnittsbibliotek |
|---|---|
| Ange en åtkomsttoken från Azure | Gå igenom den angivna åtkomsttoken för att initiera komponenter |
| Ange en uppdateringsfunktion | Uppdatera åtkomsttoken med hjälp av en funktion som tillhandahålls av utvecklare |
| Hämta och skicka anslutningsinformation för samtalet eller chatten | Skicka samtals- och chattinformation för att initiera komponenter |
| Hämta och skicka användarinformation för alla anpassade datamodeller | Skicka en anpassad datamodell till komponenter som ska återges |
Plattformssupport
| Plattform | Versioner |
|---|---|
| iOS | iOS 14 och senare |
| Android | API 21 och senare |
Felsökningsguide
När felsökning sker för röst- eller videosamtal kan du bli ombedd att ange ett CallID. Det här ID:t används för att identifiera Communication Services-samtal.
Detta CallID kan hämtas via åtgärdsfältet längst ned på samtalsskärmen. du ser en ellipsknapp; När användaren utför tryckåtgärden kan du välja "Dela diagnostikinformation". Användaren kan dela diagnostikinformationen som krävs för att spåra eventuella problem från supportteamet.
Programmatisk åtkomst till CallID finns i "Så här hämtar du felsökningsinformation programmatiskt".
Du kan lära dig mer om felsökningsriktlinjer här: sidan "Felsökning i Azure Communication Services" .
| Samtalsskärm | Menyn Diagnostikinformation | Dela CallID |
|---|---|---|
|
|
|