Felhasználói felületi kódtár használati esetei

Az Azure Communication Services felhasználói felületi kódtárában összetevők és kompozitok használatával hívás- és csevegési élményeket hozhat létre az alkalmazásokban.

Az összetett alkalmazásokban a hívási és csevegési képességek közvetlenül beépülnek, és elérhetővé válnak, amikor az összetettet egy alkalmazásba integrálja. A felhasználói felületi összetevőkben a hívási és csevegési képességek a felhasználói felület funkcióinak és az alapul szolgáló állapotalapú kódtáraknak a kombinációján keresztül érhetők el. A képességek teljes kihasználásához javasoljuk, hogy felhasználói felületi összetevőket használjon állapotalapú hívás- és csevegési ügyfélkódtárakkal.

Fogalmibb dokumentációt, rövid útmutatókat és példákat kaphat a felhasználói felületi könyvtár mesekönyvében.

Híváshasználati esetek

Terület	Használati esetek
Hívástípusok	Bekapcsolódás Microsoft Teams-értekezletbe.
	Csatlakozzon egy Azure Communication Services-híváshoz csoportazonosító használatával.
	Csatlakozzon egy Azure Communication Services-helyiséghez.
	Kimenő hívás indítása egy másik Azure Communication Services-felhasználóhoz.
	Kimenő hívás indítása telefonszámra.
A Teams együttműködése	Csatlakozzon a hívási előszobához.
	Transzkript megjelenítése és riasztási szalagcím rögzítése.
Hívásvezérlők	Hívás elnémítása és visszahangosítása.
	A videokép be- és kikapcsolása hívás közben.
	Kapcsolja be a képernyőmegosztást.
	Hívás befejezése.
Résztvevők katalógusa	Távoli résztvevők megjelenítése rácson.
	A videó előnézetének elérhetővé tétele egy helyi felhasználó hívása során.
	Az alapértelmezett avatarok elérhetővé tétele, ha a videó ki van kapcsolva.
	Megosztott képernyőtartalom megjelenítése a résztvevők gyűjteményében.
Híváskonfiguráció	A mikrofoneszköz kezelése.
	A kameraeszköz kezelése.
	A hangszóró eszköz kezelése.
	A videó megtekintéséhez tegye elérhetővé a helyi előnézetet a felhasználó számára.
Résztvevők	Résztvevők névsorának megjelenítése.

Csevegőhasználati esetek

Terület	Azure Communication Services-csevegés	Teams együttműködési csevegés
Csevegéstípusok	Csatlakozzon egy Azure Communication Services-csevegési szálhoz.	Bekapcsolódás Microsoft Teams-értekezletek csevegésbe.
Csevegési műveletek	Szöveges üzenetek küldése és fogadása.	Szöveges üzenetek küldése és fogadása.
	Rich Text-üzenetek küldése és fogadása.*	Rich Text-üzenetek küldése és fogadása.*
	-	Beágyazott képek fogadása.
	Fájlmellékletek küldése és fogadása.	Fájlmellékletek fogadása.*
Csevegési események	Gépelésjelzők küldése és fogadása.	Gépelési jelzők küldése és fogadása.**
	Olvasási visszaigazolások küldése és fogadása.	Olvasási visszaigazolások küldése és fogadása.
	A résztvevők hozzáadásának vagy eltávolításának megjelenítése.	A résztvevők hozzáadásának vagy eltávolításának megjelenítése.
Résztvevők	Résztvevők névsorának megjelenítése.	Résztvevők névsorának megjelenítése.

*A rich text üzenetek küldése és a fájlmellékletek támogatása jelenleg nyilvános előzetes verzióban érhető el. Az előzetes verziójú API-k és SDK-k szolgáltatásszintű szerződés nélkül érhetők el. Javasoljuk, hogy éles számítási feladatokhoz ne használja őket. Előfordulhat, hogy egyes funkciók nem támogatottak, vagy korlátozott képességekkel rendelkeznek. További információkért tekintse át a Microsoft Azure Előzetes verzió kiegészítő használati feltételeit.

**Előfordulhat, hogy a Teams-felhasználó gépelési eseményének megjelenített neve nem jelenik meg megfelelően.

Támogatott identitások

