Případy použití knihovny uživatelského rozhraní

Pomocí komponent a složených součástí v knihovně uživatelského rozhraní služeb Azure Communication Services můžete ve svých aplikacích vytvářet prostředí pro volání a chat.

Ve složené funkci jsou funkce volání a chatu integrované přímo a vystavené při integraci složeného do aplikace. V komponentě uživatelského rozhraní se funkce volání a chatu zveřejňují prostřednictvím kombinace funkcí uživatelského rozhraní a základních stavových knihoven. Pokud chcete tyto funkce plně využít, doporučujeme používat komponenty uživatelského rozhraní se stavovými voláními a chatovacími klientskými knihovnami.

Získejte koncepční dokumentaci, rychlá zprovoznění a příklady v příběhu knihovny uživatelského rozhraní.

Případy použití volání

Případy použití chatu

*Podpora odesílání textových zpráv ve formátu RTF a příloh souborů je aktuálně ve verzi Public Preview. Rozhraní API a sady SDK verze Preview jsou poskytovány bez smlouvy o úrovni služeb. Doporučujeme je nepoužívat pro produkční úlohy. Některé funkce nemusí být podporované nebo můžou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview Microsoft Azure.

**Zobrazovaný název zapisující události od uživatele Teams se nemusí zobrazit správně.

Podporované identity

Aby bylo možné inicializovat složené a ověřit ve službě, musí mít uživatel identitu služby Azure Communication Services. Další informace najdete v tématu Ověřování ve službě Azure Communication Services a rychlém startu: Vytváření a správa přístupových tokenů.

Interoperabilita Teams

Ve scénářích interoperability Teams můžete pomocí složených z knihovny uživatelského rozhraní přidat uživatele ke schůzce Přes Azure Communication Services. Pokud chcete povolit interoperabilitu Teams, použijte buď výchozí funkce ve složené volání, nebo ve složené konverzaci. K vytvoření vlastního prostředí můžete použít také komponenty uživatelského rozhraní.

Když do aplikace přidáte volání i chat, nezapomeňte, že chatovací klient se nedá inicializovat, dokud účastník nepřijde do hovoru. Po přijetí účastníka můžete inicializovat chatovacího klienta, aby se připojil ke vláknu chatu schůzky. Vzor je ukázaný na následujícím obrázku.

Pokud k poskytování prostředí interoperability Teams používáte komponenty uživatelského rozhraní, začněte tím, že použijete příklady knihovny uživatelského rozhraní k vytvoření klíčových částí prostředí:

• Příklad předsálí: Ukázková předsálí, kde může účastník čekat na přijetí hovoru.
• Banner dodržování předpisů: Ukázkový banner, který zobrazuje uživatele, pokud se hovor nahrává.
• Motiv Teams: Ukázkový motiv, díky kterému prvky knihovny uživatelského rozhraní vypadají jako Microsoft Teams.
• Sdílení obrázků*: Ukázka, která ukazuje, jak uživatel služby Azure Communication Services může přijímat obrázky odeslané uživatelem Teams.
• Sdílení souborů*: Ukázka, která ukazuje, jak uživatel služby Azure Communication Services může přijímat přílohy souborů odesílané uživatelem Teams.

Vlastní nastavení

Pomocí vzorů knihovny uživatelského rozhraní můžete upravit komponenty tak, aby odpovídaly vzhledu a chování vaší aplikace. Přizpůsobení je klíčový rozdíl mezi složenými komponentami a komponentami uživatelského rozhraní ve službě Azure Communication Services. Složené soubory mají méně možností přizpůsobení pro jednodušší prostředí integrace.

Následující tabulka porovnává složené součásti a součásti uživatelského rozhraní pro případy použití přizpůsobení.

Pozorovatelnost

Architektura správy stavu knihovny uživatelského rozhraní je oddělená, takže máte přímý přístup k stavovým hovorům a chatovacím klientům. Připojte se k stavovém klientovi a přečtěte si stav, zpracujte události a přepište chování předávané komponentám uživatelského rozhraní.

Následující tabulka porovnává složené součásti a komponenty uživatelského rozhraní pro případy použití pozorovatelnosti.

Doporučená architektura

Inicializace složené a základní komponenty pomocí přístupového tokenu služby Azure Communication Services Je důležité získat přístupové tokeny ze služeb Azure Communication Services prostřednictvím důvěryhodné služby, kterou spravujete. Další informace najdete v tématu Rychlý start: Vytvoření a správa přístupových tokenů a kurz důvěryhodné služby.

