Przypadki użycia biblioteki interfejsu użytkownika

Użyj składników i składników złożonych w bibliotece interfejsu użytkownika usług Azure Communication Services, aby tworzyć środowiska rozmów i czatów w aplikacjach.

W złożonych funkcjach rozmów i czatów jest wbudowana bezpośrednio i uwidoczniona podczas integrowania złożonego z aplikacji. W składniku interfejsu użytkownika możliwości rozmów i czatów są udostępniane za pomocą kombinacji 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 Szybki start i przykładów w podręczniku biblioteki interfejsu użytkownika.

Wywoływanie przypadków użycia

Obszar Przypadki użycia
Typy wywołań Dołącz do spotkania Microsoft Teams
Dołączanie wywołania usług Azure Communication Services przy użyciu identyfikatora grupy
Dołączanie do pokoju usług Azure Communication Services
Uruchamianie połączenia wychodzącego do innego użytkownika usług Azure Communication Services
Rozpoczynanie połączenia wychodzącego na numer telefonu
Współdziałanie usługi Teams Dołącz do lobby połączeń
Wyświetlanie transparentu alertu transkrypcji i rejestrowania
Formanty rozmów telefonicznych Wycisz i anuluj wyciszenie wywołania
Włączanie i wyłączanie wideo podczas połączenia
Włączanie udostępniania ekranu
Kończ połączenie
Galeria uczestników Pokazywanie uczestników zdalnych w siatce
Udostępnianie podglądu wideo przez całe wywołanie użytkownika lokalnego
Udostępnianie domyślnych awatarów, gdy wideo jest wyłączone
Wyświetlanie zawartości ekranu udostępnionego w galerii uczestników
Konfiguracja wywołania Zarządzanie urządzeniem mikrofonu
Zarządzanie urządzeniem aparatu
Zarządzanie urządzeniem mówiącym
Udostępnianie lokalnej wersji zapoznawczej użytkownikowi w celu sprawdzenia wideo
Uczestnicy Pokaż skład uczestnika

Przypadki użycia czatu

Obszar Azure Communication Services Chat Czat dotyczący współdziałania usługi Teams
Typy czatów Dołączanie wątku czatu usług Azure Communication Services Dołączanie do czatu konferencyjnego usługi Microsoft Teams
Akcje czatu Wysyłanie i odbieranie wiadomości SMS Wysyłanie i odbieranie wiadomości SMS
Odbieranie wiadomości tekstowych sformatowanych Odbieranie wiadomości tekstowych sformatowanych
- Odbieranie obrazów wbudowanych*
Wysyłanie i odbieranie załączników plików Odbieranie załączników plików*
Zdarzenia czatu Wskaźniki wysyłania i odbierania wpisywania Wskaźniki wysyłania i odbierania 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

*Obsługa wbudowanych obrazów i załączników plików jest obecnie dostępna 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 z użytkownika usługi Teams może nie być wyświetlana poprawnie.

Obsługiwane tożsamości

Aby zainicjować złożone i uwierzytelnić się w usłudze, użytkownik musi mieć tożsamość usług 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.

Współdziałanie usługi Teams

W przypadku scenariuszy współdziałania usługi Teams możesz użyć złożonych bibliotek interfejsu użytkownika, aby dodać użytkownika do spotkania usługi Teams za pośrednictwem usług komunikacyjnych. Aby włączyć współdziałanie usługi Teams, użyj domyślnych funkcji w wywołaniu złożonym lub złożonym czacie albo użyj składników interfejsu użytkownika do utworzenia środowiska niestandardowego.

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 przyznaniu uczestnika można zainicjować klienta czatu, aby dołączyć do wątku czatu spotkania. Wzorzec przedstawiono na poniższej ilustracji:

