Przypadki użycia biblioteki interfejsu użytkownika

Użyj składników i kompozytów w Bibliotece UI Azure Communication Services, aby projektować doświadczenia połączeń i chatów w aplikacjach.

W komponencie funkcje rozmów i czatów są wbudowane bezpośrednio i uwidocznione podczas integracji komponentu z aplikacją. W komponencie interfejsu użytkownika funkcje rozmów telefonicznych i czatowania są udostępniane poprzez połączenie funkcji interfejsu użytkownika i podstawowych bibliotek stanowych. Aby w pełni wykorzystać te możliwości, zalecamy używanie składników interfejsu użytkownika z stanowymi wywołaniami i bibliotekami klienta czatu.

Uzyskaj więcej dokumentacji koncepcyjnej, przewodników szybkiego startu i przykładów w storybooku biblioteki interfejsu użytkownika.

Wywoływanie przypadków użycia

Obszar	Przypadki użycia
Typy wywołań	Dołącz do spotkania usługi Microsoft Teams.
	Dołącz do rozmowy w Azure Communication Services za pomocą identyfikatora grupy.
	Dołącz do pokoju usług Azure Communication Services.
	Uruchom wywołanie wychodzące do innego użytkownika usług Azure Communication Services.
	Rozpocznij połączenie wychodzące na numer telefonu.
Interoperacyjność Teams	Dołącz do lobby połączeń.
	Wyświetl transkrypcję i baner informujący o nagrywaniu.
Kontrola połączeń	Wycisz i anuluj wyciszenie połączenia.
	Włącz i wyłącz wideo podczas połączenia.
	Włącz udostępnianie ekranu.
	Zakończ połączenie.
Galeria uczestników	Pokaż uczestników zdalnych w siatce.
	Umożliwienie podglądu wideo przez cały czas trwania połączenia dla użytkownika lokalnego.
	Udostępnij domyślne awatary, gdy film jest wyłączony.
	Pokaż zawartość ekranu udostępnionego w galerii uczestników.
Konfiguracja wywołania	Zarządzanie urządzeniem mikrofonu.
	Zarządzanie urządzeniem aparatu fotograficznego.
	Zarządzanie urządzeniem głośnikowym.
	Udostępnij lokalną wersję zapoznawcza użytkownikowi, aby sprawdzić wideo.
Uczestnicy	Pokaż skład uczestnika.

Przypadki użycia czatu

Obszar	Usługi czatu Azure Communication Services	Czat dotyczący współdziałania usługi Teams
Typy czatów	Dołącz do wątku czatu usług Azure Communication Services.	Dołącz do czatu konferencyjnego usługi Microsoft Teams.
Akcje czatu	Wysyłanie i odbieranie wiadomości SMS.	Wysyłanie i odbieranie wiadomości SMS.
	Wysyłanie i odbieranie wiadomości o bogatym formacie tekstowym.*	Wysyłanie i odbieranie wiadomości o bogatym formacie tekstowym.*
	-	Odbieranie obrazów wbudowanych.
	Wysyłanie i odbieranie załączników plików.	Odbieranie załączników plików.*
Zdarzenia czatu	Wyświetlaj informacje o rozpoczęciu i zakończeniu wpisywania.	Wysyłaj i odbieraj wskaźniki wpisywania.**
	Wysyłanie i odbieranie potwierdzeń odczytu.	Wysyłanie i odbieranie potwierdzeń odczytu.
	Pokaż, kiedy uczestnik zostanie dodany lub usunięty.	Pokaż, kiedy uczestnik zostanie dodany lub usunięty.
Uczestnicy	Pokaż skład uczestnika.	Pokaż skład uczestnika.

Wysyłanie sformatowanych wiadomości tekstowych i obsługa załączników plików są obecnie dostępne w publicznej wersji zapoznawczej. Interfejsy API i zestawy SDK w wersji zapoznawczej są udostępniane bez umowy dotyczącej poziomu usług. Zalecamy, aby nie używać ich w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zapoznaj się z dodatkowymi warunkami użytkowania dla wersji zapoznawczych platformy Microsoft Azure.

Nazwa wyświetlana zdarzenia wpisywania przez użytkownika Teams może nie być poprawnie pokazana.

Wspierane tożsamości

Aby zainicjować komponent i uwierzytelnić się w usłudze, użytkownik musi mieć tożsamość Azure Communication Services. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie w usługach Azure Communication Services i Szybki start: tworzenie tokenów dostępu i zarządzanie nimi.

