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í

Plocha	Případy použití
Typy volání	Připojení ke schůzce Microsoft Teams
	Připojení k volání služby Azure Communication Services pomocí ID skupiny
	Připojení k místnosti Azure Communication Services
	Zahájení odchozího volání jinému uživateli služby Azure Communication Services
	Zahájení odchozího hovoru na telefonní číslo
Interoperabilita Teams	Připojení k předsálí volání
	Zobrazení banneru s upozorněním na přepis a záznam
Ovládací prvky hovoru	Ztlumení a zrušení ztlumení hovoru
	Zapnutí a vypnutí videa během hovoru
	Zapnutí sdílení obrazovky
	Ukončení hovoru
Galerie účastníků	Zobrazení vzdálených účastníků v mřížce
	Zpřístupnění náhledu videa během hovoru pro místního uživatele
	Zpřístupnění výchozích avatarů, když je video vypnuté
	Zobrazení sdíleného obsahu obrazovky v galerii účastníků
Konfigurace volání	Správa mikrofonního zařízení
	Správa zařízení fotoaparátu
	Správa zařízení mluvčího
	Zpřístupnění místního náhledu pro uživatele ke kontrole videa
Účastníci	Zobrazení seznamu účastníků

Případy použití chatu

Plocha	Azure Communication Services Chat	Teams Interoperability Chat
Typy chatů	Připojení ke vláknu chatu azure Communication Services	Připojení k chatu schůzky v Microsoft Teams
Akce chatu	Odesílání a příjem textových zpráv	Odesílání a příjem textových zpráv
	Příjem textových zpráv ve formátu RTF	Příjem textových zpráv ve formátu RTF
	-	Příjem vložených obrázků*
	Odesílání a přijímání příloh souborů	Příjem příloh souborů*
Události chatu	Indikátory psaní a odesílání	Indikátory pro odesílání a příjem psaní**
	Odesílání a příjem potvrzení o přečtení	Odesílání a příjem potvrzení o přečtení
	Zobrazit, kdy je účastník přidaný nebo odebraný	Zobrazit, kdy je účastník přidaný nebo odebraný
Účastníci	Zobrazení seznamu účastníků	Zobrazení seznamu účastníků

*Podpora vložených obrázků 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 zadávání události od uživatele Teams se nemusí zobrazit správně.

Podporované identity

Aby bylo možné inicializovat složenou položku a ověřit ji 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 v Teams prostřednictvím komunikačních služeb. Pokud chcete povolit interoperabilitu Teams, použijte buď výchozí funkce ve složené volání, nebo ve složené chatové konverzaci, nebo pomocí komponent uživatelského rozhraní vytvořte vlastní prostředí.

Když do aplikace přidáte volání i chat, je důležité si uvědomit, že chatovací klient se nedá inicializovat, dokud účastník nebude do hovoru přijat. Jakmile je účastník přijat, může být chatovací klient inicializován, aby se připojil ke vláknu chatu schůzky. Vzor je znázorněn 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 znázorňující 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 koncového uživatele služby Azure Communication Service může přijímat obrázky odeslané uživatelem Teams.
• Sdílení souborů*. Ukázka koncového uživatele služby Azure Communication Service 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ým rozdílem mezi složenými komponentami a komponentami uživatelského rozhraní ve službě 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í:

Případ použití	Kompozity	Součásti UI
Použití motivů založených na fluentu	X	X
Vytvoření rozložení prostředí		X
Úprava vlastností stylu pomocí stylů CSS		X
Nahrazení ikon		X
Úprava rozložení galerie účastníků		X
Úprava rozložení ovládacího prvku volání	X	X
Vložení datových modelů pro úpravu metadat uživatelů	X	X

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. Můžete se připojit ke stavovém klientovi a přečíst si stav, zpracovat události a přepsat chování, které se má předat 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 pozorovatelnosti:

Případ použití	Kompozity	Součásti UI
Přístup ke stavu klienta hovoru a chatu	X	X
Přístup a zpracování klientských událostí	X	X
Přístup k událostem uživatelského rozhraní a jejich zpracování	X	X

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 z komunikačních služeb 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í. Podobně jako přístupové tokeny uživatelů distribuujte kontext klientům pomocí vlastní důvěryhodné služby.

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

Odpovědnosti společnosti Contoso	Odpovědnosti knihovny uživatelského rozhraní
Poskytnutí přístupového tokenu z Azure	Předání poskytnutého přístupového tokenu pro inicializaci komponent
Poskytnutí funkce aktualizace	Aktualizace přístupového tokenu pomocí funkce poskytnuté vývojářem
Načtení a předání informací o spojení pro hovor nebo chat	Předání informací o volání a chatu pro inicializaci komponent
Načtení a předání informací o uživateli pro libovolný vlastní datový model	Předání vlastního datového modelu komponentám k vykreslení

