Włączanie udostępniania plików przy użyciu biblioteki interfejsu użytkownika w czacie współdziałania usługi Teams - An Azure Communication Services tutorial

Artykuł
04/20/2024

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.

W aplikacji Teams Interoperability Chat ("Interop Chat") możemy włączyć udostępnianie plików między użytkownikami końcowymi usług Azure Communication Services i użytkownikami usługi Teams. Należy pamiętać, że czat interop różni się od czatu usług Azure Communication Services. Jeśli chcesz włączyć udostępnianie plików w czacie usług Azure Communication Services, zapoznaj się z artykułem Dodawanie udostępniania plików za pomocą biblioteki interfejsu użytkownika w czacie usług Azure Communication Services. Obecnie użytkownik końcowy usług Azure Communication Services może odbierać tylko załączniki plików od użytkownika usługi Teams. Aby dowiedzieć się więcej, zapoznaj się z tematem Przypadki użycia biblioteki interfejsu użytkownika.

Ważne

Funkcja udostępniania plików jest dostarczana z funkcją CallWithChat Composite bez dodatkowych konfiguracji.

Pobieranie kodu

Uzyskaj dostęp do kodu tego samouczka w witrynie GitHub.

Wymagania wstępne

Konto platformy Azure z aktywną subskrypcją. Aby uzyskać szczegółowe informacje, zobacz Tworzenie bezpłatnego konta.
Program Visual Studio Code na jednej z obsługiwanych platform.
Node.js, wersje Active LTS i Maintenance LTS. Użyj polecenia , node --version aby sprawdzić wersję.
Aktywny zasób usług komunikacyjnych i parametry połączenia. Utwórz zasób usług komunikacyjnych.
Korzystając z biblioteki interfejsu użytkownika w wersji 1.7.0-beta.1 lub najnowszej.
Utwórz spotkanie usługi Teams i przygotuj link do spotkania.
Zapoznaj się ze sposobem działania aplikacji ChatWithChat Composite .

Tło

Przede wszystkim musimy zrozumieć, że obecnie czat interop usługi Teams musi być częścią spotkania usługi Teams. Gdy użytkownik usługi Teams utworzy spotkanie online, zostanie utworzony i skojarzony z nim wątek czatu. Aby umożliwić użytkownikowi końcowemu usług Azure Communication Services dołączanie do czatu i rozpoczynanie wysyłania/odbierania wiadomości, uczestnik spotkania (użytkownik usługi Teams) musi najpierw przyznać je do połączenia. W przeciwnym razie nie mają dostępu do czatu.

Gdy użytkownik końcowy usług Azure Communication Services zostanie przyjęty do połączenia, będzie mógł rozpocząć rozmowę z innymi uczestnikami połączenia. W tym samouczku dowiesz się, jak działa wbudowany obraz w rozmowie międzyoperacyjnej.

Omówienie

Podobnie jak w przypadku dodawania obsługi obrazów wbudowanych do biblioteki interfejsu użytkownika, potrzebujemy utworzonego złożonego CallWithChat obrazu. Użyjmy podstawowego przykładu ze strony storybook, aby utworzyć plik ChatWithChat Composite.

W przykładowym kodzie potrzebny CallWithChatExamplePropsjest element , który jest zdefiniowany jako następujący fragment kodu:

export type CallWithChatExampleProps = {
  // Props needed for the construction of the CallWithChatAdapter
  userId: CommunicationUserIdentifier;
  token: string;
  displayName: string;
  endpointUrl: string;
  locator: TeamsMeetingLinkLocator | CallAndChatLocator;

  // Props to customize the CallWithChatComposite experience
  fluentTheme?: PartialTheme | Theme;
  compositeOptions?: CallWithChatCompositeOptions;
  callInvitationURL?: string;
};

Aby móc uruchomić złożony czat na spotkanie, musimy przekazać TeamsMeetingLinkLocatorelement , który wygląda następująco:

{ "meetingLink": "<TEAMS_MEETING_LINK>" }

To wszystko, czego potrzebujesz — i nie trzeba konfigurować innej konfiguracji, aby umożliwić użytkownikowi końcowemu usług Azure Communication Services odbieranie załączników plików od użytkownika usługi Teams!

Uprawnienia

Gdy plik jest udostępniany z klienta usługi Teams, użytkownik usługi Teams ma opcje ustawiania uprawnień do pliku na:

"Każdy"
"Osoby w organizacji"
"Osoby obecnie w tym czacie"
"Osoby z istniejącym dostępem"
"Osoby wybrać"

W szczególności biblioteka interfejsu użytkownika obsługuje obecnie tylko "Każdy" i "Osoby wybierzesz" (z adresem e-mail), a wszystkie inne uprawnienia nie są obsługiwane. Jeśli użytkownik usługi Teams wysłał plik z nieobsługiwanymi uprawnieniami, użytkownik końcowy usług Azure Communication Services może zostać poproszony o wyświetlenie strony logowania lub odmowa dostępu po kliknięciu załącznika pliku w wątku czatu.

Zrzut ekranu przedstawiający klienta usługi Teams z listą uprawnień do plików.

Ponadto administrator dzierżawy użytkownika usługi Teams może narzucić ograniczenia dotyczące udostępniania plików, w tym wyłączenie niektórych uprawnień do plików lub wyłączenie opcji udostępniania plików razem.

Uruchamianie kodu

Uruchommy npm run start polecenie , aby uzyskać dostęp do naszej przykładowej aplikacji za pośrednictwem localhost:3000 poniższego zrzutu ekranu:

Zrzut ekranu przedstawiający bibliotekę interfejsu użytkownika usług Azure Communication Services.

Po prostu kliknij przycisk czatu znajdujący się u dołu, aby wyświetlić panel czatu, a teraz, jeśli użytkownik usługi Teams wyśle niektóre pliki, powinien zostać wyświetlony podobny do poniższego zrzutu ekranu:

Zrzut ekranu przedstawiający klienta usługi Teams wysyłającego jeden plik.