Interoperacyjność Teams

W przypadku scenariuszy współdziałania usługi Teams możesz użyć złożonych bibliotek interfejsów użytkownika, aby dodać użytkownika do spotkania usługi Teams za pośrednictwem usług Azure Communication Services. Aby włączyć współdziałanie usługi Teams, użyj domyślnych funkcji w ramach kompozycji połączeń lub kompozycji czatu. Możesz również użyć składników interfejsu użytkownika do stworzenia niestandardowej wersji interfejsu.

Podczas dodawania połączenia i czatu do aplikacji należy pamiętać, że klient czatu nie może zostać zainicjowany, dopóki uczestnik nie zostanie przyjęty do połączenia. Po dopuszczeniu uczestnika możesz uruchomić klienta czatu, aby dołączyć do wątku czatu spotkania. Wzorzec przedstawiono na poniższej ilustracji.

Jeśli używasz składników interfejsu użytkownika do dostarczania środowisk współdziałania usługi Teams, zacznij od użycia przykładów biblioteki interfejsu użytkownika, aby utworzyć kluczowe elementy środowiska:

• Przykład lobby: przykładowe lobby, w którym uczestnik może czekać na przyjęcie do rozmowy.
• Baner zgodności: przykładowy baner pokazujący użytkownika, jeśli połączenie jest rejestrowane.
• Motyw aplikacji Teams: przykładowy motyw, który sprawia, że elementy biblioteki interfejsu użytkownika wyglądają podobnie do aplikacji Microsoft Teams.
• Udostępnianie obrazów*: przykład pokazujący, jak użytkownik usług Azure Communication Services może odbierać obrazy wysyłane przez użytkownika usługi Teams.
• Udostępnianie plików*: przykład pokazujący, jak użytkownik usług Azure Communication Services może odbierać załączniki plików wysyłane przez użytkownika usługi Teams.

Dostosowanie

Wzorce bibliotek interfejsu użytkownika umożliwiają modyfikowanie składników w celu dopasowania wyglądu i działania aplikacji. Dostosowywanie to kluczowa różnica między składnikami złożonymi i składnikami interfejsu użytkownika w usługach Azure Communication Services. Kompozyty mają mniej opcji dostosowywania, aby ułatwić proces integracji.

W poniższej tabeli porównaliśmy składniki złożone i składniki interfejsu użytkownika na potrzeby przypadków użycia dostosowywania.

Przypadek użycia	Kompozyty	Komponenty interfejsu użytkownika
Używaj motywów opartych na języku Fluent.	X	X
Utwórz układ doświadczenia.		X
Użyj stylów CSS, aby zmodyfikować właściwości stylu.		X
Zamień ikony.		X
Zmodyfikuj układ galerii uczestników.		X
Zmodyfikuj układ kontrolki wywołań.	X	X
Wstrzykiwanie modeli danych w celu modyfikowania metadanych użytkownika.	X	X

Obserwowalność

Architektura zarządzania stanem biblioteki interfejsu użytkownika jest oddzielona, dzięki czemu można uzyskać bezpośredni dostęp do stanowych połączeń i klientów czatów. Podłącz klienta stanowego, aby odczytać stan, obsługiwać zdarzenia i modyfikować zachowanie przed przekazaniem do komponentów interfejsu użytkownika.

W poniższej tabeli porównaliśmy składniki złożone i składniki interfejsu użytkownika pod kątem przypadków użycia możliwości obserwowania.

Przypadek użycia	Kompozyty	Komponenty interfejsu użytkownika
Uzyskiwanie dostępu do połączenia i stanu klienta czatu.	X	X
Obsługuj zdarzenia klienta i zarządzaj nimi.	X	X
Uzyskiwanie dostępu do zdarzeń interfejsu użytkownika i obsługa ich.	X	X

Zalecana architektura

Inicjowanie składnika złożonego i składnika podstawowego przy użyciu tokenu dostępu usług Azure Communication Services. Ważne jest, aby uzyskać tokeny dostępu z usług Azure Communication Services za pośrednictwem zaufanej usługi, którą zarządzasz. Aby uzyskać więcej informacji, zobacz Szybki start: tworzenie tokenów dostępu i zarządzanie nimi oraz samouczek dotyczący zaufanej usługi.