Az összetett és a szolgáltatásban történő hitelesítés inicializálásához a felhasználónak Azure Communication Services-identitással kell rendelkeznie. További információ: Hitelesítés az Azure Communication Services szolgáltatásban és rövid útmutató: Hozzáférési jogkivonatok létrehozása és kezelése.

Teams-együttműködés

A Teams együttműködési forgatókönyvei esetén felhasználói felületi kódtár-kompozitok használatával adhat hozzá felhasználót egy Teams-értekezlethez az Azure Communication Servicesen keresztül. A Teams együttműködésének engedélyezéséhez használja a hívási összetett vagy a csevegési összetettség alapértelmezett funkcióit. Felhasználói felületi összetevőkkel egyéni felhasználói felületet is létrehozhat.

Amikor hívást és csevegést is hozzáad egy alkalmazáshoz, ne feledje, hogy a csevegőügyfél csak akkor inicializálható, ha a résztvevőt be nem engedik a hívásba. A résztvevő felvételét követően inicializálhatja a csevegőügyfélt, hogy csatlakozzon az értekezlet csevegési szálához. A minta az alábbi ábrán látható.

Ha felhasználói felületi összetevőket használ a Teams együttműködési élményének biztosításához, először használjon felhasználói felületi kódtár-példákat a felhasználói felület legfontosabb elemeinek létrehozásához:

• Példa előszobára: Egy minta előszobára, ahol a résztvevők megvárhatják, hogy beengedjenek egy hívást.
• Megfelelőségi szalagcím: Minta szalagcím, amely megjeleníti a felhasználót, ha a hívást rögzítik.
• Teams-téma: Mintatéma, amely a felhasználói felületi kódtár elemeit a Microsoft Teamshez hasonlóvá teszi.
• Képmegosztás*: Minta, amely bemutatja, hogyan fogadhat egy Azure Communication Services-felhasználó a Teams-felhasználó által küldött képeket.
• Fájlmegosztás*: Minta, amely bemutatja, hogyan fogadhat egy Azure Communication Services-felhasználó a Teams-felhasználó által küldött fájlmellékleteket.

Testreszabás

A felhasználói felületi kódtár mintáival módosíthatja az összetevőket az alkalmazás megjelenésének és megjelenésének megfelelően. A testreszabás kulcsfontosságú különbség az összetett és a felhasználói felületi összetevők között az Azure Communication Servicesben. Az összetett elemek kevesebb testreszabási lehetőséggel rendelkeznek az egyszerűbb integrációs élmény érdekében.

Az alábbi táblázat a testreszabási használati esetek összetett és felhasználói felületi összetevőit hasonlítja össze.

Használati eset	Kompozitok	Felhasználói felület összetevői
Használjon Fluent-alapú témájú szövegeket.	X	X
A felhasználói felület elrendezésének összeállítása.		X
Stílustulajdonságok módosítása CSS-stílus használatával.		X
Ikonok cseréje.		X
Módosítsa a résztvevők katalógusának elrendezését.		X
Módosítsa a hívásvezérlő elrendezését.	X	X
Adatmodellek beszúrása a felhasználói metaadatok módosításához.	X	X

Megfigyelhetőség

A felhasználói felületi kódtár állapotkezelési architektúrája leválasztva van, így közvetlenül elérheti az állapotalapú hívás- és csevegési ügyfeleket. Az állapotalapú ügyfélhez csatlakozva elolvashatja az állapotot, kezelheti az eseményeket, és felülbírálhatja a viselkedést a felhasználói felület összetevőire való továbbításhoz.

Az alábbi táblázat összehasonlítja az összetett és a felhasználói felület összetevőit a megfigyelhető használati esetekhez.

Használati eset	Kompozitok	Felhasználói felület összetevői
Hívás- és csevegési ügyfélállapot elérése.	X	X
Ügyfélesemények elérése és kezelése.	X	X
Felhasználói felületi események elérése és kezelése.	X	X

Ajánlott architektúra

Összetett és alapösszetevő inicializálása egy Azure Communication Services hozzáférési jogkivonat használatával. Fontos, hogy az Azure Communication Servicesből egy ön által kezelt megbízható szolgáltatáson keresztül szerezze be a hozzáférési jogkivonatokat. További információ : Rövid útmutató: Hozzáférési jogkivonatok létrehozása és kezelése, valamint a megbízható szolgáltatás oktatóanyaga.