Diagram that shows the Teams interoperability pattern for calling and chat.

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 zaproszenie.
  • Baner zgodności. Przykładowy baner pokazujący użytkownika, jeśli jest rejestrowane wywołanie.
  • Motyw aplikacji Teams. Przykładowy motyw, który sprawia, że elementy biblioteki interfejsu użytkownika wyglądają jak Microsoft Teams.
  • Udostępnianie obrazów*. Przykład użytkownika końcowego usługi Azure Communication Service może odbierać obrazy wysyłane przez użytkownika usługi Teams.
  • Udostępnianie plików*. Przykład użytkownika końcowego usługi Azure Communication Service 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 komunikacyjnych. Złożone mają mniej opcji dostosowywania dla prostszego środowiska integracji.

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

Przypadek użycia Kompozyty Komponenty interfejsu użytkownika
Używanie motywów opartych na języku Fluent X X
Tworzenie układu środowiska X
Modyfikowanie właściwości stylu za pomocą stylów CSS X
Zamień ikony X
Modyfikowanie układu galerii uczestników X
Modyfikowanie układu kontrolki wywołań X X
Wstrzykiwanie modeli danych w celu modyfikowania metadanych użytkownika X X

Wgląd w informacje

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. Możesz podłączyć się do klienta stanowego, aby odczytać stan, obsługiwać zdarzenia i przesłonić zachowanie w celu przekazania do składnikó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
Uzyskiwanie dostępu do zdarzeń klienta i obsługa ich X X
Uzyskiwanie dostępu do zdarzeń interfejsu użytkownika i obsługa ich X X

Inicjowanie złożonego i podstawowego składnika przy użyciu tokenu dostępu usług Azure Communication Services. Ważne jest, aby uzyskać tokeny dostępu z usług komunikacyjnych 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.

Diagram that shows the recommended UI Library architecture.

Biblioteki klienta rozmów i czatów muszą mieć kontekst połączenia lub czatu, do którego dołączają. Podobnie jak tokeny dostępu użytkowników, rozpowszechniaj kontekst dla klientów przy użyciu własnej zaufanej usługi.

W poniższej tabeli przedstawiono 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
Podawanie tokenu dostępu z platformy Azure Przekazywanie dostarczonego tokenu dostępu w celu zainicjowania składników
Udostępnianie funkcji odświeżania Odświeżanie tokenu dostępu przy użyciu funkcji udostępnionej przez dewelopera
Pobieranie i przekazywanie informacji o dołączeniu do rozmowy lub czatu Przekazywanie informacji o wywołaniu i czacie w celu zainicjowania składników
Pobieranie i przekazywanie informacji o użytkowniku dla dowolnego niestandardowego modelu danych Przekazywanie niestandardowego modelu danych do składników w celu renderowania

Obsługa platform

SDK Windows macOS Ubuntu Linux Android iOS
Zestaw SDK interfejsu użytkownika Chrome*, Microsoft Edge Chrome*, Safari** Chrome* Chrome* Chrome* 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. Wychodzące wideo dla systemu macOS w przeglądarce Safari nie jest jeszcze obsługiwane, ale jest obsługiwane w systemie iOS. Udostępnianie ekranu wychodzącego jest obsługiwane tylko w systemie iOS dla komputerów stacjonarnych.

Ułatwienia dostępu

Ułatwienia dostępu według projektu są zasadą w produktach 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 i osób, które 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, w tym języków od prawej do lewej. Możesz udostępnić własne pliki lokalizacji do użycia z biblioteką interfejsu użytkownika.

Użyj elementu CallComposite i ChatComposite w bibliotece interfejsu użytkownika usług Azure Communication Services, aby utworzyć środowiska wywołania 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. Złożone w usługach komunikacyjnych zarządzają całym cyklem życia połączenia i czatu, od konfiguracji aż do zakończenia rozmowy i czatu.

Wywoływanie przypadków użycia

Aby utworzyć następujące przypadki użycia, możesz użyć wywołania złożonego w usługach komunikacyjnych:

