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 | Csatlakozás Microsoft Teams-értekezlethez |
| Csatlakozás Azure Communication Services-híváshoz csoportazonosító használatával | |
| Csatlakozás 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 | Csatlakozás 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 |
| Videokép be- és kikapcsolása hívás közben | |
| Képernyőmegosztás bekapcsolása | |
| Hívás befejezése | |
| Résztvevők katalógusa | Távoli résztvevők megjelenítése rácson |
| 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 beszélőeszköz kezelése | |
| Helyi előzetes verzió elérhetővé tétele a felhasználó számára a videó ellenőrzéséhez | |
| Résztvevők | Résztvevők névsorának megjelenítése |
Csevegőhasználati esetek
| Terület | Azure Communication Services Chat | Teams együttműködési csevegés |
|---|---|---|
| Csevegéstípusok | Csatlakozás Azure Communication Services-csevegési szálhoz | Csatlakozás Microsoft Teams-értekezletek csevegéséhez |
| 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 fogadása | Rich Text-üzenetek 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ésjelző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ő hozzáadásának vagy eltávolításának megjelenítése | A résztvevő 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 beágyazott kép és a fájlmelléklet 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ó által beírt esemény megjelenítendő neve nem jelenik meg megfelelően.
Támogatott identitások
Az összetett adatok inicializálásához és a szolgáltatásban való hitelesítéshez 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-összetettekkel adhat hozzá egy felhasználót egy Teams-értekezlethez a 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, vagy használjon felhasználói felületi összetevőket egy egyéni felület létrehozásához.
Amikor hívást és csevegést is hozzáad egy alkalmazáshoz, fontos megjegyezni, 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 a csevegőügyfél inicializálható az értekezlet csevegési szálához való csatlakozáshoz. A mintát a következő ábrán szemlélteti:
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ában, ahol a résztvevők megvárhatják, hogy beengedjenek egy hívást.
- Megfelelőségi szalagcím. Egy minta transzparens, amely megjeleníti a felhasználót, ha a hívást rögzítik.
- Teams-téma. Egy mintatéma, amely a felhasználói felületi kódtár elemeit a Microsoft Teamshez hasonlóvá teszi.
- Képmegosztás*. Az Azure Communication Service végfelhasználóinak mintája fogadhatja a Teams-felhasználó által küldött képeket.
- Fájlmegosztás*. Az Azure Communication Service végfelhasználói mintafájljai megkaphatják 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 a Communication Services összetett és felhasználói felületi összetevői között. 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 |
|---|---|---|
| Fluent-alapú témájúak használata | 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 | |
| A résztvevők katalógusának elrendezésének módosítása | X | |
| A hívásvezérlő elrendezésének módosítása | 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 felhasználói felület összetevőire vonatkozó viselkedést.
Az alábbi táblázat az összetett és a felhasználói felület összetevőit hasonlítja össze a megfigyelhető használati esetekhez:
| Használati eset | Kompozitok | Felhasználói felület összetevői |
|---|---|---|
| Hívás- és csevegésügyfél állapotának 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 egy ön által kezelt megbízható szolgáltatáson keresztül szerezze be a hozzáférési jogkivonatokat a Communication Servicesből. 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 felhasználói hozzáférési jogkivonatokhoz hasonlóan saját megbízható szolgáltatásával terjesztheti a környezetet az ügyfeleknek.
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 |
|---|---|
| Hozzáférési jogkivonat megadása az Azure-ból | Az összetevők inicializálásához adja át a megadott hozzáférési jogkivonatot |
| Frissítési függvény megadása | A hozzáférési jogkivonat frissítése fejlesztő által biztosított függvény használatával |
| Csatlakozási adatok lekérése és átadása a híváshoz vagy csevegéshez | Hívás- és csevegési információk átadása az összetevők inicializálásához |
| Felhasználói adatok lekérése és átadása bármely egyéni adatmodellhez | Egyéni adatmodell továbbítása az összetevőknek a rendereléshez |
Platformtámogatás
| SDK | Windows | macOS | Ubuntu | Linux | Android | iOS |
|---|---|---|---|---|---|---|
| UI SDK | Chrome*, Microsoft Edge | Chrome*, Safari** | Chrome* | Chrome* | Chrome* | Safari** |
* 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 termékek a világ minden tájáról különböző nyelveket beszélő felhasználók számára készüljenek. A felhasználói felületi kódtár bizonyos nyelvek és képességek alapértelmezett támogatását biztosítja, beleértve a jobbról balra író nyelveket is. 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átumot ad hozzá egy meglévő üzenethez, html-stílust ad hozzá a szöveges tartalomhoz. Mivel ez nem változtatja meg az üzenet típusát, előfordulhat, hogy a HTML-tartalom egyszerű szövegként jelenik meg az üzenetszálban.
CallCompositeChatComposite Az Azure Communication Services felhasználói felületi kódtárának 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. A 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
A Kommunikációs szolgáltatásokban a hívási összetettség használatával létrehozhatja az alábbi használati eseteket:
| Terület | Használati esetek |
|---|---|
| Hívástípusok | Csatlakozás Microsoft Teams-értekezlethez |
| Hívás csatlakoztatása csoportazonosító használatával | |
| A Teams együttműködése | Csatlakozás a hívási előszobához |
| Transzkript megjelenítése és riasztási szalagcím rögzítése | |
| Résztvevők katalógusa | Távoli résztvevők megjelenítése rácson |
| 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 | |
| Résztvevők avatar-testreszabásának engedélyezése | |
| Résztvevők névsorának megjelenítése | |
| Híváskonfiguráció | A mikrofoneszköz kezelése |
| A kameraeszköz kezelése | |
| A hangszóró eszközének kezelése (vezetékes vagy Bluetooth) | |
| Helyi előnézet elérhetővé tétele a felhasználó számára a videó ellenőrzéséhez | |
| Hívásvezérlők | Hívás elnémítása és visszahangosítása |
| Videokép be- és kikapcsolása hívás közben | |
| Hívás befejezése | |
| Hívás megtartása és folytatása hangkimaradás után |
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-összetettekkel adhat hozzá egy felhasználót egy Teams-értekezlethez a 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:
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, amikor 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.
Témák
Az iOS és androidos felhasználói felületi kódtár hívási összetettségével létrehozhat egy egyéni témát a hívó felületéről. A platform felületének létrehozásához adja át a következő táblázatban látható színkészletet. További információ: Hogyan hozhatja létre a témát.
| Android | iOS |
|---|---|
|
|
Képernyőméret
Az Azure Communication Services hívási összetettjét úgy alakíthatja át, hogy az 5 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 |
|---|---|
|
|
Honosítás
A honosítás kulcsfontosságú ahhoz, hogy a termékek a világ minden tájáról különböző nyelveket beszélő felhasználók számára készüljenek. 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.
Akadálymentesség
Az akadálymentesség a hívástárak egyik fő fókusza. Képernyőolvasó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 részt vehessenek az alkalmazás használatában.
Adatinjektálás megtekintése
A Natív mobilplatformok felhasználói felületi kódtára 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, a navigáció címét és alcímét a beállítási képernyőn, amikor a hívás elkezdődött. A távoli felhasználók testre szabott avatart hozhatnak létre, amikor csatlakoznak az értekezlethez. További információ: Az értekezlet előtti nézet 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, és kihagyja a hívásillesztési felület beállítási képernyőjét. A felhasználó alapértelmezés szerint egy beállítási képernyőn keresztül csatlakozik egy híváshoz. Itt a felhasználó beállítja 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ás kihagyása képernyőfunkció használata
Csak hang üzemmód
A felhasználói felületi kódtár Csak hang üzemmódja lehetővé teszi a résztvevők számára, hogy csak a hangjukkal 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 hang mód automatikusan letiltja a videofunkciókat a streamek küldéséhez és fogadásához, és 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. Ez a mód a CallComposite konfigurációval engedélyezhető, és további információk érhetők el a csak hangalapú gyorsindításon keresztül
Tájolás
A felhasználói felületi kódtár a képernyő tájolásának beállítását az egyes képernyőkhöz külön-külön támogatja a kódtár-felület elindítása előtt. Ez lehetővé teszi, hogy az alkalmazásfejlesztők rögzített tájolást állítsanak be a hívási felülethez, amely igazítaná az alkalmazás tájolását. Az Android- és iOS-platform támogatott tájolásainak listájáról és az API használatáról további információt a Tájolási funkció használata című témakörben talál .
Multitasking és Picture-in-Picture
A felhasználói felületi kódtár kép módban támogatja a képeket a hívási képernyőhöz. A hívás közben a felhasználó a hívás képernyőjén a Vissza gombra kattintva engedélyezheti a többfeladatos munkavégzést, amely visszaviszi a felhasználót az előző képernyőre. Ha engedélyezve van a Kép a képben funkció, a rendszer képben képben funkció jelenik meg hívásra. Ha többet szeretne megtudni az Android- és iOS-platform többfeladatos és képi megjelenítéséről, valamint az API használatáról, olvassa el a Kép a képben funkció használatát ismertető cikket .
CallKit-támogatás
A felhasználói felületi kódtár támogatja a CallKit-integrációt a CallKittel való kommunikáció kezeléséhez a hívásokhoz. Az iOS-platform integrációjáról és az API használatáról további információt a CallKit használata című témakörben talá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ást, amely a felhasználókat kommunikációs azonosító alapján tárcsázza. A bejövő hívás felhasználói felületi kódtára támogatja a PUSH-értesítések regisztrálását is. Ha többet szeretne megtudni az Android- és iOS-platform integrációjáról és az API használatáról, olvassa el az Egy-az-egyhez hívás kezdeményezése és a PUSH-értesítések fogadása című témakört .
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 | Csatlakozás 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ő 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 kialakítás ú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 felhasználó saját magát igazítaná, és zökkenőmentes felhasználói élményt biztosítana.
| Navigációs nézetben | Modális nézetben |
|---|---|
|
|
Támogatott identitások
Az összetett adatok inicializálásához és a szolgáltatásban való hitelesítéshez 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 felhasználói hozzáférési jogkivonatokhoz hasonlóan saját megbízható szolgáltatásával terjesztheti a környezetet az ügyfeleknek. 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 a környezet ügyfélkódtárhoz való hozzáadásához:
| A Contoso feladatai | Felhasználói felületi kódtár feladatai |
|---|---|
| Hozzáférési jogkivonat megadása az Azure-ból | Az összetevők inicializálásához adja át a megadott hozzáférési jogkivonatot |
| Frissítési függvény megadása | A hozzáférési jogkivonat frissítése fejlesztő által biztosított függvény használatával |
| Csatlakozási adatok lekérése és átadása a híváshoz vagy csevegéshez | Hívás- és csevegési információk átadása az összetevők inicializálásához |
| Felhasználói adatok lekérése és átadása bármely egyéni adatmodellhez | Egyéni adatmodell továbbítása az összetevőknek a rendereléshez |
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 egy CallID-azonosító megadását kéri; ez az azonosító a Communication Services-hívások azonosítására szolgál.
Ez a CallID a hívási képernyő alján található műveletsávon keresztül kérhető le; megjelenik egy három pont gomb; ha a felhasználó végrehajtja a koppintásos műveletet, válassza a "Diagnosztikai adatok megosztása" lehetőséget; a felhasználó megoszthatja azokat a diagnosztikai adatokat, amelyek a támogatási csapat problémáinak nyomon követéséhez szükségesek.
A CallID 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.
A hibaelhárítási irányelvekről itt talál további információt: "Hibaelhárítás az Azure Communication Servicesben" oldal.
| Hívási képernyő | Diagnosztikai információk menü | CallID megosztása |
|---|---|---|
|
|
|