A hívás- és csevegési ügyfélkódtáraknak rendelkezniük kell az általuk csatlakozott hívás vagy csevegés környezetével. A környezet terjesztése az ügyfelek számára a saját megbízható szolgáltatásával. Használjon például felhasználói hozzáférési jogkivonatokat.

Az alábbi táblázat összefoglalja az inicializálási és erőforrás-kezelési függvényeket, amelyek szükségesek a környezet ügyfélkódtárhoz való hozzáadásához.

A Contoso feladatai	Felhasználói felületi kódtár feladatai
Adjon meg egy hozzáférési jogkivonatot az Azure-ból.	Az összetevők inicializálásához adja át a megadott hozzáférési jogkivonatot.
Adjon meg egy frissítési függvényt.	Frissítse a hozzáférési jogkivonatot egy fejlesztő által biztosított függvény használatával.
A hívás vagy csevegés csatlakozási adatainak lekérése és átadása.	Az összetevők inicializálásához adja át a hívási és csevegési információkat.
Az egyéni adatmodellek felhasználói adatainak lekérése és átadása.	Adjon át egy egyéni adatmodellt a renderelendő összetevőknek.

Platformtámogatás

SDK	Windows	macOS	Ubuntu	Linux	Android	iOS
UI SDK	Chrome,* Microsoft Edge	Chrome,* Safari**	Króm*	Króm*	Króm*	Szafari**

*A Chrome jelenlegi verziója és az előző két kiadás támogatott.

**A Safari 13.1-es és újabb verziói támogatottak. A safari macOS-hez készült kimenő videó még nem támogatott, de iOS esetén támogatott. A kimenő képernyőmegosztás csak asztali iOS rendszeren támogatott.

Akadálymentesség

A tervezés szerinti akadálymentesség a Microsoft-termékek egyik alapelve. A felhasználói felületi kódtár ezt az elvet követi, és minden felhasználói felületi összetevő teljes mértékben elérhető.

Honosítás

A honosítás kulcsfontosságú ahhoz, hogy a különböző nyelveket beszélő felhasználók termékeit világszerte el tudják készíteni. A felhasználói felületi kódtár bizonyos nyelvek és képességek alapértelmezett támogatását biztosítja. Ez a támogatás a jobbról balra író nyelveket is tartalmazza. A felhasználói felület kódtárával saját honosítási fájlokat is megadhat.

Ismert problémák

A felhasználói felületi kódtár jelenleg nem támogatja az üzenettípus frissítését a meglévő üzenetek szerkesztésekor. Ha rich text formázást ad egy meglévő üzenethez, html-stílust ad hozzá a szöveges tartalomhoz. Mivel az üzenet típusa nem változik, az eredmény lehet html-tartalom, amely egyszerű szövegként jelenik meg az üzenetszálban.

Látogasson el a felhasználói felületi könyvtár mesekönyvére.

Az Azure Communication Services felhasználói felületi kódtárának használatával CallComposite és ChatComposite használatával hívási élményt hozhat létre iOS- és Android-alkalmazásaiban. Néhány sornyi kód használatával egyszerűen integrálhat egy teljes hívási és csevegési felületet az alkalmazásban. Az Azure Communication Services kompozitjai a hívás és csevegés teljes életciklusát kezelik a beállítástól a hívásig és a csevegés végéig.

Híváshasználati esetek

Ezeket a használati eseteket az Azure Communication Services hívás-összetett használatával hozhatja létre.

Terület	Használati esetek
Hívástípusok	Bekapcsolódás Microsoft Teams-értekezletbe.
	Bekapcsolódhat egy Microsoft Teams-értekezletbe egy értekezletazonosító és egy pin-kód használatával.
	Csatlakozás egy híváshoz csoportazonosító használatával.
	Csatlakozzon egy híváshoz egy szobaazonosító használatával.
	1:1-ás hívások indítása és fogadása.
A Teams együttműködése	Csatlakozzon a hívási előszobához.
	Transzkript megjelenítése és riasztási szalagcím rögzítése.
	Az előszoba résztvevőinek beengedése vagy elutasítása.
Feliratos feliratok	A Teams együttműködése.
	Csoportos hívás, szobahívás és 1:1-ás hívás.