Biblioteki klienta do rozmów i czatów muszą mieć kontekst połączenia lub czatu, do którego dołączają. Rozpowszechniaj kontekst dla klientów przy użyciu własnej zaufanej usługi. Na przykład użyj tokenów dostępu użytkowników.

Poniższa tabela zawiera podsumowanie funkcji inicjowania i zarządzania zasobami, które są wymagane do dodania kontekstu do biblioteki klienta.

Obowiązki firmy Contoso	Obowiązki dotyczące biblioteki interfejsu użytkownika
Podaj token dostępu z platformy Azure.	Przekaż udostępniony token dostępu, aby zainicjować składniki.
Podaj funkcję odświeżania.	Odśwież token dostępu przy użyciu funkcji udostępnionej przez dewelopera.
Pobierz i przekaż informacje o uczestniczeniu w rozmowie lub czacie.	Przekaż informacje o wywołaniu i czacie, aby zainicjować komponenty.
Pobieranie i przekazywanie informacji o użytkowniku dla dowolnego niestandardowego modelu danych.	Przekaż niestandardowy model danych do komponentów w celu renderowania.

Wsparcie platformy

Zestaw do tworzenia oprogramowania	Windows	macOS	Ubuntu	Linuxa	Android	Ios
Zestaw SDK interfejsu użytkownika	Przeglądarka Chrome*, Microsoft Edge	Przeglądarka Chrome*, przeglądarka Safari**	Chrom*	Chrom*	Chrom*	Safari**

*Obsługiwana jest bieżąca wersja programu Chrome i dwie poprzednie wersje.

**Obsługiwane są przeglądarki Safari w wersji 13.1 lub nowszej. Funkcja przesyłania wychodzącego wideo nie jest jeszcze obsługiwana w przeglądarce Safari na macOS, ale jest obsługiwana na iOS. Udostępnianie ekranu wychodzącego jest obsługiwane tylko w systemie iOS dla komputerów stacjonarnych.

Ułatwienia dostępu

Zasada projektowania z myślą o dostępności to podstawa produktów firmy Microsoft. Biblioteka interfejsu użytkownika jest zgodna z tą zasadą, a wszystkie składniki interfejsu użytkownika są w pełni dostępne.

Lokalizacja

Lokalizacja jest kluczem do tworzenia produktów dla użytkowników na całym świecie, którzy mówią w różnych językach. Biblioteka interfejsu użytkownika zapewnia domyślną obsługę niektórych języków i możliwości. Ta obsługa obejmuje języki od prawej strony do lewej. Możesz dostarczyć własne pliki lokalizacyjne do wykorzystania z biblioteką interfejsu użytkownika.

Znane problemy

Biblioteka interfejsu użytkownika nie obsługuje aktualizowania typu komunikatu podczas edytowania istniejących komunikatów w tej chwili. Dodawanie bogatego formatowania tekstu do istniejącej wiadomości dodaje styl HTML do zawartości tekstowej. Ponieważ typ komunikatu nie zmienia się, wynik może być zawartością HTML, która jest wyświetlana jako zwykły tekst w wątku wiadomości.

Użyj CallComposite i ChatComposite w bibliotece interfejsu użytkownika Azure Communication Services, aby tworzyć doświadczenia wywołań w aplikacjach systemów iOS i Android. Korzystając z kilku wierszy kodu, można łatwo zintegrować całe środowisko rozmów i czatów w aplikacji. Kompozyty w usługach Azure Communication Services zarządzają całym cyklem życia rozmowy i czatu, od konfiguracji do momentu zakończenia rozmowy i czatu.

Wywoływanie scenariuszy użycia

Użyj kompozycji wywołań w Azure Communication Services, aby utworzyć te przypadki użycia.

Obszar	Przypadki użycia
Typy wywołań	Dołącz do spotkania usługi Microsoft Teams.
	Dołącz do spotkania usługi Microsoft Teams przy użyciu identyfikatora spotkania i kodu dostępu.
	Dołącz do rozmowy przy użyciu identyfikatora grupy.
	Dołącz do połączenia za pomocą identyfikatora pokoju.
	Wykonaj i odbierz połączenia 1:1.
Interoperacyjność Teams	Dołącz do lobby połączeń.
	Wyświetl transkrypcję i baner informujący o nagrywaniu.
	Przyznaj lub odrzuć uczestników lobby.