Obszar Przypadki użycia
Typy wywołań Dołącz do spotkania Microsoft Teams
Dołączanie wywołania przy użyciu identyfikatora grupy
Współdziałanie usługi Teams Dołącz do lobby połączeń
Wyświetlanie transparentu alertu transkrypcji i rejestrowania
Galeria uczestników Pokazywanie uczestników zdalnych w siatce
Udostępnianie podglądu wideo przez całe wywołanie użytkownika lokalnego
Udostępnianie domyślnych awatarów, gdy wideo jest wyłączone
Wyświetlanie zawartości ekranu udostępnionego w galerii uczestników
Włączanie dostosowywania awatara uczestnika
Pokaż skład uczestnika
Konfiguracja wywołania Zarządzanie urządzeniem mikrofonu
Zarządzanie urządzeniem aparatu
Zarządzanie urządzeniem głośnikowym (przewodowym lub Bluetooth)
Udostępnianie lokalnej wersji zapoznawczej użytkownikowi w celu sprawdzenia wideo
Formanty rozmów telefonicznych Wycisz i anuluj wyciszenie wywołania
Włączanie lub wyłączanie wideo podczas połączenia
Kończ połączenie
Wstrzymaj i wznów połączenie po przerwie w działaniu dźwięku

Współdziałanie usługi Teams

W przypadku scenariuszy współdziałania usługi Teams możesz użyć złożonych bibliotek interfejsu użytkownika, aby dodać użytkownika do spotkania usługi Teams za pośrednictwem usług komunikacyjnych. Aby włączyć współdziałanie usługi Teams, użyj wywołania złożonego. Złożony zarządza całym cyklem życia dołączania do wywołania współdziałania usługi Teams.

Diagram that shows the Teams interoperability pattern for call and chat.

Na poniższej ilustracji przedstawiono przykład środowiska użytkownika przed dodaniu obiektu wywołującego do spotkania usługi Teams:

Screenshot that shows the user experience before a caller is added to a Teams meeting.

Wyświetlanie zawartości udostępnionej

Za pośrednictwem biblioteki interfejsu użytkownika dla platform natywnych dla urządzeń przenośnych uczestnicy połączenia mogą wyświetlać udostępnioną zawartość, gdy inni uczestnicy udostępniają ekrany podczas wywołania usługi Teams. Uczestnik zdalny może używać gestów rozciągnięcia i szczypania w celu powiększenia lub powiększenia udostępnionej zawartości w wywołaniu.

Używanie motywów

Możesz użyć złożonego wywołania biblioteki interfejsu użytkownika dla systemów iOS i Android, aby utworzyć niestandardowy motyw środowiska obiektu wywołującego. Aby utworzyć środowisko platformy, przekaż zestaw kolorów motywowych, jak pokazano w poniższej tabeli. Aby uzyskać więcej informacji, zobacz Jak utworzyć motyw.

Android iOS
Screenshot that shows Android theming for a caller experience. Screenshot that shows iOS theming for a caller experience.

Rozmiar ekranu

Wywołanie usług Azure Communication Services można dostosować do rozmiaru ekranu z zakresu od 5 cali do rozmiaru tabletu. Użyj trybu podziału i trybu tabletu w złożonej wywołaniu, aby uzyskać dynamiczny układ składów uczestników, zapewnić przejrzystość widoku i skupić się na konwersacji.

Tryb podziału Tryb tabletu
Screenshot that demonstrates a split-screen view. Screenshot that demonstrates tablet mode.

Lokalizacja

Lokalizacja jest kluczem do tworzenia produktów dla użytkowników na całym świecie i osób, które 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 Jak dodać lokalizację do aplikacji.

Ułatwienia dostępu

Ułatwienia dostępu to kluczowy element bibliotek wywołań. Czytnik zawartości ekranu umożliwia tworzenie ważnych anonsów dotyczących stanu połączenia oraz zapewnienie, że użytkownicy niedowidzący mogą skutecznie uczestniczyć podczas korzystania z aplikacji.

Wyświetlanie iniekcji danych

