Use cases voor ui-bibliotheek
Gebruik onderdelen en samengestelde onderdelen in de UI-bibliotheek van Azure Communication Services om gespreks- en chatervaringen in uw toepassingen te maken.
In een samengestelde functie worden gespreks- en chatmogelijkheden direct ingebouwd en weergegeven wanneer u het samengestelde in een toepassing integreert. In een UI-onderdeel worden gespreks- en chatmogelijkheden weergegeven via een combinatie van UI-functionaliteit en onderliggende stateful bibliotheken. Als u optimaal gebruik wilt maken van deze mogelijkheden, raden we u aan ui-onderdelen te gebruiken met stateful gespreks- en chatclientbibliotheken.
Krijg meer conceptuele documentatie, quickstarts en voorbeelden in het artikelboek ui-bibliotheek.
Gebruiksvoorbeelden voor oproepen
| Gebied | Gebruiksgevallen |
|---|---|
| Oproeptypen | Neem deel aan een Microsoft Teams-vergadering. |
| Neem deel aan een Azure Communication Services-aanroep met behulp van een groeps-id. | |
| Neem deel aan een Azure Communication Services-ruimte. | |
| Start een uitgaande aanroep naar een andere Azure Communication Services-gebruiker. | |
| Een uitgaande oproep naar een telefoonnummer starten. | |
| Teams-interoperabiliteit | Neem deel aan de oproeplobby. |
| Een transcriptie weergeven en een waarschuwingsbanner opnemen. | |
| Besturingselementen voor oproepen | Een oproep dempen en het dempen opheffen. |
| Video in- en uitschakelen tijdens een gesprek. | |
| Scherm delen inschakelen. | |
| Een gesprek beëindigen. | |
| Galerie deelnemers | Externe deelnemers op een raster weergeven. |
| Videovoorbeeld beschikbaar maken tijdens een gesprek voor een lokale gebruiker. | |
| Standaard avatars beschikbaar maken wanneer video is uitgeschakeld. | |
| Gedeelde scherminhoud weergeven in de galerie met deelnemers. | |
| Oproepconfiguratie | Beheer het microfoonapparaat. |
| Beheer het cameraapparaat. | |
| Beheer het luidsprekerapparaat. | |
| Lokale preview beschikbaar maken voor gebruikers om de video te controleren. | |
| Deelnemers | Een deelnemersrooster weergeven. |
Use cases voor chatten
| Gebied | Azure Communication Services-chat | Teams-interoperabiliteitschat |
|---|---|---|
| Chattypen | Neem deel aan een Chat-thread van Azure Communication Services. | Neem deel aan een chatsessie in een Microsoft Teams-vergadering. |
| Chatacties | SMS-berichten verzenden en ontvangen. | SMS-berichten verzenden en ontvangen. |
| Berichten met tekst met opmaak verzenden en ontvangen.* | Berichten met tekst met opmaak verzenden en ontvangen.* | |
| - | Inlineafbeeldingen ontvangen. | |
| Bestandsbijlagen verzenden en ontvangen. | Bestandsbijlagen ontvangen.* | |
| Chatgebeurtenissen | Typindicatoren verzenden en ontvangen. | Indicatoren voor typen verzenden en ontvangen.** |
| Leesbevestigingen verzenden en ontvangen. | Leesbevestigingen verzenden en ontvangen. | |
| Weergeven wanneer een deelnemer wordt toegevoegd of verwijderd. | Weergeven wanneer een deelnemer wordt toegevoegd of verwijderd. | |
| Deelnemers | Een deelnemersrooster weergeven. | Een deelnemersrooster weergeven. |
*Ondersteuning voor tekst met opmaak en bestandsbijlagen verzenden is momenteel beschikbaar als openbare preview. Preview-API's en SDK's worden aangeboden zonder een service level agreement. U wordt aangeraden deze niet te gebruiken voor productieworkloads. Sommige functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Raadpleeg aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews voor meer informatie.
**De weergavenaam van de type-gebeurtenis van de Teams-gebruiker wordt mogelijk niet goed weergegeven.
Ondersteunde identiteiten
Als u een samengestelde en verificatie voor de service wilt initialiseren, moet een gebruiker een Azure Communication Services-identiteit hebben. Zie Verifiëren bij Azure Communication Services en quickstart: Toegangstokens maken en beheren voor meer informatie.
Interoperabiliteit met Teams
Voor interoperabiliteitsscenario's voor Teams kunt u UI Library-samengestelde elementen gebruiken om een gebruiker toe te voegen aan een Teams-vergadering via Azure Communication Services. Als u teams-interoperabiliteit wilt inschakelen, gebruikt u de standaardfuncties in het gesprek samengesteld of de chatcomposiet. U kunt ook UI-onderdelen gebruiken om een aangepaste ervaring te bouwen.
Wanneer u zowel bellen als chatten aan een toepassing toevoegt, moet u er rekening mee houden dat de chatclient pas kan worden geïnitialiseerd nadat de deelnemer is toegelaten tot het gesprek. Nadat de deelnemer is toegelaten, kunt u de chatclient initialiseren om deel te nemen aan de chat-thread van de vergadering. Het patroon wordt gedemonstreerd in de volgende afbeelding.
Als u UI-onderdelen gebruikt om interoperabiliteitservaringen voor Teams te leveren, gebruikt u voorbeelden van ui-bibliotheken om belangrijke onderdelen van de ervaring te maken:
- Lobbyvoorbeeld: Een voorbeeldlobby waarin een deelnemer kan wachten totdat deze wordt toegelaten tot een gesprek.
- Compliancebanner: een voorbeeldbanner waarin de gebruiker wordt weergegeven als de aanroep wordt opgenomen.
- Teams-thema: Een voorbeeldthema waarmee UI-bibliotheekelementen eruitzien als Microsoft Teams.
- Afbeelding delen*: een voorbeeld dat laat zien hoe een Azure Communication Services-gebruiker afbeeldingen kan ontvangen die door de Teams-gebruiker worden verzonden.
- Bestandsdeling*: een voorbeeld dat laat zien hoe een Azure Communication Services-gebruiker bestandsbijlagen kan ontvangen die zijn verzonden door de Teams-gebruiker.
Aanpassing
Gebruik UI-bibliotheekpatronen om onderdelen te wijzigen zodat deze overeenkomen met het uiterlijk van uw toepassing. Aanpassing is een belangrijk verschil tussen samengestelde onderdelen en UI-onderdelen in Azure Communication Services. Samengestelde producten hebben minder aanpassingsopties voor een eenvoudigere integratie-ervaring.
In de volgende tabel worden samengestelde en UI-onderdelen vergeleken voor gebruiksvoorbeelden voor aanpassing.
| Gebruiksscenario | Composieten | UI-onderdelen |
|---|---|---|
| Gebruik Fluent-thema's. | X | X |
| De indeling van de ervaring opstellen. | X | |
| Gebruik CSS-stijl om stijleigenschappen te wijzigen. | X | |
| Pictogrammen vervangen. | X | |
| Wijzig de indeling van de galerie van deelnemers. | X | |
| Wijzig de indeling van het gespreksbeheer. | X | X |
| Gegevensmodellen injecteren om metagegevens van gebruikers te wijzigen. | X | X |
Waarneembaarheid
De statusbeheerarchitectuur van de UI-bibliotheek is ontkoppeld, zodat u rechtstreeks toegang hebt tot stateful oproepen en chatclients. Koppel de stateful client aan om de status te lezen, gebeurtenissen te verwerken en gedrag te overschrijven om door te geven aan de ui-onderdelen.
In de volgende tabel worden samengestelde en UI-onderdelen vergeleken voor gebruiksvoorbeelden voor waarneembaarheid.
| Gebruiksscenario | Composieten | UI-onderdelen |
|---|---|---|
| Toegang tot gespreks- en chatclientstatus. | X | X |
| Client-gebeurtenissen openen en afhandelen. | X | X |
| Ui-gebeurtenissen openen en afhandelen. | X | X |
Aanbevolen architectuur
Initialiseer een samengesteld en basisonderdeel met behulp van een Azure Communication Services-toegangstoken. Het is belangrijk om toegangstokens van Azure Communication Services op te halen via een vertrouwde service die u beheert. Zie quickstart: Toegangstokens en de zelfstudie over vertrouwde services maken en beheren voor meer informatie.
Gespreks- en chatclientbibliotheken moeten de context hebben voor het gesprek of de chat waaraan ze deelnemen. Verspreid de context naar klanten met behulp van uw eigen vertrouwde service. Gebruik bijvoorbeeld tokens voor gebruikerstoegang.
De volgende tabel bevat een overzicht van initialisatie- en resourcebeheerfuncties die nodig zijn om context toe te voegen aan een clientbibliotheek.
| Contoso-verantwoordelijkheden | Verantwoordelijkheden van ui-bibliotheek |
|---|---|
| Geef een toegangstoken op vanuit Azure. | Geef het opgegeven toegangstoken door om onderdelen te initialiseren. |
| Geef een vernieuwingsfunctie op. | Vernieuw het toegangstoken met behulp van een door de ontwikkelaar geleverde functie. |
| Informatie over deelname ophalen en doorgeven voor het gesprek of de chat. | Geef gespreks- en chatgegevens door om onderdelen te initialiseren. |
| Gebruikersgegevens ophalen en doorgeven voor een aangepast gegevensmodel. | Geef een aangepast gegevensmodel door aan onderdelen die moeten worden weergegeven. |
Platformondersteuning
| SDK | Windows | macOS | Ubuntu | Linux | Android | iOS |
|---|---|---|---|---|---|---|
| UI SDK | Chrome,* Microsoft Edge | Chrome,* Safari** | Chrome* | Chrome* | Chrome* | Safari** |
*De huidige versie van Chrome en de twee voorgaande versies worden ondersteund.
**Safari versie 13.1 en nieuwere versies worden ondersteund. Uitgaande video voor Safari macOS wordt nog niet ondersteund, maar wordt wel ondersteund voor iOS. Uitgaand scherm delen wordt alleen ondersteund op desktop-iOS.
Toegankelijkheid
Toegankelijkheid per ontwerp is een principe voor Microsoft-producten. Ui-bibliotheek volgt dit principe en alle UI-onderdelen zijn volledig toegankelijk.
Lokalisatie
Lokalisatie is essentieel voor het maken van producten voor gebruikers over de hele wereld die verschillende talen spreken. Ui-bibliotheek biedt standaardondersteuning voor sommige talen en mogelijkheden. Deze ondersteuning omvat talen die van rechts naar links worden geschreven. U kunt hun eigen lokalisatiebestanden opgeven voor gebruik met ui-bibliotheek.
Bekende problemen
Ui-bibliotheek biedt geen ondersteuning voor het bijwerken van het berichttype bij het bewerken van bestaande berichten op dit moment. Door opmaak met opmaak toe te voegen aan een bestaand bericht, wordt HTML-stijl toegevoegd aan de tekstinhoud. Omdat het berichttype niet wordt gewijzigd, kan het resultaat HTML-inhoud zijn die als tekst zonder opmaak wordt weergegeven in de berichtenthread.
Ga naar het artikelboek van de UI-bibliotheek.
Gebruik CallComposite en in de ChatComposite UI-bibliotheek van Azure Communication Services om oproepervaringen te maken in uw iOS- en Android-toepassingen. Met behulp van een paar regels code kunt u eenvoudig een volledige gespreks- en chatervaring in uw toepassing integreren. Samengestelde functies in Azure Communication Services beheren de volledige levenscyclus van het gesprek en de chat, van de installatie tot het einde van het gesprek en de chat.
Gebruiksvoorbeelden voor bellen
Gebruik de aanroep samengesteld in Azure Communication Services om deze use cases te maken.
| Gebied | Gebruiksgevallen |
|---|---|
| Oproeptypen | Neem deel aan een Microsoft Teams-vergadering. |
| Neem deel aan een Microsoft Teams-vergadering met behulp van een vergaderings-id en wachtwoordcode. | |
| Neem deel aan een oproep met behulp van een groeps-id. | |
| Neem deel aan een gesprek met behulp van een kamer-id. | |
| 1:1 gesprekken voeren en ontvangen. | |
| Teams-interoperabiliteit | Neem deel aan de oproeplobby. |
| Een transcriptie weergeven en een waarschuwingsbanner opnemen. | |
| Geef lobbydeelnemers toe of negeer ze. | |
| Ondertiteling | Teams-interoperabiliteit. |
| Groepsgesprek, bellen in ruimten en 1:1 gesprek. | |
| Galerie deelnemers | Externe deelnemers op een raster weergeven. |
| Videovoorbeeld beschikbaar maken tijdens een gesprek voor een lokale gebruiker. | |
| Standaard avatars beschikbaar maken wanneer video is uitgeschakeld. | |
| Gedeelde scherminhoud weergeven in de galerie met deelnemers. | |
| Aanpassing van avatar van deelnemers inschakelen. | |
| Een deelnemersrooster weergeven. | |
| Gespreksbeheer | Beheer het microfoonapparaat. |
| Beheer het cameraapparaat. | |
| Het luidsprekerapparaat beheren (bekabeld of Bluetooth). | |
| Lokale preview beschikbaar maken voor een gebruiker om de video te controleren. | |
| Abonneren op gebeurtenissen. | |
| Besturingselementen voor oproepen | Een oproep dempen en het dempen opheffen. |
| Video in- of uitschakelen tijdens een gesprek. | |
| Een gesprek beëindigen. | |
| Wacht en hervat een gesprek na audioonderbreking. | |
| CallKit- en TelecomManager-ondersteuning. | |
| De ervaring aanpassen | Aanpassing van knopbalk. |
| Titel- en subtitelconfiguratie. | |
| Schakel het bevestigingsdialoogvenster voor het beëindigen van oproepen in. | |
| Het installatiescherm overslaan. |
Gespreksintegratie
In deze sectie wordt de integratie voor aanroepen besproken.
Interoperabiliteit met Teams
Voor interoperabiliteitsscenario's voor Teams kunt u UI Library-samengestelde elementen gebruiken om een gebruiker toe te voegen aan een Teams-vergadering via Azure Communication Services. Als u teams-interoperabiliteit wilt inschakelen, gebruikt u de samengestelde aanroep. Het samengestelde beheert de volledige levenscyclus van het deelnemen aan een teams-interoperabiliteitsgesprek.
In de volgende afbeelding ziet u een voorbeeld van de gebruikerservaring voordat een beller wordt toegevoegd aan een Teams-vergadering.
Integratie van ruimten
Azure Communication Services biedt een concept van een ruimte voor ontwikkelaars die gestructureerde gesprekken bouwen, zoals virtuele afspraken of virtuele gebeurtenissen. Ruimten staan momenteel spraak- en videogesprekken toe.
Een ruimte is een container waarmee activiteiten worden beheerd tussen Azure Communication Services-gebruikers. Een ruimte biedt ontwikkelaars van toepassingen betere controle over wie kan deelnemen aan een gesprek, wanneer ze vergaderen en hoe ze samenwerken. Zie de conceptuele documentatie voor meer informatie over ruimten.
Een gebruiker wordt uitgenodigd voor een ruimte met behulp van de Rooms-API in een van de drie volgende rollen:
- Presentator (standaard)
- Deelnemer
- Consument
Het onderscheid tussen elke rol ligt in de mogelijkheden die ze bezitten tijdens een ruimtegesprek wanneer CallComposite deze wordt gebruikt. De specifieke mogelijkheden die aan elke rol zijn gekoppeld, worden beschreven in het overzicht van virtuele ruimten.
Notitie
De Rooms-API is bedoeld voor het maken van ruimten, het beheren van gebruikers en het aanpassen van de levensduur van ruimten. De Rooms-API is een back-endservice die losstaat van de UI-bibliotheek.
Ondersteuning voor één-op-een-oproep en PUSH-melding
Ui-bibliotheek ondersteunt een-op-een VoIP-aanroepen om gebruikers te bellen op communicatie-id. Als u een inkomende oproep wilt ontvangen, ondersteunt de UI-bibliotheek ook het registreren voor PUSH meldingen. Zie Een een-op-een-aanroep maken en PUSH-meldingen ontvangen voor meer informatie over de integratie voor Android- en iOS-platforms en het gebruik van de API.
Oproepfuncties
Er zijn verschillende functies beschikbaar om te bellen.
Toegankelijkheid
Toegankelijkheid is een belangrijke focus van de gespreksbibliotheken. Gebruik een schermlezer om belangrijke aankondigingen te doen over de oproepstatus en om ervoor te zorgen dat slechtziende gebruikers effectief kunnen deelnemen wanneer ze de toepassing gebruiken.
Ondertiteling
Ondertiteling maakt een breed scala aan scenario's mogelijk, waaronder interoperabiliteit met Teams, Azure Communication Services-groepsgesprekken, ruimtegesprekken en een-op-een-oproepen. Deze functie zorgt ervoor dat gebruikers samen met gesprekken in verschillende belomgevingen kunnen volgen, waardoor de toegankelijkheid en gebruikerservaring worden verbeterd.
Gebruikers moeten handmatig de taal voor bijschriften selecteren met behulp van de UI-bibliotheek, omdat het systeem de gesproken taal niet automatisch detecteert.
Zie de documentatie voor uitleg en gebruiksrichtlijnen voor meer informatie over ondertiteling. Als u ondertiteling rechtstreeks in de UI-bibliotheek wilt configureren, volgt u de zelfstudie voor een eenvoudige installatie.
gebeurtenis
Ontwikkelaars kunnen zich nu abonneren op gebeurtenissen binnen de CallComposite eigenschap. Met deze functie kunnen ze listeners koppelen aan specifieke gebeurtenissen gedurende de levenscyclus van de oproep. Deze verbetering biedt meer controle- en aanpassingsmogelijkheden. Ontwikkelaars kunnen aangepaste acties activeren op basis van gebeurtenissen zoals deelnemen aan deelnemers of deelnemers die het gesprek hebben verlaten. Ze kunnen ook gebeurtenissen gebruiken voor logboekregistratieinteracties, dynamisch bijwerken van gebruikersinterfaces of het verbeteren van de algehele functionaliteit.
Zie Gebeurtenissen verwerken in de UI-bibliotheek voor meer informatie.
Lokalisatie
Lokalisatie is essentieel voor het maken van producten voor gebruikers over de hele wereld die verschillende talen spreken. UI Library ondersteunt 12 talen: Engels, Spaans, Frans, Duits, Italiaans, Japans, Koreaans, Nederlands, Portugees, Russisch, Turks en Chinees. Het biedt ook ondersteuning voor talen die van rechts naar links worden geschreven. Zie Lokalisatie toevoegen aan uw app voor meer informatie.
Multitasking en afbeelding-in-picture-modus
Ui-bibliotheek ondersteunt de modus afbeelding in afbeelding voor het gespreksscherm. Tijdens een gesprek kunnen gebruikers de knop Terug in het gespreksscherm selecteren om multitasking in te schakelen om ze terug te brengen naar het vorige scherm. Als de afbeeldingsmodus in beeld is ingeschakeld, wordt er een systeemafbeelding-in-afbeelding weergegeven voor de aanroep. Zie Afbeeldings-in-afbeeldingsbibliotheek inschakelen voor meer informatie over multitasking en de afbeeldingsmodus voor zowel de Android- als iOS-platformen en het gebruik van de API.
Schermstand
Ui-bibliotheek biedt ondersteuning voor het instellen van de schermstand voor elk van de schermen afzonderlijk voordat de bibliotheek wordt gestart. Toepassingsontwikkelaars kunnen een vaste afdrukstand instellen voor de aanroepende ervaring, waarmee de toepassingsstand wordt uitgelijnd. Zie Schermstand instellen met behulp van ui-bibliotheek voor meer informatie over de lijst met ondersteunde afdrukstanden voor zowel de Android- als iOS-platformen en het gebruik van de API.
Schermgrootte
Pas de aanroep van Azure Communication Services aan om zich aan te passen aan schermgrootten van vijf inch tot tabletgrootte. Gebruik de splitsmodus en tabletmodus in het samengestelde gesprek om de indeling van het dynamische deelnemersrooster te krijgen, de weergave duidelijk te maken en de focus op het gesprek te richten.
| Splitsmodus | Tabletmodus |
|---|---|
|
|
Gegevensinjectie weergeven
Gebruik ui-bibliotheek voor mobiele systeemeigen platforms om lokale en externe deelnemers de optie te geven om aan te passen hoe ze worden weergegeven als gebruikers in een gesprek. Een lokale deelnemer kan een lokale avatar, aangepaste weergavenaam en de titel en subtitel van de navigatie in het installatiescherm kiezen wanneer een oproep begint. Een externe gebruiker kan een aangepaste avatar maken wanneer deze deelneemt aan de vergadering. Zie Een aangepast gegevensmodel injecteren in de UI-bibliotheek voor meer informatie.
Gedeelde inhoud weergeven
Via ui-bibliotheek voor mobiele systeemeigen platforms kunnen gespreksdeelnemers gedeelde inhoud bekijken wanneer andere deelnemers hun schermen delen tijdens een Teams-gesprek. Een externe deelnemer kan stretch- en knijpbewegingen gebruiken om in of uit te zoomen op de gedeelde inhoud in het gesprek.
Besturingssysteemintegraties
Integreer met uw besturingssysteem.
CallKit-ondersteuning
UI-bibliotheek ondersteunt CallKit integratie voor het afhandelen van interactie met CallKit aanroepen. Zie CallKit integreren in ui-bibliotheek voor meer informatie over de integratie voor het iOS-platform en het gebruik van de API.
TelecomManager-ondersteuning
Ui-bibliotheek biedt nu ondersteuning voor integratie met TelecomManager en biedt de mogelijkheid voor het verwerken van oproepwacht- en cv-functies. Zie TelecomManager integreren in ui-bibliotheek voor meer informatie over de integratie voor het Android-platform en het gebruik van de API.
De gesprekservaring aanpassen
U kunt uw gesprekservaring aanpassen.
Modus Alleen-audio
Met de modus Alleen-audio in de UI-bibliotheek kunnen deelnemers deelnemen aan gesprekken door alleen hun audio te gebruiken, zonder video te delen of te ontvangen. Deze functie wordt gebruikt om bandbreedte te besparen en de privacy te maximaliseren. Wanneer de modus alleen-geluid wordt geactiveerd, worden de videofuncties automatisch uitgeschakeld voor zowel het verzenden als ontvangen van streams. De gebruikersinterface wordt aangepast aan deze wijziging door videobesturingselementen te verwijderen. Schakel deze modus in via de CallComposite configuratie. Zie de quickstart Alleen-audio voor meer informatie.
Oproepprompt beëindigen uitschakelen
Wanneer u toepassingen ontwikkelt die belmogelijkheden integreren, is het van cruciaal belang om een naadloze en intuïtieve gebruikerservaring te garanderen. Een gebied waar u de gebruikerservaring kunt stroomlijnen, is tijdens het gespreksbeëindigingsproces. Ontwikkelaars vinden het met name nuttig om de bevestigingsprompt voor linkse oproepen uit te schakelen die wordt weergegeven wanneer een gebruiker een oproep wil beëindigen. Deze functie, hoewel dit handig is bij het voorkomen van onopzettelijke oproepbeëindigingen, kan de gebruikerservaring soms belemmeren, met name in omgevingen waarin snelheid en efficiëntie cruciaal zijn. Zie De oproepbevestiging uitschakelen voor meer informatie.
Snelle communicatieomgevingen: In instellingen zoals handelsvloeren, noodoproepcentra of klantenservicecentra moeten snel beslissingen en acties worden uitgevoerd. De extra stap van het bevestigen van oproepbeëindiging kan de efficiëntie van de werkstroom belemmeren.
Aanpassing van knopbalk
Met de functionaliteit kunnen ontwikkelaars nieuwe acties toevoegen aan het contextmenu of huidige knoppen op de knopbalk verwijderen. Ze kunnen de flexibiliteit bieden om aangepaste acties te introduceren en de gebruikersinterface aan te passen aan specifieke toepassingsbehoeften.
- Aangepaste knoppen toevoegen: ontwikkelaars kunnen nieuwe knoppen introduceren in de contextuele knopbalk om aangepaste acties te activeren.
- Bestaande knoppen verwijderen: ontwikkelaars kunnen overbodige standaardknoppen verwijderen om de interface te stroomlijnen, zoals camera, microfoon of audioselectie.
Houd rekening met de volgende beperkingen tijdens de implementatie van deze functie:
- Pictogrammen en labels: pictogrammen worden alleen toegevoegd voor nieuwe acties. De pictogrammen op de knopbalk behouden de vooraf gedefinieerde pictogrammen en de labels moeten beknopt zijn om aan de menudimensie te voldoen.
- Overwegingen voor toegankelijkheid: ontwikkelaars moeten ervoor zorgen dat alle aangepaste knoppen toegankelijk zijn, inclusief de juiste labels voor schermlezers.
| Knoppen verwijderen | Aangepaste acties toevoegen |
|---|---|
|
|
Gebruiksgevallen
- Aangepaste acties in aanroep: een bedrijfstoepassing kan een aangepaste knop Rapportprobleem toevoegen, waarmee gebruikers technische problemen rechtstreeks kunnen melden tijdens een gesprek.
- Huisstijl en gebruikerservaring: Een bedrijfs-app kan knoppen verwijderen die niet relevant zijn voor de use case en merkknoppen toevoegen die de gebruikerservaring verbeteren.
Om een consistente gesprekservaring te garanderen, raden we u aan Fluent UI-pictogrammen te integreren in uw project. Ze zijn beschikbaar in de GitHub-opslagplaats van Fluent UI. Door dit te doen, komen uw aangepaste pictogrammen overeen met het ontwerp van de CallComposite eigenschap en creëren ze een samenhangende en professionele uitstraling.
Aanbevolen procedures
- Schoon ontwerp: Vermijd overbezetting van de contextmenubalk. Voeg alleen knoppen toe die essentieel zijn voor de gebruikerservaring.
- Gebruikerstests uitvoeren: voer gebruikerstests uit om ervoor te zorgen dat de aanpassingen voldoen aan de behoeften van de gebruiker en deze niet verwarren of overweldigen.
- Feedbackmechanisme: Door knoppen zoals rapportprobleem toe te voegen, zorgt u ervoor dat er een robuust back-endsysteem beschikbaar is om de verzamelde feedback af te handelen. Gebruik het mechanisme dat standaard door de UI-bibliotheek wordt geboden.
Zie De knopbalk aanpassen voor meer informatie.
Installatiescherm overslaan
Ui-bibliotheek biedt de mogelijkheid om deel te nemen aan een gesprek door het installatiescherm van de ervaring voor het deelnemen aan oproepen over te slaan. Standaard doorloopt u een installatiescherm om deel te nemen aan een gesprek. Hier stelt u de oproepconfiguratie in, zoals camera in- of uitschakelen, microfoon in- of uitschakelen en selectie van audioapparaten voordat u deelneemt aan een gesprek. Voor dit scherm is gebruikersinteractie vereist om deel te nemen aan een gesprek, wat voor sommige gebruikers mogelijk niet nodig is. Daarom bieden we de mogelijkheid om deel te nemen aan een oproep door het installatiescherm over te slaan en de aanroepconfiguratie-API's op te geven. Zie De functie Setup-scherm overslaan voor meer informatie.
Thema's en kleuren
Gebruik de ui-bibliotheekoproep samengesteld voor iOS en Android om een aangepast thema te maken van de ervaring van een beller. U hebt de flexibiliteit om de primaire kleuren aan te passen, zodat u het kleurenschema kunt aanpassen aan uw specifieke huisstijlbehoeften. Door primaire kleuren aan te passen, kunt u ervoor zorgen dat de interface wordt geïntegreerd met de visuele identiteit van uw merk. U kunt de gebruikerservaring verbeteren terwijl u consistentie in uw toepassingen behoudt. Zie Uw thema maken voor meer informatie.
| Android | iOS |
|---|---|
|
|
Afbeelding en subtitel
Gebruik de UI-bibliotheek om aangepaste tekenreeksen in te voeren, zodat u de aanroepinterface gemakkelijker kunt aanpassen aan uw specifieke behoeften. U kunt de titel en ondertitel van een oproep aanpassen, zowel tijdens de installatiefase als terwijl de aanroep wordt uitgevoerd.
In een bedrijfsomgeving kunt u bijvoorbeeld de titel instellen op de agenda van de vergadering en de ondertitel om een aankondiging aan te geven. Voor klantondersteuning kunnen agenten titels gebruiken om de aard van het onderzoek weer te geven om de duidelijkheid en communicatie te verbeteren.
Tijdens gesprekken met tijdgevoelige discussies kunt u ook de ondertitel gebruiken om de gespreksduur weer te geven om ervoor te zorgen dat alle deelnemers op de hoogte zijn van de tijdsbeperkingen.
Zie De titel en subtitel instellen voor meer informatie.
Use cases voor chatten
Belangrijk
Deze functie van Azure Communication Services is momenteel beschikbaar als preview-versie.
Preview-API's en SDK's worden aangeboden zonder een service level agreement. U wordt aangeraden deze niet te gebruiken voor productieworkloads. Sommige functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden.
Raadpleeg aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews voor meer informatie.
| Gebied | Gebruiksgevallen |
|---|---|
| Chattypen | Neem deel aan een Chat-thread van Azure Communication Services. |
| Chatacties | Een chatbericht verzenden. |
| Een chatbericht ontvangen. | |
| Chatgebeurtenissen | Typindicatoren weergeven. |
| Een leesbevestiging weergeven. | |
| Weergeven wanneer een deelnemer wordt toegevoegd of verwijderd. | |
| Wijzigingen in de chattitel weergeven. |
Flexibiliteit
De ChatComposite eigenschap is ontworpen om in verschillende indelingen en weergaven in uw toepassing te passen. U kunt bijvoorbeeld chatten in een navigatieweergave, modale weergave of een andere weergave plaatsen. De ChatComposite eigenschap past zich aan en zorgt ervoor dat de gebruiker een naadloze ervaring heeft.
| Navigatieweergave | Modale weergave |
|---|---|
|
|
Ondersteunde identiteiten
Als u een samengestelde en verificatie voor de service wilt initialiseren, moet een gebruiker een Azure Communication Services-identiteit hebben. Zie Verifiëren bij Azure Communication Services en quickstart: Toegangstokens maken en beheren voor meer informatie.
Aanbevolen architectuur
Initialiseer een samengestelde samenstelling met behulp van een Azure Communication Services-toegangstoken. Het is belangrijk om toegangstokens van Azure Communication Services op te halen via een vertrouwde service die u beheert. Zie quickstart: Toegangstokens en de zelfstudie over vertrouwde services maken en beheren voor meer informatie.
Gespreks- en chatclientbibliotheken moeten de context hebben voor de oproep waaraan ze deelnemen. Verspreid de context naar klanten met behulp van uw eigen vertrouwde service. Gebruik bijvoorbeeld tokens voor gebruikerstoegang. De volgende tabel bevat een overzicht van de initialisatie- en resourcebeheerfuncties die nodig zijn om context toe te voegen aan een clientbibliotheek.
| Contoso-verantwoordelijkheden | Verantwoordelijkheden van ui-bibliotheek |
|---|---|
| Geef een toegangstoken op vanuit Azure. | Geef het opgegeven toegangstoken door om onderdelen te initialiseren. |
| Geef een vernieuwingsfunctie op. | Vernieuw het toegangstoken met behulp van een door de ontwikkelaar geleverde functie. |
| Informatie over deelname ophalen en doorgeven voor het gesprek of de chat. | Geef gespreks- en chatgegevens door om onderdelen te initialiseren. |
| Gebruikersgegevens ophalen en doorgeven voor een aangepast gegevensmodel. | Geef een aangepast gegevensmodel door aan onderdelen die moeten worden weergegeven. |
Platformondersteuning
| Platform | Versies |
|---|---|
| iOS | iOS 14 en hoger |
| Android | API 21 en hoger |
Guide voor probleemoplossing
Wanneer er problemen met spraak- of videogesprekken worden opgelost, wordt u mogelijk gevraagd om een oproep-id op te geven. Deze id wordt gebruikt om Azure Communication Services-aanroepen te identificeren.
Als u deze oproep-id wilt ophalen, gebruikt u de actiebalk onder aan het gespreksscherm. Selecteer de knop met het beletselteken om diagnostische gegevens over Delen weer te geven. Gebruik deze optie om de diagnostische gegevens te delen die nodig zijn om eventuele problemen bij te houden door het ondersteuningsteam.
Zie Informatie over foutopsporing programmatisch ophalen voor programmatische toegang tot de aanroep-id.
Zie Probleemoplossing in Azure Communication Services voor meer informatie over het oplossen van problemen.
| Scherm Bellen | Menu Diagnostische gegevens | Gespreks-id delen |
|---|---|---|
|
|
|