Napisy dla niesłyszących	Współdziałanie Teams.
	Połączenie grupowe, połączenie w pokojach i połączenie 1:1.
Galeria uczestników	Pokaż uczestników zdalnych w siatce.
	Umożliwienie podglądu wideo przez cały czas trwania połączenia dla użytkownika lokalnego.
	Udostępnij domyślne awatary, gdy film jest wyłączony.
	Pokaż zawartość ekranu udostępnionego w galerii uczestników.
	Włącz dostosowywanie awatara uczestnika.
	Pokaż skład uczestnika.
Zarządzanie połączeniami	Zarządzanie urządzeniem mikrofonu.
	Zarządzanie urządzeniem aparatu fotograficznego.
	Zarządzanie urządzeniem głośnikowym (przewodowym lub Bluetooth).
	Udostępnij lokalną wersję zapoznawczą użytkownikowi w celu sprawdzenia wideo.
	Subskrypcja zdarzeń.
Kontrola połączeń	Wycisz i anuluj wyciszenie połączenia.
	Włącz lub wyłącz wideo podczas połączenia.
	Zakończ połączenie.
	Wstrzymaj i wznów połączenie po przerwie w dźwięku.
	Obsługa CallKit i TelecomManager.
Dostosowywanie środowiska	Dostosowywanie paska przycisków.
	Konfiguracja tytułu i podtytułu.
	Włącz okno dialogowe potwierdzenia zakończenia rozmowy.
	Pomiń ekran konfiguracji.

Integracja połączeń

W tej sekcji omawiana jest integracja połączeń.

Interoperacyjność Teams

W przypadku scenariuszy współdziałania usługi Teams możesz użyć złożonych bibliotek interfejsów użytkownika, aby dodać użytkownika do spotkania usługi Teams za pośrednictwem usług Azure Communication Services. Aby włączyć współdziałanie usługi Teams, użyj wywołania złożonego. Komponent zarządza całym procesem dołączania do rozmowy interoperacyjnej w Teams.

Na poniższej ilustracji przedstawiono przykład doświadczenia użytkownika przed dodaniem rozmówcy do spotkania w Teams.

Integracja pomieszczeń

Usługi Azure Communication Services udostępniają koncepcję pokoju dla deweloperów, którzy budują ustrukturyzowane konwersacje, takie jak terminy wirtualne lub wydarzenia wirtualne. Pokoje umożliwiają obecnie nawiązywanie połączeń głosowych i wideo.

Pomieszczenie to kontener, który zarządza działaniami między użytkownikami usług Azure Communication Services. Pokój oferuje deweloperom aplikacji lepszą kontrolę nad tym, kto może dołączyć do połączenia, kiedy się spotykają i jak współpracują. Aby dowiedzieć się więcej o pokojach, zobacz dokumentację koncepcyjną.

Użytkownik jest zapraszany do pokoju za pomocą interfejsu API Rooms w jednej z trzech następujących ról:

• Prezenter (ustawienie domyślne)
• Uczestnik
• Konsument

Rozróżnienie między poszczególnymi rolami polega na zdolnościach, które każda z nich posiada podczas rozmowy w pokoju, gdy używane jest CallComposite. Konkretne możliwości skojarzone z każdą rolą są opisane w temacie Omówienie pomieszczeń wirtualnych.

Obsługa połączeń jeden-na-jeden i powiadomień push

Biblioteka interfejsu użytkownika obsługuje wywołania voIP typu jeden do jednego w celu wybierania użytkowników według identyfikatora komunikacji. Aby odbierać połączenie przychodzące, biblioteka interfejsu użytkownika obsługuje również rejestrowanie powiadomień PUSH . Aby dowiedzieć się więcej na temat integracji z platformami Android i iOS oraz korzystania z interfejsu API, zobacz Make a one-to-one call and receive PUSH notifications (Tworzenie połączenia jeden do jednego i odbieranie powiadomień PUSH).

Funkcje połączeń

Dostępnych jest kilka funkcji do dzwonienia.

Ułatwienia dostępu

Ułatwienia dostępu to kluczowy element bibliotek wywołań. Użyj czytnika zawartości ekranu, aby udostępnić ważne ogłoszenia dotyczące stanu połączenia i zapewnić, że użytkownicy niedowidzący mogą skutecznie uczestniczyć podczas korzystania z aplikacji.

Napisy dla niesłyszących