Klientské knihovny hovorů a chatu musí mít kontext pro hovor nebo chat, ke kterému se připojí. Šíření kontextu klientům pomocí vaší vlastní důvěryhodné služby. Například použijte přístupové tokeny uživatele.

Následující tabulka shrnuje inicializace a funkce správy prostředků, které jsou potřeba k přidání kontextu do klientské knihovny.

Podpora platformy

*Podporují se aktuální verze Chromu a dvě předchozí verze.

**Podporuje se Safari verze 13.1 a novější verze. Odchozí video pro Safari macOS zatím není podporované, ale podporuje se pro iOS. Sdílení odchozích obrazovek se podporuje jenom v desktopovém iOSu.

Usnadnění

Přístupnost podle návrhu je principem napříč produkty Microsoftu. Knihovna uživatelského rozhraní se řídí tímto principem a všechny komponenty uživatelského rozhraní jsou plně přístupné.

Lokalizace

Lokalizace je klíčem k vytváření produktů pro uživatele po celém světě, kteří mluví různými jazyky. Knihovna uživatelského rozhraní poskytuje výchozí podporu pro některé jazyky a možnosti. Tato podpora zahrnuje jazyky se zprava doleva. Pro použití s knihovnou uživatelského rozhraní můžete poskytnout vlastní lokalizační soubory.

Známé problémy

Knihovna uživatelského rozhraní nepodporuje aktualizaci typu zprávy při úpravě existujících zpráv v současné době. Přidání formátování rtfingu do existující zprávy přidá do textového obsahu styl HTML. Vzhledem k tomu, že se typ zprávy nezmění, může být výsledkem obsah HTML, který se ve vlákně zprávy zobrazuje jako prostý text.

ChatComposite V CallComposite knihovně uživatelského rozhraní služeb Azure Communication Services můžete vytvářet prostředí volání v aplikacích pro iOS a Android. Pomocí několika řádků kódu můžete do své aplikace snadno integrovat celý hovor a chat. Složené složky ve službě Azure Communication Services spravují celý životní cyklus hovoru a chatu, od nastavení až po ukončení hovoru a chatu.

Případy použití volání

K vytvoření těchto případů použití použijte volání složené ve službě Azure Communication Services.

Integrace volání

Tato část popisuje integraci volání.

Interoperabilita Teams

Ve scénářích interoperability Teams můžete pomocí složených z knihovny uživatelského rozhraní přidat uživatele ke schůzce Přes Azure Communication Services. Pokud chcete povolit interoperabilitu Teams, použijte složené volání. Složený soubor spravuje celý životní cyklus připojování k volání interoperability Teams.

Následující obrázek ukazuje příklad uživatelského prostředí před tím, než se volající přidá do schůzky Teams.

Integrace místností

Azure Communication Services poskytuje koncept místnosti pro vývojáře, kteří vytvářejí strukturované konverzace, jako jsou virtuální události nebo virtuální události. Místnosti aktuálně umožňují hlasové hovory a videohovory.

Místnost je kontejner, který spravuje aktivitu mezi uživateli Azure Communication Services. Místnost nabízí vývojářům aplikací lepší kontrolu nad tím, kdo se může připojit k hovoru, kdy se setká a jak spolupracují. Další informace o místnostech najdete v koncepční dokumentaci.

Uživatel je pozván do místnosti pomocí rozhraní API místnosti v jedné ze tří následujících rolí:

• Prezentující (výchozí)
• Attendee
• Příjemce

Rozdíl mezi jednotlivými rolemi spočívá v možnostech, které mají při volání místnosti při CallComposite použití. Konkrétní možnosti přidružené k jednotlivým rolím jsou popsány v přehledu virtuálních místností.

Podpora volání 1:1 a podpora nabízených oznámení

Knihovna uživatelského rozhraní podporuje volání VoIP 1:1 pro vytáčení uživatelů pomocí identifikátoru komunikace. Pro příjem příchozího volání podporuje knihovna uživatelského rozhraní také registraci oznámení PUSH . Další informace o integraci pro platformy Android a iOS a použití rozhraní API najdete v tématu Volání 1:1 a přijímání nabízených oznámení.

Funkce volání

Pro volání je k dispozici několik funkcí.

Usnadnění

Přístupnost je klíčovým cílem knihoven volání. Pomocí čtečky obrazovky můžete dělat důležitá oznámení o stavu hovoru a zajistit, aby se uživatelé s vadami zraku mohli efektivně účastnit při používání aplikace.

Skryté titulky

Skryté titulky umožňují širokou škálu scénářů, včetně interoperability s Teams, skupinovými voláními azure Communication Services, voláními místností a voláním 1:1. Tato funkce zajišťuje, aby uživatelé mohli sledovat konverzace v různých volajících prostředích, což zlepšuje přístupnost a uživatelské prostředí.