Użyj biblioteki interfejsu użytkownika dla platform natywnych dla urządzeń przenośnych, aby dać lokalnym i zdalnym uczestnikom opcję dostosowywania sposobu ich wyświetlania jako użytkownicy w wywołaniu. Uczestnik lokalny może wybrać lokalny awatar, niestandardową nazwę wyświetlaną, tytuł nawigacji i podtytuł na ekranie Instalatora po rozpoczęciu wywołania. Użytkownik zdalny może utworzyć dostosowany awatar podczas dołączania do spotkania. Aby uzyskać więcej informacji, zobacz Jak dostosować widok przed spotkaniem.

GIF animation that shows the pre-meeting experience and joining experience on iOS.

Pomiń ekran konfiguracji

Biblioteka interfejsu użytkownika umożliwia dołączanie wywołania pomijając ekran konfiguracji środowiska sprzężenia wywołań. Domyślnie użytkownik przechodzi przez ekran konfiguracji, aby dołączyć do wywołania. W tym miejscu użytkownik ustawia konfigurację wywołania, taką jak włączanie lub wyłączanie aparatu, włączanie lub wyłączanie mikrofonu i wybieranie urządzenia audio przed dołączeniem do połączenia. Ten ekran wymaga interakcji użytkownika w celu dołączenia do wywołania, co może być niepotrzebne dla niektórych użytkowników. Dlatego udostępniamy możliwość dołączenia do wywołania przez pominięcie ekranu konfiguracji i udostępnienie interfejsów API konfiguracji wywołań. Aby uzyskać więcej informacji, zobacz How to use Skip Setup Screen Feature (Jak używać funkcji pomijania ekranu instalacji)

Tryb tylko audio

Tryb tylko audio w bibliotece interfejsu użytkownika umożliwia uczestnikom dołączanie połączeń przy użyciu tylko ich dźwięku bez udostępniania lub odbierania wideo. Ta funkcja służy do oszczędzania przepustowości i maksymalizacji prywatności. Po aktywowaniu tryb tylko dźwięku automatycznie wyłącza funkcje wideo zarówno do wysyłania, jak i odbierania strumieni oraz dostosowuje interfejs użytkownika, aby odzwierciedlał tę zmianę, usuwając kontrolki związane z wideo. Ten tryb można włączyć za pomocą konfiguracji CallComposite. Więcej informacji można znaleźć w przewodniku Szybki start tylko audio

Orientacja

Biblioteka interfejsu użytkownika obsługuje konfigurację orientacji ekranu dla każdego ekranu oddzielnie przed uruchomieniem środowiska biblioteki. Dzięki temu deweloperzy aplikacji mogą skonfigurować stałą orientację dla środowiska wywołującego, które będzie pasować do orientacji aplikacji. Aby dowiedzieć się więcej na temat listy obsługiwanych orientacji dla platformy Android i iOS oraz użycia interfejsu API, zobacz How to use Orientation Feature (Jak używać funkcji orientacji)

Wielozadaniowość i obraz w obrazie

Biblioteka interfejsu użytkownika obsługuje obraz w trybie obrazu dla ekranu wywołania. Będąc w wywołaniu, użytkownik może kliknąć przycisk Wstecz na ekranie wywołania, aby włączyć wielozadaniowość, która zabierze użytkownika z powrotem do poprzedniego ekranu. Jeśli opcja Obraz w obrazie jest włączona, dla wywołania zostanie wyświetlony systemowy obraz w obrazie. Aby dowiedzieć się więcej o wielozadaniowości i obrazie dla platformy Android i iOS oraz użycia interfejsu API, zobacz How to use Picture-in-Picture (Jak używać obrazu w obrazie)

Obsługa zestawu CallKit

Biblioteka interfejsu użytkownika obsługuje integrację biblioteki CallKit w celu obsługi interakcji z zestawem CallKit na potrzeby wywołań. Aby dowiedzieć się więcej na temat integracji platformy i użycia interfejsu API dla systemu iOS, zobacz How to use CallKit (Jak używać zestawu CallKit)

Obsługa połączeń jedno-do-jednego i powiadomień PUSH