Résztvevők katalógusa	Távoli résztvevők megjelenítése rácson.
	A videó előnézetének elérhetővé tétele egy helyi felhasználó hívása során.
	Az alapértelmezett avatarok elérhetővé tétele, ha a videó ki van kapcsolva.
	Megosztott képernyőtartalom megjelenítése a résztvevők gyűjteményében.
	A résztvevők avatar testreszabásának engedélyezése.
	Résztvevők névsorának megjelenítése.
Híváskezelés	A mikrofoneszköz kezelése.
	A kameraeszköz kezelése.
	A hangszóró eszközének kezelése (vezetékes vagy Bluetooth)
	A videó megtekintéséhez tegye elérhetővé a helyi előnézetet a felhasználó számára.
	Események feliratkozása.
Hívásvezérlők	Hívás elnémítása és visszahangosítása.
	A videokép be- vagy kikapcsolása hívás közben.
	Hívás befejezése.
	Hangkimaradás után tartsa és folytassa a hívást.
	A CallKit és a TelecomManager támogatása.
A felület testreszabása	Gombsáv testreszabása.
	Cím- és alcímkonfiguráció.
	Engedélyezze a véghívás-megerősítési párbeszédet.
	A beállítási képernyő kihagyása.

Hívásintegráció

Ez a szakasz a hívások integrációját ismerteti.

Teams-együttműködés

A Teams együttműködési forgatókönyvei esetén felhasználói felületi kódtár-kompozitok használatával adhat hozzá felhasználót egy Teams-értekezlethez az Azure Communication Servicesen keresztül. A Teams együttműködésének engedélyezéséhez használja a hívási összetettet. Az összetett rendszer kezeli a Teams együttműködési híváshoz való csatlakozás teljes életciklusát.

Az alábbi ábrán egy példa látható a felhasználói élményre, mielőtt egy hívót hozzáadnak egy Teams-értekezlethez.

Szobák integrációja

Az Azure Communication Services egy olyan helyiséget biztosít a fejlesztők számára, akik strukturált beszélgetéseket, például virtuális találkozókat vagy virtuális eseményeket építenek. A szobák jelenleg lehetővé teszik a hang- és videohívást.

A helyiség olyan tároló, amely az Azure Communication Services felhasználói közötti tevékenységeket kezeli. A szobákban az alkalmazásfejlesztők jobban szabályozhatják , hogy ki csatlakozhat egy híváshoz, mikor találkoznak, és hogyan működnek együtt. A szobákkal kapcsolatos további információkért tekintse meg a fogalmi dokumentációt.

A rendszer meghív egy felhasználót egy helyiségbe a Rooms API használatával az alábbi három szerepkör egyikében:

• Előadó (alapértelmezett)
• Résztvevő
• Ügyfélszolgáltatások

Az egyes szerepkörök közötti különbség abban rejlik, hogy milyen képességekkel rendelkeznek a szobahívások során, amikor CallComposite használatban vannak. Az egyes szerepkörökhöz tartozó konkrét képességeket a virtuális szobák áttekintésében tekintheti meg.

Feljegyzés

A Szobák API a szobák létrehozását, a felhasználók kezelését és a szobák élettartamának módosítását szolgálja. A Rooms API egy háttérszolgáltatás, amely eltér a felhasználói felületi kódtártól.

Egy-az-egyhez hívás és PUSH-értesítés támogatása

A felhasználói felületi kódtár támogatja az egy-az-egyhez VoIP-hívásokat a felhasználók kommunikációs azonosító alapján történő tárcsázásához. Bejövő hívás fogadásához a felhasználói felületi kódtár az értesítések regisztrálását PUSH is támogatja. Az Android- és iOS-platformok integrációjával és az API használatával kapcsolatos további információkért lásd : Egy-az-egy hívás kezdeményezése és PUSH-értesítések fogadása.

Hívási funkciók

A híváshoz számos funkció érhető el.

Akadálymentesség

Az akadálymentesség a hívástárak egyik fő fókusza. Képernyőolvasó használatával fontos bejelentéseket tehet a hívás állapotáról, és gondoskodhat arról, hogy a látássérült felhasználók hatékonyan vehessenek részt az alkalmazás használatában.

Feliratos feliratok