Napisy zamknięte umożliwiają szeroką gamę scenariuszy, w tym współpracę z Teams, grupowe połączenia w Azure Communication Services, połączenia pokojowe i połączenia indywidualne. Ta funkcja zapewnia, że użytkownicy mogą śledzić konwersacje w różnych środowiskach rozmów telefonicznych, poprawiając dostępność i doświadczenie użytkownika.

Użytkownicy muszą ręcznie wybrać język podpisów przy użyciu biblioteki interfejsu użytkownika gotowej do użycia, ponieważ system nie wykrywa automatycznie języka mówionego.

Aby uzyskać więcej informacji na temat napisów zamkniętych, zobacz dokumentację , aby zapoznać się z wyjaśnieniami i wytycznymi dotyczącymi użycia. Jeśli chcesz skonfigurować napisy dla niesłyszących bezpośrednio w bibliotece interfejsu użytkownika, skorzystaj z samouczka, aby łatwo je skonfigurować.

Zdarzenia

Deweloperzy mogą teraz subskrybować zdarzenia w ramach CallComposite właściwości. Dzięki tej funkcji mogą dołączać odbiorniki do określonych zdarzeń w całym cyklu życia rozmowy. To ulepszenie zapewnia większą kontrolę i możliwości dostosowywania. Deweloperzy mogą wyzwalać akcje niestandardowe na podstawie zdarzeń, takich jak dołączenie uczestnika lub opuszczenie połączenia przez uczestnika. Mogą również używać zdarzeń do rejestrowania interakcji, dynamicznego aktualizowania interfejsów użytkownika lub zwiększania ogólnej funkcjonalności.

Aby uzyskać więcej informacji, zobacz Obsługa zdarzeń w bibliotece interfejsu użytkownika.

Lokalizacja

Lokalizacja jest kluczem do tworzenia produktów dla użytkowników na całym świecie, którzy mówią w różnych językach. Biblioteka interfejsu użytkownika obsługuje 12 języków: angielski, hiszpański, francuski, niemiecki, włoski, japoński, koreański, holenderski, portugalski, rosyjski, turecki i chiński. Obsługuje również języki od prawej do lewej. Aby uzyskać więcej informacji, zobacz Dodawanie lokalizacji do aplikacji.

Tryb wielozadaniowości oraz tryb obrazu w obrazie

Biblioteka interfejsu użytkownika obsługuje tryb obraz-w-obraz dla ekranu połączenia. Podczas rozmowy użytkownicy mogą wcisnąć przycisk Wstecz na ekranie rozmowy, aby włączyć wielozadaniowość i wrócić do poprzedniego ekranu. Jeśli tryb obrazu w obrazie jest włączony, dla rozmowy pojawi się systemowy obraz w obrazie. Aby dowiedzieć się więcej na temat wielozadaniowości i trybu obrazu w obrazie zarówno dla platform Android, jak i iOS oraz korzystania z interfejsu API, zobacz Włączanie obrazu w obrazie przy użyciu biblioteki interfejsu użytkownika.

Orientacja ekranu

Biblioteka interfejsu użytkownika obsługuje konfigurację orientacji ekranu dla każdego z ekranów oddzielnie przed rozpoczęciem korzystania z biblioteki. Deweloperzy aplikacji mogą skonfigurować stałą orientację dla doświadczenia związanego z połączeniami, co dostosuje orientację aplikacji. Aby dowiedzieć się więcej na temat listy obsługiwanych orientacji dla platform Android i iOS oraz korzystania z interfejsu API, zobacz Ustawianie orientacji ekranu przy użyciu biblioteki interfejsu użytkownika.

Rozmiar ekranu

Dostosuj złożony element połączenia usługi Azure Communication Services, aby dostosować się do rozmiarów ekranów od pięciu cali do wielkości tabletu. Użyj trybu podziału i trybu tabletu w kompozycji połączenia, aby uzyskać dynamiczny układ listy uczestników, zapewnić przejrzystość widoku i skoncentrować się na rozmowie.

Tryb podziału	Tryb tabletu

Wyświetlanie iniekcji danych