Podpora platformy

Sada SDK	Windows	macOS	Ubuntu	Linux	Android	iOS
Sada SDK uživatelského rozhraní	Chrome*, Microsoft Edge	Chrome*, Safari**	Chrom*	Chrom*	Chrom*	Safari**

* Podporuje 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ě a pro ty, kteří mluví různými jazyky. Knihovna uživatelského rozhraní poskytuje výchozí podporu pro některé jazyky a možnosti, včetně jazyků 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 tuto chvíli. 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 to vést k zobrazení obsahu html jako prostého textu ve vlákně zprávy.

Navštivte scénář knihovny uživatelského rozhraní.

CallComposite Pomocí knihovny uživatelského rozhraní Azure Communication Services a ChatComposite v knihovně uživatelského rozhraní služby 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é položky v komunikačních službách spravují celý životní cyklus hovoru a chatu od nastavení až do ukončení hovoru a chatu.

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

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

Plocha	Případy použití
Typy volání	Připojení ke schůzce Microsoft Teams
	Připojení ke schůzce v Microsoft Teams pomocí ID schůzky a hesla
	Připojení k hovoru pomocí ID skupiny
	Připojení k hovoru pomocí ID místnosti
	Volat a přijímat hovory 1:1
Interoperabilita Teams	Připojení k předsálí volání
	Zobrazení banneru s upozorněním na přepis a záznam
	Povolit nebo odmítnout účastníky předsálí
Galerie účastníků	Zobrazení vzdálených účastníků v mřížce
	Zpřístupnění náhledu videa během hovoru pro místního uživatele
	Zpřístupnění výchozích avatarů, když je video vypnuté
	Zobrazení sdíleného obsahu obrazovky v galerii účastníků
	Povolení přizpůsobení avatara účastníka
	Zobrazení seznamu účastníků
Konfigurace volání	Správa mikrofonního zařízení
	Správa zařízení fotoaparátu
	Správa zařízení reproduktoru (drátové připojení nebo Bluetooth)
	Zpřístupnění místního náhledu pro uživatele ke kontrole videa
	Povolit dialog pro potvrzení ukončení hovoru
	Přeskočit obrazovku nastavení
Ovládací prvky hovoru	Ztlumení a zrušení ztlumení hovoru
	Zapnutí nebo vypnutí videa během hovoru
	Ukončení hovoru
	Přidržení a obnovení hovoru po přerušení zvuku
	Podpora CallKitu a TelecomManageru

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 v Teams prostřednictvím komunikačních služeb. 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í

Služba 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 koncovými uživateli služeb 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í ROOMS API jako 1 z 3 následujících rolí:

• Prezentující (výchozí)
• Účastníků
• Příjemce

Rozdíl mezi jednotlivými rolemi spočívá v schopnostech, které mají při volání místnosti při využití CallComposite. Tady jsou podrobně popsané konkrétní možnosti přidružené k jednotlivým rolím.

Poznámka:

Rozhraní API místnosti slouží k vytváření místností, správě uživatelů a úpravě doby života místností. Je důležité si uvědomit, že rozhraní ROOMS API je back-endová služba, která je oddělená od 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.

Motivy

Složené volání knihovny uživatelského rozhraní pro iOS a Android můžete použít k vytvoření vlastního motivu prostředí volajícího. Pokud chcete vytvořit prostředí platformy, předejte sadu barev motivů, jak je znázorněno v následující tabulce. Další informace naleznete v tématu Vytvoření motivu.

Android	iOS

Velikost obrazovky

Volání služby Azure Communication Services můžete přizpůsobit složené z velikostí obrazovky od 5 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

Lokalizace

Lokalizace je klíčem k vytváření produktů pro uživatele po celém světě a pro ty, 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 Postup přidání lokalizace do aplikace.

Usnadnění

Přístupnost je klíčovým cílem knihoven volání. Pomocí čtečky obrazovky můžete vytvářet 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.

Zobrazení injektáže dat

Knihovnu uživatelského rozhraní pro mobilní nativní platformy můžete použít k tomu, aby místní a vzdálení účastníci mohli přizpůsobit, jak se budou zobrazovat jako uživatelé hovoru. Místní účastník může při zahájení hovoru zvolit místní avatar, vlastní zobrazovaný název, název navigace a podnadpis 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 Přizpůsobení zobrazení před schůzkou.

Přeskočit obrazovku nastavení

Knihovna uživatelského rozhraní poskytuje možnost připojit se k hovoru přeskočením instalační obrazovky prostředí pro připojení k volání. Ve výchozím nastavení uživatel prochází obrazovkou nastavení, aby se připojil k hovoru. Tady uživatel nastaví konfiguraci hovoru, jako je zapnutí nebo vypnutí kamery, zapnutí nebo vypnutí mikrofonu a výběr zvukového zařízení před připojením 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 naleznete v tématu Použití funkce Přeskočit instalační obrazovku.