A feliratos feliratok számos forgatókönyvet tesznek lehetővé, beleértve a Teams és az Azure Communication Services csoporthívásaival való együttműködést, a szobahívásokat és az egy-az-egy hívásokat. Ez a funkció biztosítja, hogy a felhasználók a különböző hívókörnyezetekben folytatott beszélgetésekkel együtt kövessék az akadálymentességet és a felhasználói élményt.

A felhasználóknak manuálisan kell kiválasztaniuk a feliratok nyelvét a felhasználói felületi kódtár használatával, mert a rendszer nem észleli automatikusan a beszélt nyelvet.

A feliratokkal kapcsolatos további információkért tekintse át a dokumentációban a magyarázatokat és a használati útmutatókat. Ha közvetlenül a felhasználói felületi kódtárban szeretné konfigurálni a feliratokat, kövesse az oktatóanyagot a könnyű beállítás érdekében.

esemény

A fejlesztők mostantól előfizethetnek a tulajdonságon CallComposite belüli eseményekre. Ezzel a funkcióval a hívás életciklusa során adott eseményekhez csatolhatják a figyelőket. Ez a fejlesztés nagyobb szabályozási és testreszabási lehetőségeket biztosít. A fejlesztők egyéni műveleteket indíthatnak el olyan események alapján, mint a résztvevők csatlakozása vagy a hívást elhagyó résztvevők. Emellett eseményeket is használhatnak a naplózási interakciókhoz, a felhasználói felületek dinamikus frissítéséhez vagy az általános funkciók javításához.

További információ: Események kezelése a felhasználói felületi kódtárban.

Honosítás

A honosítás kulcsfontosságú ahhoz, hogy a különböző nyelveket beszélő felhasználók termékeit világszerte el tudják készíteni. A felhasználói felület könyvtára 12 nyelvet támogat: angol, spanyol, francia, német, olasz, japán, koreai, holland, portugál, orosz, török és kínai. A jobbról balra író nyelveket is támogatja. További információ: Honosítás hozzáadása az alkalmazáshoz.

Többfeladatos és kép-kép mód

A felhasználói felületi kódtár támogatja a kép a képben módot a hívási képernyőhöz. Hívás közben a felhasználók a hívási képernyőn a Vissza gombra kattintva engedélyezhetik a többfeladatos munkavégzést, hogy visszavehessék őket az előző képernyőre. Ha engedélyezve van a képi kép mód, megjelenik egy rendszerkép a képben a híváshoz. Ha többet szeretne megtudni a többfeladatos használatról és az Android és iOS platformok képen belüli módjáról, valamint az API használatáról, olvassa el a Kép a képben funkció bekapcsolása felhasználói felületi kódtár használatával című témakört.

Képernyő tájolása

A felhasználói felületi kódtár az egyes képernyők képernyő tájolásának beállítását külön-külön támogatja a tár használata előtt. Az alkalmazásfejlesztők rögzített tájolást állíthatnak be a hívási felülethez, amely igazítaná az alkalmazás tájolását. Ha többet szeretne megtudni az Android- és iOS-platformok támogatott tájolásának listájáról és az API használatáról, olvassa el a Képernyő tájolásának beállítása felhasználói felületi kódtár használatával című témakört.

Képernyőméret

Az Azure Communication Services hívási összetettjét úgy alakíthatja át, hogy az öt hüvelyktől a táblagép méretéhez igazodjon. A hívási összetettben használjon osztott és táblagépes módot a dinamikus résztvevők névsor-elrendezésének lekéréséhez, a nézet egyértelműségének biztosításához és a beszélgetésre való összpontosításhoz.

Osztott mód	Táblagép mód

Adatinjektálás megtekintése

A Natív mobilplatformokhoz készült felhasználói felületi kódtár segítségével a helyi és távoli résztvevők testre szabhatják, hogyan jelennek meg felhasználókként a hívásban. A helyi résztvevők kiválaszthatják a helyi avatart, az egyéni megjelenítendő nevet, valamint a navigációs címet és alcímet a beállítási képernyőn a hívás indításakor. A távoli felhasználók testre szabott avatart hozhatnak létre, amikor csatlakoznak az értekezlethez. További információ: Egyéni adatmodell beszúrása a felhasználói felületi kódtárban.

Megosztott tartalom megtekintése

