Rooms API do zorganizowanych spotkań

Wirtualne pokoje umożliwiają programistom tworzenie dobrze ustrukturyzowanych doświadczeń komunikacyjnych, zapewniając niezbędne zabezpieczenia i możliwości kontroli, takie jak wirtualne spotkania i komunikacja grupowa. Deweloperzy mogą używać wirtualnych pomieszczeń do prowadzenia połączeń głosowych, wideo i PSTN. Zabezpieczenia i mechanizmy kontroli w pokojach można sklasyfikować w następujący sposób.

• Zabezpieczenia i mechanizmy kontroli dostępu użytkowników są stosowane do wywoływania uczestników, kontrolowania, kto może dołączyć do wywołania i akcji, które mogą wykonać podczas wywołania. Na przykład podczas wirtualnego spotkania pacjenta z lekarzem tylko autoryzowany personel szpitala i pacjenci mogą dołączyć do połączenia. Ograniczenie uczestników zachowuje prywatność pacjenta, a uczestnicy nie przekraczają przypisanych ról i uprawnień, aby zakłócić trwające połączenie.

• Zabezpieczenia i mechanizmy kontroli na poziomie pokoju są stosowane na poziomie połączenia w celu kontrolowania, kiedy można przeprowadzić połączenie i jakie możliwości są dostępne podczas połączenia. Na przykład uczniowie mają uprawnienia tylko do dołączenia do połączenia w klasie w przydzielonym czasie, ale rozmówcy PSTN nie może dołączyć do tego samego połączenia w klasie.

Funkcje wysokiego poziomu obsługiwane w pokojach wirtualnych

* Zastosowanie niektórych wyjątków. Pełną listę można znaleźć w temacie Call Automation capabilities (Możliwości automatyzacji wywołań).

Kiedy należy używać pomieszczeń wirtualnych

W poniższej tabeli opisano, kiedy należy używać pomieszczeń wirtualnych.

* Jeśli rozwiązanie wymaga interoperacyjności między Teams i Azure Communication Services, użyj wywołań interoperacyjnych Teams.

Jak prowadzić połączenia w pokojach wirtualnych

Na wysokim poziomie do prowadzenia połączeń w pokojach wirtualnych należy utworzyć pokoje i zarządzać nimi. W poniższej tabeli opisano, jak umożliwić uczestnikom dołączanie do połączeń oraz wykonywanie operacji podczas połączeń przy użyciu zestawu SDK do dzwonienia po stronie klienta i serwera.

Aby zabezpieczyć wywołania i wyzwalać operacje po stronie klienta/po stronie serwera, deweloperzy używają zestawu SDK usługi Virtual Rooms, zestawu SDK klienta wywołującego i zestawu SDK usługi Call Automation.

Aby uzyskać pełną listę operacji po stronie klienta w trakcie rozmowy oraz sposób ich użycia, zobacz SDK klienta do wywoływania.

Zarządzanie połączeniami wirtualnych pomieszczeń po stronie serwera przy użyciu zestawu SDK Call Automation Server

Zestaw SDK Call Automation umożliwia deweloperom zarządzanie rozmowami w wirtualnych pokojach po stronie serwera oraz wykonywanie operacji podczas rozmów. Możliwości automatyzacji wywołań są stopniowo włączane w rozmowach usługi Virtual Rooms. W poniższej tabeli przedstawiono bieżący stan tych możliwości. Deweloperzy zarządzają możliwościami usługi Call Automation i kontrolują je po stronie serwera, które działają na wyższym poziomie niż uprawnienia uczestnika połączenia. Dlatego możliwości automatyzacji wywołań nie są kontrolowane za pomocą ról i uprawnień użytkownika.

* Obecnie w publicznej wersji zapoznawczej.

Na tej ilustracji przedstawiono koncepcje dotyczące zarządzania i łączenia pokoi.

Serwer zainicjował połączenie telefoniczne PSTN przy użyciu Call Automation Server SDK.

Programiści mogą włączać/wyłączać funkcję połączeń telefonicznych z uczestnikiem PSTN, ustawiając flagę pstnDialoutEnabled specyficzną dla danego pokoju. Gdy deweloper ustawia parametr pstnDialoutEnabled=TRUE dla pokoju, deweloperzy mogą nawiązywać połączenia wychodzące do uczestnika PSTN po stronie serwera przy użyciu usługi Call Automation, bez konieczności udziału po stronie klienta.

Na przykład pacjent może poprosić o usługę tłumaczenia na zbliżającą się wizytę online u lekarza. W większości przypadków numer telefonu do usługi tłumaczeń ustnych jest określany dynamicznie przez proces działający w tle. Ta funkcjonalność wybierania numerów PSTN po stronie serwera umożliwia deweloperom określenie docelowego numeru telefonu, zainicjowanie połączenia i dodanie go do wirtualnej rozmowy wizyty pacjenta bez konieczności akcji po stronie klienta.

Wykonaj następujące kroki, aby dodać numer PSTN do połączenia w pokoju przy użyciu SDK Call Automation.

1. Utwórz pokój z flagą pstnDialoutEnabled ustawioną na True
2. Uczestnicy rozpoczynają rozmowę wirtualną w pokoju
3. Użyj zestawu SDK Call Automation, aby połączyć się z rozmową w pokoju przy użyciu identyfikatora pokoju.
4. Użycie Call Automation SDK do wykonania połączenia na numer PSTN
5. Użytkownik PSTN akceptuje i dołącza do rozmowy w pokoju.