Uživatelé musí ručně vybrat jazyk titulků pomocí knihovny uživatelského rozhraní, protože systém automaticky nerozpozná mluvený jazyk.

Další informace o skrytých titulcích najdete v dokumentaci , kde najdete vysvětlení a pokyny k používání. Pokud chcete skryté titulky nakonfigurovat přímo v knihovně uživatelského rozhraní, postupujte podle kurzu , který vám usnadní nastavení.

Události

Vývojáři se teď můžou přihlásit k odběru CallComposite událostí v rámci vlastnosti. Díky této funkci můžou připojit naslouchací procesy ke konkrétním událostem v průběhu životního cyklu volání. Toto vylepšení poskytuje větší možnosti kontroly a přizpůsobení. Vývojáři můžou aktivovat vlastní akce na základě událostí, jako jsou připojení účastníka nebo účastníci, kteří hovor opustili. Můžou také používat události pro protokolování interakcí, dynamicky aktualizovat uživatelská rozhraní nebo zvýšit celkovou funkčnost.

Další informace naleznete v tématu Zpracování událostí v knihovně uživatelského rozhraní.

Lokalizace

Lokalizace je klíčem k vytváření produktů pro uživatele po celém světě, kteří mluví různými jazyky. Knihovna uživatelského rozhraní podporuje 12 jazyků: angličtina, španělština, francouzština, němčina, italština, japonština, korejština, nizozemština, portugalština, ruština, turečtina a čínština. Podporuje také jazyky se zprava doleva. Další informace najdete v tématu Přidání lokalizace do aplikace.

Multitasking a režim obrázků v obrázku

Knihovna uživatelského rozhraní podporuje režim obrázku v obrázku pro obrazovku hovoru. Během hovoru můžou uživatelé vybrat tlačítko Zpět na obrazovce hovoru a umožnit tak multitaskingu, aby se vrátili na předchozí obrazovku. Pokud je režim obrázku v obrázku povolený, zobrazí se pro volání systémový obrázek s obrázkem. Další informace o multitaskingu a režimu obrázků v obrázku pro platformy Android i iOS a použití rozhraní API najdete v tématu Zapnutí obrázku v obrázku pomocí knihovny uživatelského rozhraní.

Orientace obrazovky

Knihovna uživatelského rozhraní podporuje nastavení orientace obrazovky pro každou obrazovku samostatně před začátkem prostředí knihovny. Vývojáři aplikací můžou nastavit pevnou orientaci pro volající prostředí, což by odpovídalo orientaci aplikace. Další informace o seznamu podporovaných orientací pro platformy Android i iOS a použití rozhraní API najdete v tématu Nastavení orientace obrazovky pomocí knihovny uživatelského rozhraní.

Velikost obrazovky

Přizpůsobte složené volání služeb Azure Communication Services tak, aby se přizpůsobilo velikostem obrazovky od pěti palců po velikost tabletu. Pomocí rozděleného režimu a režimu tabletu ve složeném hovoru získáte rozložení seznamu dynamických účastníků, získáte přehled o zobrazení a zaměřte se na konverzaci.

Režim rozdělení	Režim tabletu

Zobrazení injektáže dat

Knihovna uživatelského rozhraní pro mobilní nativní platformy umožňuje místním a vzdáleným účastníkům přizpůsobit, jak se budou zobrazovat jako uživatelé při volání. Místní účastník může při zahájení hovoru zvolit místní avatar, vlastní zobrazovaný název a titul a podnadpis navigace na obrazovce nastavení. Vzdálený uživatel může vytvořit přizpůsobený avatar, když se připojí ke schůzce. Další informace naleznete v tématu Vložení vlastního datového modelu do knihovny uživatelského rozhraní.

Zobrazení sdíleného obsahu

Prostřednictvím knihovny uživatelského rozhraní pro mobilní nativní platformy můžou účastníci hovoru zobrazit sdílený obsah, když ostatní účastníci sdílejí své obrazovky během hovoru přes Teams. Vzdálený účastník může pomocí gest roztažení a připnutí přiblížit nebo oddálit sdílený obsah hovoru.

Integrace operačního systému

Integrace s operačním systémem

Podpora CallKitu

Knihovna uživatelského rozhraní podporuje CallKit integraci pro zpracování interakce s voláními CallKit . Další informace o integraci platformy iOS a použití rozhraní API najdete v tématu Integrace CallKitu do knihovny uživatelského rozhraní.

Podpora pro TelecomManager