A mobil natív platformok felhasználói felületi kódtárán keresztül a hívás résztvevői megtekinthetik a megosztott tartalmakat, ha más résztvevők megosztják a képernyőjüket egy Teams-hívás során. A távoli résztvevők nyújtásos és csippentő kézmozdulatokkal nagyíthatják vagy kicsinyíthetik a hívás megosztott tartalmát.

Operációsrendszer-integrációk

Integrálható az operációs rendszerrel.

CallKit-támogatás

A felhasználói felületi kódtár támogatja CallKit az integrációt a hívások interakcióinak CallKit kezeléséhez. Az iOS-platform integrációjáról és az API használatáról további információt a CallKit integrálása a felhasználói felületi kódtárba című témakörben talál.

TelecomManager-támogatás

A felhasználói felületi kódtár mostantól támogatja az integrációt TelecomManager , és lehetővé teszi a hívás-visszatartási és folytatási függvények kezelését. Az Android-platform integrációjával és az API használatával kapcsolatos további információkért lásd : TelecomManager integrálása a felhasználói felületi kódtárba.

A hívási felület testreszabása

A hívási élményt testre szabhatja.

Csak hangalapú mód

A felhasználói felületi kódtár csak hangalapú módja lehetővé teszi a résztvevők számára, hogy csak a hangjuk használatával csatlakozzanak a hívásokhoz anélkül, hogy videót osztanának meg vagy fogadnak. Ez a funkció a sávszélesség megőrzésére és az adatvédelem maximalizálására szolgál. Aktiváláskor a csak hangalapú mód automatikusan letiltja a videofunkciókat a streamek küldéséhez és fogadásához. A videóval kapcsolatos vezérlők eltávolításával úgy módosítja a felhasználói felületet, hogy tükrözze ezt a változást. Engedélyezze ezt a módot a CallComposite konfiguráción keresztül. További információkért tekintse meg a csak hangalapú rövid útmutatót.

A hívásvégzítmének letiltása

A hívási képességeket integráló alkalmazások fejlesztésekor elengedhetetlen a zökkenőmentes és intuitív felhasználói élmény biztosítása. Az egyik terület, ahol egyszerűsítheti a felhasználói élményt, a hívásvégződtetési folyamat során történik. A fejlesztők számára előnyös lehet letiltani a bal oldali hívás-megerősítési kérést, amely akkor jelenik meg, amikor egy felhasználó le szeretné fejezni a hívást. Ez a funkció, bár hasznos a véletlen hívásvégzítések megelőzésében, néha akadályozhatja a felhasználói élményt, különösen olyan környezetekben, ahol a sebesség és a hatékonyság kulcsfontosságú. További információ: A hívás megerősítésének letiltása.

Gyors ütemű kommunikációs környezetek: Az olyan beállításokban, mint a kereskedelmi emeletek, a segélyhívási központok vagy az ügyfélszolgálati központok, a döntéseket és műveleteket gyorsan kell végrehajtani. A hívásvégzítés megerősítésének további lépése akadályozhatja a munkafolyamat hatékonyságát.

Gombsáv testreszabása

A funkció lehetővé teszi, hogy a fejlesztők új műveleteket vegyenek fel a helyi menübe, vagy eltávolítsák a gombsáv aktuális gombjait. Lehetővé teszik az egyéni műveletek bevezetésének rugalmasságát, és a felhasználói felületet az adott alkalmazás igényeinek megfelelően testre szabhatják.

• Egyéni gombok hozzáadása: A fejlesztők új gombokat vezetnek be a környezetfüggő gombsávba az egyéni műveletek aktiválásához.
• Meglévő gombok eltávolítása: A fejlesztők eltávolíthatják a szükségtelen alapértelmezett gombokat, hogy egyszerűsítse a felületet, például a kamerát, a mikrofont vagy a hangkijelölést.

A funkció megvalósítása során vegye figyelembe a következő korlátozásokat:

• Ikonok és címkék: Az ikonok csak az új műveletekhez lesznek hozzáadva. A gombsáv ikonjai megőrzik az előre definiált ikonokat, és a címkéknek tömörnek kell lenniük a menü dimenziójának megfelelően.
• Akadálymentességi szempontok: A fejlesztőknek gondoskodniuk kell arról, hogy minden egyéni gomb elérhető legyen, beleértve a képernyőolvasók megfelelő címkézését is.