Użyj biblioteki interfejsu użytkownika dla rodzimych platform mobilnych, aby dać lokalnym i zdalnym uczestnikom możliwość dostosowywania sposobu, w jaki są widoczni w rozmowie. Uczestnik lokalny może wybrać lokalny awatar, niestandardową nazwę wyświetlaną oraz tytuł i podtytuł nawigacji na ekranie konfiguracji, kiedy rozpoczyna się połączenie. Użytkownik zdalny może utworzyć dostosowany awatar podczas dołączania do spotkania. Aby uzyskać więcej informacji, zobacz Wstrzykiwanie niestandardowego modelu danych w Bibliotece UI.

Wyświetlanie zawartości udostępnionej

Za pośrednictwem biblioteki API dla mobilnych platform natywnych uczestnicy rozmowy w Teams mogą oglądać udostępnioną zawartość, gdy inni uczestnicy udostępniają swoje ekrany podczas rozmowy. Uczestnik zdalny może używać gestów rozciągania i szczypania, aby powiększać lub pomniejszać udostępnioną zawartość podczas połączenia.

Integracje systemu operacyjnego

Integracja z systemem operacyjnym.

Obsługa zestawu CallKit

Biblioteka interfejsu użytkownika obsługuje CallKit integrację do obsługi interakcji z CallKit połączeń. Aby dowiedzieć się więcej na temat integracji z platformą iOS i korzystania z interfejsu API, zobacz Integracja CallKit z biblioteką interfejsu użytkownika.

Obsługa usługi TelecomManager

Biblioteka interfejsu użytkownika teraz umożliwia integrację z TelecomManager i obsługę funkcji wstrzymywania i wznawiania wywołań. Aby dowiedzieć się więcej na temat integracji platformy Android i korzystania z interfejsu API, zobacz Integrowanie programu TelecomManager z biblioteką interfejsu użytkownika.

Dostosowywanie wrażeń podczas rozmowy telefonicznej

Możesz dostosować swoje doświadczenie związane z połączeniem.

Tryb tylko dźwiękowy

Tryb tylko audio w bibliotece interfejsu użytkownika umożliwia uczestnikom przyłączenie się do rozmów, korzystając wyłącznie z dźwięku, bez udostępniania lub odbierania wideo. Ta funkcja służy do oszczędzania przepustowości i maksymalizacji prywatności. Po aktywacji trybu audio automatycznie wyłączane są funkcje wideo zarówno dla wysyłania, jak i odbierania strumieni. Dostosowuje interfejs użytkownika w celu odzwierciedlenia tej zmiany przez usunięcie kontrolek związanych z wideo. Włącz ten tryb za pomocą CallComposite konfiguracji. Aby uzyskać więcej informacji, zobacz przewodnik „Szybki start audio-only”.

Wyłączanie monitu o zakończenie połączenia

Podczas tworzenia aplikacji integrujących możliwości wywoływania kluczowe znaczenie ma zapewnienie bezproblemowego i intuicyjnego środowiska użytkownika. Jednym z obszarów, w którym można usprawnić środowisko użytkownika, jest proces kończenia wywołań. W szczególności deweloperzy mogą uważać, że korzystne jest wyłączenie lewego monitu potwierdzenia wywołania, który pojawia się, gdy użytkownik chce zakończyć połączenie. Ta funkcja, choć przydatna w zapobieganiu przypadkowym zakończeniom wywołań, czasami może utrudnić środowisko użytkownika, zwłaszcza w środowiskach, w których szybkość i wydajność mają kluczowe znaczenie. Aby uzyskać więcej informacji, spójrz na Wyłączanie potwierdzenia wywołania.

Dynamiczne środowiska komunikacyjne: w miejscach, takich jak parkiety handlowe, centra telefoniczne służb ratunkowych lub centra obsługi klienta, decyzje i działania muszą być wykonywane szybko. Dodatkowy krok potwierdzania zakończenia wywołań może utrudniać wydajność przepływu pracy.

Dostosowywanie paska przycisków

Funkcja umożliwia deweloperom dodawanie nowych akcji do menu kontekstowego lub usuwanie bieżących przycisków na pasku przycisków. Mogą one zapewnić elastyczność wprowadzania akcji niestandardowych i dostosowywania interfejsu użytkownika zgodnie z określonymi potrzebami aplikacji.

• Dodawanie przycisków niestandardowych: Deweloperzy mogą wprowadzać nowe przyciski na pasku przycisków kontekstowych w celu wyzwolenia akcji niestandardowych.
• Usuń istniejące przyciski: Deweloperzy mogą usuwać niepotrzebne przyciski domyślne, aby usprawnić interfejs, taki jak aparat, mikrofon lub wybór dźwięku.