Knihovna uživatelského rozhraní teď podporuje integraci s funkcemi TelecomManager blokování volání a obnovení. Další informace o integraci platformy Android a použití rozhraní API najdete v tématu Integrace TelecomManager do knihovny uživatelského rozhraní.

Přizpůsobení prostředí hovoru

Prostředí hovoru si můžete přizpůsobit.

Režim pouze zvuku

Režim jen pro zvuk v knihovně uživatelského rozhraní umožňuje účastníkům připojit se k hovorům jenom pomocí zvuku, aniž by museli sdílet nebo přijímat video. Tato funkce se používá k zachování šířky pásma a maximalizaci ochrany osobních údajů. Při aktivaci režim jen pro zvuk automaticky zakáže funkce videa pro odesílání i příjem datových proudů. Upraví uživatelské rozhraní tak, aby odráželo tuto změnu odebráním ovládacích prvků souvisejících s videem. Povolte tento režim prostřednictvím CallComposite konfigurace. Další informace najdete v rychlém startu jen pro zvuk.

Zakázat výzvu k ukončení hovoru

Při vývoji aplikací, které integrují funkce volání, je důležité zajistit bezproblémové a intuitivní uživatelské prostředí. Jednou z oblastí, kde můžete zjednodušit uživatelské prostředí, je během procesu ukončení volání. Konkrétně můžou vývojáři najít užitečné zakázat výzvu k potvrzení levého volání, která se zobrazí, když chce uživatel ukončit hovor. Tato funkce, i když je užitečná při prevenci náhodného ukončení volání, může někdy bránit uživatelskému prostředí, zejména v prostředích, kde je rychlost a efektivita zásadní. Další informace najdete v tématu Zakázání potvrzení hovoru.

Rychlá komunikační prostředí: V nastavení, jako jsou obchodní patra, centra tísňového volání nebo centra zákaznických služeb, musí být rozhodnutí a akce prováděny rychle. Dodatečný krok potvrzení ukončení volání může bránit efektivitě pracovního postupu.

Přizpůsobení panelu tlačítek

Funkce umožňuje vývojářům přidávat nové akce do kontextové nabídky nebo odebírat aktuální tlačítka na panelu tlačítek. Můžou poskytnout flexibilitu při zavádění vlastních akcí a přizpůsobení uživatelského rozhraní podle konkrétních potřeb aplikace.

• Přidat vlastní tlačítka: Vývojáři můžou do kontextového panelu tlačítek zavést nová tlačítka, která aktivují vlastní akce.
• Odebrat existující tlačítka: Vývojáři můžou odebrat nepotřebná výchozí tlačítka pro zjednodušení rozhraní, jako je fotoaparát, mikrofon nebo výběr zvuku.

Při implementaci této funkce zvažte následující omezení:

• Ikony a popisky: Ikony se přidávají jenom pro nové akce. Ikony na panelu tlačítek mají předdefinované ikony a popisky by měly být stručné tak, aby odpovídaly rozměru nabídky.
• Aspekty přístupnosti: Vývojáři by měli zajistit, aby byla všechna vlastní tlačítka přístupná, včetně vhodných popisků pro čtečky obrazovky.

Odebrání tlačítek	Přidání vlastních akcí

Případy použití

• Vlastní akce v rámci volání: Obchodní aplikace může přidat vlastní tlačítko Problém se sestavou, které uživatelům umožňuje přímo hlásit technické problémy během hovoru.
• Branding a uživatelské prostředí: Podniková aplikace může odebrat tlačítka, která nejsou relevantní pro případ použití, a přidat značková tlačítka, která vylepšují uživatelské prostředí.

Pokud chcete zajistit konzistentní prostředí volání, doporučujeme do projektu integrovat ikony rozhraní Fluent. Jsou k dispozici v úložišti GitHub uživatelského rozhraní Fluent. Vlastní ikony tak odpovídají návrhu CallComposite vlastnosti a vytvářejí soudržný a profesionální vzhled.

Osvědčené postupy

• Čistý návrh: Vyhněte se převětvení kontextového řádku nabídek. Přidejte jenom tlačítka, která jsou nezbytná pro uživatelské prostředí.
• Testování uživatelů: Proveďte uživatelské testování, abyste zajistili, že přizpůsobení vyhovuje potřebám uživatelů a nezaměňuje je nebo je zahlcuje.
• Mechanismus zpětné vazby: Přidání tlačítek, jako je Problém se sestavou , zajistí, že je k dispozici robustní back-endový systém, který bude zpracovávat shromážděnou zpětnou vazbu. Znovu použijte mechanismus, který knihovna uživatelského rozhraní poskytuje ve výchozím nastavení.