Gombok eltávolítása	Egyéni műveletek hozzáadása

Használati esetek

• Egyéni híváson belüli műveletek: Az üzleti alkalmazások hozzáadhatnak egy egyéni jelentésproblémát gombra, amely lehetővé teszi a felhasználók számára, hogy közvetlenül jelentsenek technikai problémákat a hívás során.
• Védjegyzés és felhasználói élmény: A vállalati alkalmazások eltávolíthatják a használati eset szempontjából irreleváns gombokat, és olyan márkás gombokat adhatnak hozzá, amelyek javítják a felhasználói élményt.

A konzisztens hívási élmény biztosítása érdekében javasoljuk, hogy integrálja a Fluent felhasználói felület ikonjait a projektbe. A Fluent UI GitHub-adattárban érhetők el. Ezzel az egyéni ikonok megfelelnek a CallComposite tulajdonság kialakításának, és egységes és professzionális megjelenést hoznak létre.

Ajánlott eljárások

• Tiszta kialakítás: Ne legyen túlzsúfolt a helyi menüsáv. Csak olyan gombokat adjon hozzá, amelyek elengedhetetlenek a felhasználói élményhez.
• Felhasználótesztelés: Végezzen felhasználói tesztelést annak biztosítása érdekében, hogy a testreszabások megfeleljenek a felhasználói igényeknek, és ne zavarják vagy terheljék őket.
• Visszajelzési mechanizmus: Ha olyan gombokat ad hozzá, mint a jelentéssel kapcsolatos probléma , biztosíthatja, hogy egy robusztus háttérrendszer legyen elérhető az összegyűjtött visszajelzések kezeléséhez. Használja újra a felhasználói felületi kódtár által alapértelmezés szerint biztosított mechanizmust.

További információ: A gombsáv testreszabása.

Beállítási képernyő kihagyása

A felhasználói felületi kódtár lehetővé teszi a híváshoz való csatlakozást úgy, hogy kihagyja a hívásillesztési felület beállítási képernyőjét. Alapértelmezés szerint egy beállítási képernyőn keresztül csatlakozik egy híváshoz. Itt beállíthatja a hívás konfigurációját, például a kamera be- vagy kikapcsolását, a mikrofon be- vagy kikapcsolását, valamint a hangeszköz kiválasztását a híváshoz való csatlakozás előtt. Ez a képernyő felhasználói beavatkozást igényel egy híváshoz való csatlakozáshoz, ami egyes felhasználók számára szükségtelen lehet. Ezért a beállítási képernyő kihagyásával és a híváskonfigurációs API-k biztosításával biztosítjuk a híváshoz való csatlakozás lehetőségét. További információ: A beállítási képernyő kihagyása funkció.

Teátra és színek

Az iOS- és Android-alapú UI-kódtár hívási összetett használatával létrehozhat egy egyéni témát a hívó felületéről. Rugalmasan testre szabhatja az elsődleges színeket, hogy a színsémát az adott arculati igényeknek megfelelően alakíthassa. Az elsődleges színek módosításával biztosíthatja, hogy a felület integrálva legyen a márka vizuális identitásával. Javíthatja a felhasználói élményt, miközben konzisztenciát tart fenn az alkalmazásokban. További információt a Téma létrehozása című témakörben talál.

Android	iOS

Cím és alcím

A felhasználói felületi kódtár használatával egyéni sztringeket is beírhat, így könnyebben testre szabhatja a hívási felületet az igényeinek megfelelően. A hívás címét és alcímét a beállítási fázisban és a hívás folyamatban lévő állapotában is testre szabhatja.

Vállalati környezetben például úgy állíthatja be a címet, hogy tükrözze az értekezlet napirendjét és az alcímet, hogy egy bejelentést jelezze. Az ügyfélszolgálat számára az ügynökök címekkel jeleníthetik meg a vizsgálat jellegét az egyértelműség és a kommunikáció javítása érdekében.

Az időérzékeny beszélgetéseket tartalmazó hívások során a felirattal is megjelenítheti a hívás időtartamát, hogy minden résztvevő tisztában legyen az időkorlátokkal.

További információ: A cím és az alcím beállítása.

---

Csevegőhasználati esetek

Fontos

Az Azure Communication Services ezen funkciója jelenleg előzetes verzióban érhető el.