Podczas implementacji tej funkcji należy wziąć pod uwagę następujące ograniczenia:

• Ikony i etykiety: Ikony są dodawane tylko dla nowych akcji. Ikony paska przycisków zachowują wstępnie zdefiniowane ikony, a etykiety powinny być zwięzłe, aby dopasować je do wymiaru menu.
• Zagadnienia dotyczące ułatwień dostępu: Deweloperzy powinni upewnić się, że wszystkie przyciski niestandardowe są dostępne, w tym odpowiednie etykietowanie dla czytników zawartości ekranu.

Usuń przyciski	Dodawanie akcji niestandardowych

Przypadki użycia

• Niestandardowe akcje podczas połączenia: aplikacja biznesowa może dodać niestandardowy przycisk Zgłoś problem, który umożliwia użytkownikom bezpośrednie zgłaszanie problemów technicznych podczas połączenia.
• Branding i doświadczenie użytkownika: Aplikacja dla przedsiębiorstw może usuwać przyciski, które są nieistotne dla jej zastosowania, i dodawać przyciski z brandingiem, które poprawiają doświadczenie użytkownika.

Aby zapewnić spójne środowisko wywołań, zalecamy zintegrowanie ikon interfejsu użytkownika Fluent z projektem. Są one dostępne w repozytorium Fluent UI GitHub. Dzięki temu Twoje ikony niestandardowe będą pasować do projektu właściwości CallComposite, co stworzy spójny i profesjonalny wygląd.

Najlepsze rozwiązania

• Czysty projekt: Unikaj przepełnienia paska menu kontekstowego. Dodaj tylko przyciski, które są niezbędne dla środowiska użytkownika.
• Testowanie użytkowników: przeprowadź testowanie użytkowników, aby upewnić się, że dostosowania spełniają potrzeby użytkowników i nie należy ich mylić ani przeciążać.
• Mechanizm opinii: dodawanie przycisków, takich jak Zgłoś problem , zapewnia, że niezawodny system zaplecza jest dostępny do obsługi zebranych opinii. Ponownie wykorzystaj mechanizm, który biblioteka interfejsu użytkownika udostępnia domyślnie.

Aby uzyskać więcej informacji, zobacz Dostosowywanie przycisków.

Pomiń ekran konfiguracji

Biblioteka UI umożliwia dołączenie do rozmowy, pomijając ekran konfiguracji dołączania do rozmowy. Domyślnie przechodzisz przez ekran konfiguracji, aby dołączyć do rozmowy. W tym miejscu należy ustawić konfigurację połączenia, taką jak włączanie lub wyłączanie aparatu, włączanie lub wyłączanie mikrofonu oraz wybór urządzenia audio przed dołączeniem do połączenia. Ten ekran wymaga interakcji użytkownika w celu dołączenia do rozmowy, co dla niektórych użytkowników może być zbędne. Dlatego udostępniamy możliwość dołączenia do rozmowy przy pominięciu ekranu konfiguracji oraz udostępnienie interfejsów API konfiguracji rozmowy. Aby uzyskać więcej informacji, zobacz funkcja pomijania ekranu konfiguracji.

Motywy i kolory

Użyj kompozytu biblioteki interfejsu użytkownika na systemach iOS i Android, aby stworzyć niestandardowy motyw doświadczenia użytkownika jako dzwoniącego. Masz elastyczność dostosowywania kolorów podstawowych, dzięki czemu można dostosować schemat kolorów w celu dopasowania ich do określonych potrzeb związanych z marką. Dostosowując kolory podstawowe, możesz upewnić się, że interfejs integruje się z tożsamością wizualną marki. Możesz ulepszyć środowisko użytkownika, zachowując spójność w aplikacjach. Aby uzyskać więcej informacji, zobacz Tworzenie motywu.

Android	Ios

Tytuł i podtytuł

Użyj biblioteki interfejsu użytkownika, aby wprowadzić niestandardowe ciągi, co ułatwia dostosowanie interfejsu wywołania do konkretnych potrzeb. Tytuł i podtytuł wywołania można dostosować zarówno w fazie konfiguracji, jak i podczas wykonywania wywołania.