Biblioteka interfejsu użytkownika obsługuje jedno-do-jednego wywołanie VoIP w celu wybierania użytkowników według identyfikatora komunikacji. Aby odbierać bibliotekę interfejsu użytkownika połączeń przychodzących, obsługuje również rejestrowanie w celu otrzymywania powiadomień PUSH. Aby dowiedzieć się więcej na temat integracji dla platformy Android i systemu iOS oraz użycia interfejsu API, zobacz How to make one-to-one call and receive PUSH notifications (Jak wykonać wywołanie "jeden do jednego" i otrzymywać powiadomienia PUSH)

Przypadki użycia czatu

Ważne

Ta funkcja usług Azure Communication Services jest obecnie dostępna w 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.

Obszar Przypadki użycia
Typy czatów Dołączanie wątku czatu usług Azure Communication Services
Akcje czatu Wysyłanie wiadomości na czacie
Odbieranie wiadomości czatu
Zdarzenia czatu Pokaż wskaźniki wpisywania
Pokaż potwierdzenie odczytu
Pokaż, kiedy uczestnik zostanie dodany lub usunięty
Pokaż zmiany tytułu czatu

Elastyczność

Element ChatComposite został zaprojektowany tak, aby pasował do różnych układów i widoków w aplikacji. Możesz na przykład umieścić czat w widoku nawigacji, widoku modalnym lub innym widoku. Element ChatComposite dostosuje się i zapewni użytkownikowi bezproblemowe działanie.

W widoku nawigacji W widoku modalnym
an image that shows the chat experience on iOS in a navigation view. an image that shows the chat experience on iOS in a modal view.

Obsługiwane tożsamości

Aby zainicjować złożone i uwierzytelnić się w usłudze, użytkownik musi mieć tożsamość usług 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.

Zainicjuj złożony 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.

Diagram that shows the recommended architecture for UI Library.

Biblioteki klienta rozmów i czatów muszą mieć kontekst połączenia, do którego dołączają. Podobnie jak tokeny dostępu użytkowników, rozpowszechniaj kontekst dla klientów przy użyciu własnej zaufanej usługi. 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
Podawanie tokenu dostępu z platformy Azure Przekazywanie dostarczonego tokenu dostępu w celu zainicjowania składników
Udostępnianie funkcji odświeżania Odświeżanie tokenu dostępu przy użyciu funkcji udostępnionej przez dewelopera
Pobieranie i przekazywanie informacji o dołączeniu do rozmowy lub czatu Przekazywanie informacji o wywołaniu i czacie w celu zainicjowania składników
Pobieranie i przekazywanie informacji o użytkowniku dla dowolnego niestandardowego modelu danych Przekazywanie niestandardowego modelu danych do składników w celu renderowania

Obsługa platform

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

Przewodnik po rozwiązywaniu problemów

Podczas rozwiązywania problemów dotyczących połączeń głosowych lub wideo może zostać wyświetlony monit o podanie identyfikatora CallID. Ten identyfikator służy do identyfikowania połączeń usług komunikacyjnych.

Ten identyfikator CallID można pobrać za pośrednictwem paska akcji w dolnej części ekranu wywołania; zobaczysz przycisk wielokropka; gdy użytkownik wykona akcję naciśnięcia, wybierz opcję "Udostępnij informacje diagnostyczne", a użytkownik może udostępnić informacje diagnostyczne wymagane do śledzenia wszelkich problemów przez zespół pomocy technicznej.

Aby uzyskać dostęp programowy do identyfikatora CallID, zobacz "Jak programowo uzyskać informacje debugowania".

Więcej informacji na temat wytycznych dotyczących rozwiązywania problemów można znaleźć na stronie "Rozwiązywanie problemów w usługach Azure Communication Services".

Ekran wywoływania Menu informacji diagnostycznych Identyfikator wywołania udziału
Screenshot of the call screen during the call. Screenshot of the call screen with the diagnostic options location. Screenshot of showing share Call ID with Contoso.