Az előzetes verziójú API-k és SDK-k szolgáltatásszintű szerződés nélkül érhetők el. Javasoljuk, hogy éles számítási feladatokhoz ne használja őket. Előfordulhat, hogy egyes funkciók nem támogatottak, vagy korlátozott képességekkel rendelkeznek.

További információkért tekintse át a Microsoft Azure Előzetes verzió kiegészítő használati feltételeit.

Terület	Használati esetek
Csevegéstípusok	Csatlakozzon egy Azure Communication Services-csevegési szálhoz.
Csevegési műveletek	Csevegőüzenet küldése.
	Csevegőüzenet fogadása.
Csevegési események	Gépelésjelzők megjelenítése.
	Olvasási visszaigazolás megjelenítése.
	A résztvevők hozzáadásának vagy eltávolításának megjelenítése.
	A csevegés címének változásainak megjelenítése.

Rugalmasság

A ChatComposite tulajdonság úgy lett kialakítva, hogy illeszkedjen az alkalmazás különböző elrendezéseibe és nézeteibe. Választhatja például, hogy navigációs nézetben, modális nézetben vagy más nézetben szeretné elhelyezni a csevegést. A ChatComposite tulajdonság alkalmazkodik önmagához, és biztosítja, hogy a felhasználó zökkenőmentes felhasználói élményben legyen része.

Navigációs nézet	Modális nézet

Támogatott identitások

Az összetett és a szolgáltatásban történő hitelesítés inicializálásához a felhasználónak Azure Communication Services-identitással kell rendelkeznie. További információ: Hitelesítés az Azure Communication Services szolgáltatásban és rövid útmutató: Hozzáférési jogkivonatok létrehozása és kezelése.

Ajánlott architektúra

Összetett inicializálása Azure Communication Services hozzáférési jogkivonat használatával. Fontos, hogy az Azure Communication Servicesből egy ön által kezelt megbízható szolgáltatáson keresztül szerezze be a hozzáférési jogkivonatokat. További információ : Rövid útmutató: Hozzáférési jogkivonatok létrehozása és kezelése, valamint a megbízható szolgáltatás oktatóanyaga.

A hívás- és csevegési ügyfélkódtáraknak rendelkezniük kell a csatlakozáshoz használt hívás környezetével. A környezet terjesztése az ügyfelek számára a saját megbízható szolgáltatásával. Használjon például felhasználói hozzáférési jogkivonatokat. Az alábbi táblázat összefoglalja azokat az inicializálási és erőforrás-kezelési függvényeket, amelyek szükségesek az ügyfélkódtár környezetének hozzáadásához.

A Contoso feladatai	Felhasználói felületi kódtár feladatai
Adjon meg egy hozzáférési jogkivonatot az Azure-ból.	Az összetevők inicializálásához adja át a megadott hozzáférési jogkivonatot.
Adjon meg egy frissítési függvényt.	Frissítse a hozzáférési jogkivonatot egy fejlesztő által biztosított függvény használatával.
A hívás vagy csevegés csatlakozási adatainak lekérése és átadása.	Az összetevők inicializálásához adja át a hívási és csevegési információkat.
Az egyéni adatmodellek felhasználói adatainak lekérése és átadása.	Adjon át egy egyéni adatmodellt a renderelendő összetevőknek.

Platformtámogatás

Platform	Verziók
iOS	iOS 14 és újabb verziók
Android	API 21 és újabb verziók

Hibaelhárítási útmutató

Hang- vagy videohívások hibaelhárítása esetén előfordulhat, hogy a rendszer kéri egy hívásazonosító megadását. Ez az azonosító az Azure Communication Services-hívások azonosítására szolgál.

A hívásazonosító lekéréséhez használja a hívási képernyő alján található műveletsávot. A három pont gombra kattintva megtekintheti a diagnosztikai adatok megosztását. Ezzel a beállítással megoszthatja azokat a diagnosztikai adatokat, amelyek a támogatási csapat problémáinak nyomon követéséhez szükségesek.

A hívásazonosító programozott eléréséről a hibakeresési információk programozott módon történő lekérése című témakörben olvashat.

További információ a hibaelhárításról: Hibaelhárítás az Azure Communication Servicesben.

Hívási képernyő	Diagnosztikai információk menü	Hívásazonosító megosztása

Rövid útmutatók