Na przykład w środowisku firmowym można ustawić tytuł, aby odzwierciedlić plan spotkania i podtytuł, aby wskazać ogłoszenie. W przypadku obsługi klienta agenci mogą używać tytułów do wyświetlania charakteru zapytania w celu zwiększenia przejrzystości i komunikacji.

Podczas wywołań z dyskusjami z uwzględnieniem czasu można również użyć podtytułu, aby wyświetlić czas trwania wywołania, aby upewnić się, że wszyscy uczestnicy są świadomi ograniczeń czasowych.

Aby uzyskać więcej informacji, zobacz Konfigurowanie tytułu i podtytułu.

---

Przypadki użycia czatu

Obszar	Przypadki użycia
Typy czatów	Dołącz do wątku czatu usług Azure Communication Services.
Akcje czatu	Wyślij wiadomość czatu.
	Otrzymuj wiadomość na czacie.
Zdarzenia czatu	Pokaż wskaźniki wpisywania.
	Pokaż potwierdzenie odczytu.
	Pokaż, kiedy uczestnik zostanie dodany lub usunięty.
	Pokaż zmiany tytułu czatu.

Elastyczność

Właściwość ChatComposite została zaprojektowana tak, aby pasować do różnych układów i widoków w Twojej aplikacji. Na przykład, możesz umieścić Chat w widoku nawigacji, widoku modalnym lub innym widoku. Właściwość ChatComposite dostosowuje się i zapewnia, że użytkownik korzysta z płynnego doświadczenia.

Widok nawigacji	Widok modalny

Wspierane tożsamości

Aby zainicjować komponent i uwierzytelnić się w usłudze, użytkownik musi mieć tożsamość Azure Communication Services. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie w usługach Azure Communication Services i Szybki start: tworzenie tokenów dostępu i zarządzanie nimi.

Zalecana architektura

Zainicjuj kompozyt, używając tokenu dostępu do usług Azure Communication Services. Ważne jest, aby uzyskać tokeny dostępu z usług Azure Communication Services za pośrednictwem zaufanej usługi, którą zarządzasz. Aby uzyskać więcej informacji, zobacz Szybki start: tworzenie tokenów dostępu i zarządzanie nimi oraz samouczek dotyczący zaufanej usługi.

Biblioteki klienta do rozmów głosowych i czatów muszą mieć kontekst połączenia, do którego dołączają. Rozpowszechniaj kontekst dla klientów przy użyciu własnej zaufanej usługi. Na przykład użyj tokenów dostępu użytkowników. Poniższa tabela zawiera podsumowanie funkcji inicjowania i zarządzania zasobami, które są wymagane do dodania kontekstu do biblioteki klienta.

Obowiązki firmy Contoso	Obowiązki dotyczące biblioteki interfejsu użytkownika
Podaj token dostępu z platformy Azure.	Przekaż udostępniony token dostępu, aby zainicjować składniki.
Podaj funkcję odświeżania.	Odśwież token dostępu przy użyciu funkcji udostępnionej przez dewelopera.
Pobierz i przekaż informacje o uczestniczeniu w rozmowie lub czacie.	Przekaż informacje o wywołaniu i czacie, aby zainicjować komponenty.
Pobieranie i przekazywanie informacji o użytkowniku dla dowolnego niestandardowego modelu danych.	Przekaż niestandardowy model danych do komponentów w celu renderowania.

Wsparcie platformy

Platforma	Wersje
Ios	System iOS 14 lub nowszy
Android	API 21 i nowsze

Przewodnik po rozwiązywaniu problemów

W przypadku rozwiązywania problemów dotyczących połączeń głosowych lub wideo może zostać wyświetlony monit o podanie identyfikatora połączenia. Ten identyfikator służy do identyfikowania wywołań usług Azure Communication Services.

Aby pobrać ten identyfikator rozmowy, użyj paska akcji na dole ekranu rozmowy. Wybierz przycisk wielokropka, aby wyświetlić Udostępnij informacje diagnostyczne. Użyj tej opcji, aby udostępnić informacje diagnostyczne wymagane do śledzenia wszelkich problemów przez zespół pomocy technicznej.

Aby uzyskać programowy dostęp do identyfikatora wywołania, zobacz Programowe pobieranie informacji debugowania.

Aby uzyskać więcej informacji na temat rozwiązywania problemów, zobacz Rozwiązywanie problemów w usługach Azure Communication Services.

Ekran połączeń	Menu informacji diagnostycznych	Identyfikator połączenia do udostępnienia