Další informace naleznete v tématu Přizpůsobení panelu tlačítek.

Přeskočit obrazovku nastavení

Knihovna uživatelského rozhraní poskytuje možnost připojit se k hovoru tak, že přeskočí instalační obrazovku prostředí pro připojení k volání. Ve výchozím nastavení projdete obrazovkou nastavení a připojíte se k hovoru. Tady nastavíte konfiguraci hovoru, například zapnutí nebo vypnutí kamery, zapnutí nebo vypnutí mikrofonu a výběr zvukového zařízení před tím, než se připojíte k hovoru. Tato obrazovka vyžaduje interakci uživatele, aby se připojili k hovoru, což může být pro některé uživatele zbytečné. Proto poskytujeme možnost připojit se k hovoru přeskočením obrazovky nastavení a poskytnutím rozhraní API konfigurace volání. Další informace najdete v tématu Přeskočení funkce instalační obrazovky.

Motivy a barvy

K vytvoření vlastního motivu prostředí volajícího použijte složené volání knihovny uživatelského rozhraní pro iOS a Android. Máte možnost přizpůsobit si primární barvy, abyste mohli přizpůsobit barevné schéma tak, aby odpovídalo vašim konkrétním potřebám značky. Úpravou primárních barev můžete zajistit integraci rozhraní s vizuální identitou vaší značky. Uživatelské prostředí můžete vylepšit, když udržujete konzistenci napříč vašimi aplikacemi. Další informace najdete v tématu Vytvoření motivu.

Android	iOS

Název a titulek

Pomocí knihovny uživatelského rozhraní můžete zadat vlastní řetězce, které usnadňují přizpůsobení rozhraní volání tak, aby vyhovovalo vašim konkrétním potřebám. Název a podnadpis hovoru můžete přizpůsobit jak během fáze nastavení, tak během probíhajícího hovoru.

Například v podnikovém prostředí můžete nastavit název tak, aby odrážel program schůzky a podnadpis, který označuje oznámení. Pro zákaznickou podporu můžou agenti použít názvy k zobrazení povahy dotazu, aby zlepšili srozumitelnost a komunikaci.

Během hovorů s diskuzemi citlivými na čas můžete také použít podnadpis k zobrazení doby trvání hovoru, abyste zajistili, že všichni účastníci vědí o časových omezeních.

Další informace najdete v tématu Nastavení názvu a podnadpisu.

Případy použití chatu

Flexibilita

Vlastnost ChatComposite byla navržena tak, aby se vešla do různých rozložení a zobrazení v aplikaci. Můžete se například rozhodnout, že chat umístíte do navigačního zobrazení, modálního zobrazení nebo jiného zobrazení. Vlastnost ChatComposite se upraví a zajistí, aby uživatel získal bezproblémové prostředí.

Navigační zobrazení	Modální zobrazení

Podporované identity

Aby bylo možné inicializovat složené a ověřit ve službě, musí mít uživatel identitu služby Azure Communication Services. Další informace najdete v tématu Ověřování ve službě Azure Communication Services a rychlém startu: Vytváření a správa přístupových tokenů.

Doporučená architektura

Inicializace složeného pomocí přístupového tokenu azure Communication Services Je důležité získat přístupové tokeny ze služeb Azure Communication Services prostřednictvím důvěryhodné služby, kterou spravujete. Další informace najdete v tématu Rychlý start: Vytvoření a správa přístupových tokenů a kurz důvěryhodné služby.

Klientské knihovny hovorů a chatu musí mít kontext pro volání, ke kterému se připojí. Šíření kontextu klientům pomocí vaší vlastní důvěryhodné služby. Například použijte přístupové tokeny uživatele. Následující tabulka shrnuje funkce inicializace a správy prostředků, které jsou potřeba k přidání kontextu do klientské knihovny.

Podpora platformy

Příručka pro řešení problémů

Při řešení potíží s hlasovými hovory nebo videohovory se může zobrazit výzva k zadání ID hovoru. Toto ID slouží k identifikaci volání služeb Azure Communication Services.

Pokud chcete toto ID volání načíst, použijte panel akcí v dolní části obrazovky hovoru. Výběrem tlačítka se třemi tečky zobrazíte informace o sdílení diagnostiky. Pomocí této možnosti můžete sdílet diagnostické informace potřebné ke sledování jakýchkoli problémů týmem podpory.

Programový přístup k ID volání najdete v tématu Získání informací o ladění prostřednictvím kódu programu.

Další informace o řešení potíží najdete v tématu Řešení potíží ve službě Azure Communication Services.

Obrazovka volání	Nabídka Diagnostické informace	Sdílení ID volání