Zarządzanie po stronie klienta połączeniami wirtualnych pokojów za pomocą SDK do obsługi połączeń

Użyj SDK do łączenia się, aby dołączyć do rozmowy w pokoju. Połączenia w pokojach można dołączać za pomocą zestawów SDK dla sieci Web, iOS lub Android Calling. Przykłady i sposób dołączania połączeń do pokoju można znaleźć w temacie Join a room call (Dołączanie do połączenia w pokoju).

Dostęp do pokoi można również uzyskać przy użyciu biblioteki interfejsu użytkownika usług Azure Communication Services. Biblioteka interfejsu użytkownika umożliwia deweloperom dodanie klienta połączeń z funkcją Rooms do swojej aplikacji przy użyciu zaledwie kilku wierszy kodu.

Klient zainicjował wybieranie numeru za pomocą SDK klienta do dzwonienia na PSTN

Deweloperzy mogą włączać lub wyłączać możliwość wykonywania połączeń przez uczestników rozmowy do uczestnika PSTN, ustawiając flagę specyficzną dla pokoju pstnDialoutEnabled. Gdy deweloper konfiguruje opcję pstnDialoutEnabled=TRUE dla pokoju, uczestnicy połączenia z rolą Prezentera mogą wybrać numer na uczestnika PSTN z poziomu swojego klienta wywołującego. Poniższe kroki służą do dodawania numeru PSTN do wywołania pokoju przy użyciu zestawu SDK klienta wywołującego.

1. Utwórz pokój z flagą pstnDialoutEnabled ustawioną na true.
2. Uczestnicy rozpoczynają rozmowę wirtualną w pokoju.
3. Uczestnik z rolą prezentera dodaje numer PSTN do rozmowy.
4. Użytkownik PSTN akceptuje i dołącza do rozmowy w pokoju.

Interfejsy API i zestawy SDK wirtualnych pokojów

Pokoje są tworzone i zarządzane za pośrednictwem interfejsów API do obsługi pokoi lub zestawów SDK. Użyj interfejsu API/zestawów SDK pomieszczeń w aplikacji serwera na potrzeby room operacji:

• Utwórz
• Modyfikowanie
• Usuń
• Ustawianie i aktualizowanie listy uczestników
• Ustaw i zmodyfikuj ważność pokoju
• Przypisywanie ról i uprawnień do użytkowników

Wstępnie zdefiniowane role i uprawnienia uczestników w połączeniach wirtualnych pokoi

Możesz przypisać uczestnikom pokoju jedną z następujących ról: Prezenter, Współpracownik, Uczestnik i Konsument.

Poniższa tabela zawiera szczegółowe możliwości mapowane na role. Na wysokim poziomie rola prezentera ma pełną kontrolę, Współpracownik ma możliwości audio, wideo i screenshare, uczestnik ma możliwości audio i wideo, a użytkownik może odbierać tylko dźwięk, wideo i udostępnianie ekranu.

Uwaga: Uczestnik połączenia PSTN nie jest częścią listy uczestników, więc rola użytkownika nie jest mu przypisana. Możliwości te są ograniczone do wyciszenia/wyciszenia się na urządzeniu lokalnym.

* Dostępne tylko w zestawie SDK do połączeń internetowych.

Obsługa zdarzeń

Zdarzenia połączeń głosowych i wideo publikowane za pośrednictwem usługi Event Grid są opatrzone informacjami o rozmowach w pokojach.

• CallStarted jest publikowane, gdy rozpoczyna się rozmowa w pokoju.
• CallEnded jest publikowany po zakończeniu połączenia w pokoju.
• CallParticipantAdded jest publikowany, gdy nowy uczestnik dołącza do rozmowy w pokoju.
• CallParticipantRemoved jest publikowany, gdy uczestnik opuszcza połączenie w pokoju.

Przestarzałe funkcje

Wcześniejsza publiczna wersja zapoznawcza interfejsu API rooms obsługiwała dwie konfiguracje kontroli listy pokoje w następujący sposób:

• Pokój tylko dla zaproszonych, który pozwala na dołączanie do rozmowy jedynie zaproszonym użytkownikom.
• Pokój otwarty , który był mniej bezpieczny. W otwartej konfiguracji pomieszczeń wszyscy użytkownicy usług Azure Communication Services mogli dołączyć do połączenia bez wyraźnego zaproszenia za pośrednictwem listy uczestników.

Koncepcja open room jest teraz przestarzała. W przyszłości pokoje tylko na zaproszenie są jedynym obsługiwanym typem pokoju.

Znane ograniczenia

• Usługa Azure Communication Services Call Automation obecnie nie obsługuje połączeń pokoju.

Dalsze kroki

• Użyj QuickStart, aby utworzyć, zarządzać i dołączyć do pokoju.
• Dowiedz się, jak dołączyć do rozmowy w pokoju.
• Dowiedz się, jak zarządzać połączeniem konferencyjnym.
• Zapoznaj się z wymaganiami sieci dotyczącymi nośników i sygnałów.
• Aby przeanalizować dane z Rooms, zobacz: Rooms Logs (Dzienniki pomieszczeń).
• Dowiedz się, jak używać obszaru roboczego usługi Log Analytics, zobacz: Samouczek usługi Log Analytics.
• Tworzenie własnych zapytań w usłudze Log Analytics, zobacz: Wprowadzenie zapytań.