Režim pouze zvuku

Režim pouze zvuku 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 pouze zvuku automaticky zakáže funkce videa pro odesílání i příjem datových proudů a upraví uživatelské rozhraní tak, aby odráželo tuto změnu odebráním ovládacích prvků souvisejících s videem. Tento režim lze povolit prostřednictvím konfigurace CallComposite, další informace dostupné prostřednictvím rychlého startu pouze pro zvuk.

Orientace

Knihovna uživatelského rozhraní podporuje nastavení orientace obrazovky pro každou obrazovku samostatně před spuštěním prostředí knihovny. Vývojáři aplikací tak můžou nastavit pevnou orientaci pro volající prostředí, což by odpovídalo orientaci aplikace. Další informace o seznamupodporovaných

Multitasking a obrázek v obrázku

Knihovna uživatelského rozhraní podporuje obrázek v režimu obrázku pro obrazovku hovoru. Během hovoru může uživatel kliknout na tlačítko Zpět na obrazovce hovoru a povolit multitasking, který uživatele vrátí zpět na předchozí obrazovku. Pokud je povolená možnost Obrázek v obrázku, zobrazí se pro volání systém Picture-in-Picture. Další informace o multitaskingu a obrázku v obrázku pro platformu Android i iOS a použití rozhraní API najdete v tématu Použití obrázku v obrázku.

Podpora CallKitu

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

Podpora pro TelecomManager

Knihovna uživatelského rozhraní teď podporuje integraci s TelecomManagerem, což umožňuje zpracování funkcí blokování hovorů a obnovení. Další informace o integraci platformy Android a použití rozhraní API najdete v tématu Jak používat TelecomManager.

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ích volání knihovna uživatelského rozhraní podporuje také registraci nabízených oznámení. Další informace o integraci platformy Android a iOS a využití rozhraní API najdete v tématu Jak volat 1:1 a přijímat nabízená oznámení.

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

Při vývojiaplikacích Jedna oblast, ve které je možné zjednodušit UX, 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í. Jak zakázat potvrzení hovoru

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

Případy použití chatu

Důležité

Tato funkce služeb Azure Communication Services je aktuálně ve verzi 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.

Plocha	Případy použití
Typy chatů	Připojení ke vláknu chatu azure Communication Services
Akce chatu	Odeslání zprávy chatu
	Přijetí zprávy chatu
Události chatu	Zobrazení indikátorů psaní
	Zobrazení potvrzení o přečtení
	Zobrazit, kdy je účastník přidaný nebo odebraný
	Zobrazení změn v názvu chatu

Flexibilita

Byla ChatComposite navržena tak, aby se vešla do různých rozložení a zobrazení ve vaší 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í. Uživatel ChatComposite by se sám upravil a zajistil bezproblémové prostředí.

V navigačním zobrazení	V modálním zobrazení

Podporované identity

Aby bylo možné inicializovat složenou položku a ověřit ji 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í. Podobně jako přístupové tokeny uživatelů distribuujte kontext klientům pomocí vlastní důvěryhodné služby. Následující tabulka shrnuje funkce inicializace a správy prostředků, které jsou potřeba k přidání kontextu do klientské knihovny:

Odpovědnosti společnosti Contoso	Odpovědnosti knihovny uživatelského rozhraní
Poskytnutí přístupového tokenu z Azure	Předání poskytnutého přístupového tokenu pro inicializaci komponent
Poskytnutí funkce aktualizace	Aktualizace přístupového tokenu pomocí funkce poskytnuté vývojářem
Načtení a předání informací o spojení pro hovor nebo chat	Předání informací o volání a chatu pro inicializaci komponent
Načtení a předání informací o uživateli pro libovolný vlastní datový model	Předání vlastního datového modelu komponentám k vykreslení

Podpora platformy

Platforma	Verze
iOS	iOS 14 a novější
Android	Rozhraní API 21 a novější

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

Při řešení potíží s hlasovými hovory nebo videohovory můžete být požádáni o zadání ID volání. Toto ID se používá k identifikaci volání komunikačních služeb.

Toto ID volání lze načíst prostřednictvím panelu akcí v dolní části obrazovky hovoru; Vidíte tlačítko se třemi tečky; jakmile uživatel provede akci klepnutím, zobrazí se možnost Sdílet diagnostické informace. Uživatel může sdílet diagnostické informace potřebné ke sledování jakýchkoli problémů týmem podpory.

Programový přístup k CALLID najdete v tématu "Jak získat informace o ladění programově".

Další informace o pokynech pro řešení potíží najdete tady: Stránka Řešení potíží v Azure Communication Services .

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

Příručky pro rychlý start