Omówienie pomieszczeń

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

Poniżej przedstawiono główne scenariusze, w których pomieszczenia są przydatne:

• Pokoje umożliwiają zaplanowaną komunikację. Pokoje pomagają platformom obsługi dostarczać środowiska w stylu spotkań, a jednocześnie są one odpowiednio ogólne dla szerokiej gamy aplikacji branżowych. Usługi mogą planować i zarządzać pokojami dla pacjentów poszukujących porad medycznych, planistów finansowych pracujących z klientami i prawnikami świadczącymi usługi prawne.
• Pokoje umożliwiają korzystanie z funkcji tylko do zapraszania. Pokoje pozwalają usługom kontrolować, którzy użytkownicy mogą dołączyć do pokoju na wirtualne spotkanie z lekarzami lub konsultantami finansowymi. Dzięki temu tylko podzbiór użytkowników z przypisanymi tożsamościami usług komunikacyjnych może dołączyć do połączenia pokoju.
• Pokoje umożliwiają komunikację ustrukturyzowaną za pośrednictwem ról i uprawnień. Pokoje umożliwiają deweloperom przypisywanie wstępnie zdefiniowanych ról użytkownikom w celu wykonywania wyższego stopnia kontroli i struktury w komunikacji. Upewnij się, że tylko prezenterzy mogą mówić i udostępniać zawartość w dużym spotkaniu lub na wirtualnej konferencji.
• Dodaj uczestników PSTN. Zaproś uczestników publicznej sieci telefonicznej (PSTN) do połączenia przy użyciu numeru zakupionego w ramach subskrypcji lub za pośrednictwem bezpośredniego routingu platformy Azure do kontrolera granic sesji (SBC).

Kiedy używać pomieszczeń

Użyj pomieszczeń, jeśli potrzebujesz dowolnej z następujących funkcji:

• Kontrolowanie, którzy użytkownicy mogą dołączać do połączeń w pokoju.
• Potrzebujesz harmonogramów/współrzędnych, które są włączone i wygasają o określonej godzinie i dacie.
• Potrzebna jest ustrukturyzowana komunikacja za pośrednictwem ról i uprawnień dla użytkowników.

Możliwość	Połączenie 1:N	Połączenie 1:N z efemerycznym identyfikatorem	Rozmowa z pokojem
Uczestnicy interakcyjne	350	350	350
Efemeryczny identyfikator do dystrybucji do uczestników	❌	✔️ (Identyfikator grupy)	✔️ (Identyfikator pokoju)
Zaproszenie tylko do udziału	❌	❌	✔️
Możliwość wybierania numerów do użytkownika PSTN	✔️	✔️	✔️
Podpisy połączeń	✔️ prywatna wersja zapoznawcza	✔️ prywatna wersja zapoznawcza	✔️ prywatna wersja zapoznawcza
Nagrywanie połączeń	✔️	✔️	✔️ publiczna wersja zapoznawcza
Wszyscy użytkownicy w zasobie usługi komunikacji w celu dołączenia do połączenia	❌	✔️	✔️
Ustawianie okresu ważności dla wywołania	❌	❌	✔️ Do sześciu miesięcy
Ustawianie ról i uprawnień użytkownika dla wywołania	❌	❌	✔️
Interfejs API do tworzenia, usuwania, aktualizowania, usuwania wywołania	❌	❌	✔️ Interfejs API pomieszczeń

Zarządzanie pokojami i dołączanie do połączeń z pokojem

Interfejs API/zestaw SDK pomieszczeń służy do wykonywania akcji, takich jak tworzenie pokoju, dodawanie uczestników i konfigurowanie harmonogramu itp. Zestaw SDK wywoływania służy do inicjowania wywołania w pomieszczeniu po stronie klienta. Większość akcji dostępnych w wywołaniach jeden do jednego lub wywołań grupowych w zestawach SDK połączeń telefonicznych jest również dostępna w wywołaniach pokoju. Pełna lista funkcji oferowanych w zestawie SDK wywoływania znajduje się na liście Omówienie zestawu Sdk wywołującego.

Możliwość	Wywoływanie zestawu SDK	Interfejs API/zestaw SDK pomieszczeń
Dołączanie do połączenia pokojowego za pomocą głosu i wideo	✔️	❌
Wyświetl listę uczestników, którzy dołączyli do rozmowy z pokojami	✔️	❌
Zezwalaj/nie zezwalaj na wybieranie numeru do użytkownika PSTN na poziomie wirtualnych pokoi	❌	✔️
Utwórz pokój	❌	✔️
Wyświetl listę wszystkich uczestników zaproszonych do pokoju	❌	✔️
Dodawanie lub usuwanie uczestnika voIP	❌	✔️
Przypisywanie ról do uczestników pokoju	❌	✔️

Na poniższym obrazie przedstawiono koncepcję zarządzania pokojami i dołączania do nich.

Interfejs API/zestawy SDK pomieszczeń wirtualnych

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

• Utworzenie
• Modyfikowanie
• Delete
• Ustawianie i aktualizowanie listy uczestników
• Ustawianie i modyfikowanie ważności pokoju
• Przypisz role i uprawnienia do użytkowników. Szczegóły poniżej.

Virtual Rooms SDK	Wersja	Stan
Zestawy SDK pomieszczeń wirtualnych	2024-04-15	Ogólnie dostępne — w pełni obsługiwane
Zestawy SDK pomieszczeń wirtualnych	2023-10-30	Publiczna wersja zapoznawcza — w pełni obsługiwana
Zestawy SDK pomieszczeń wirtualnych	2023-06-14	Ogólnie dostępne — w pełni obsługiwane
Zestawy SDK pomieszczeń wirtualnych	2023-03-31	Zostanie wycofany 30 kwietnia 2024 r.
Zestawy SDK pomieszczeń wirtualnych	2022-02-01	Zostanie wycofany 30 kwietnia 2024 r.
Zestawy SDK pomieszczeń wirtualnych	2021-04-07	Zostanie wycofany 30 kwietnia 2024 r.

Wywoływanie zestawów SDK

Użyj zestawów SDK wywołujących, aby dołączyć do połączenia z pokojem. Połączenia pokoju można połączyć przy użyciu zestawów SDK sieci Web, iOS lub Android Calling. Przykłady szybkiego startu dotyczące dołączania do rozmów w pokoju można znaleźć tutaj.

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 dodawanie klienta wywołania, który jest włączony w aplikacji Rooms z tylko kilkoma wierszami kodu.

Wstępnie zdefiniowane role i uprawnienia uczestnika

Uczestnicy pokoju mogą mieć przypisaną jedną z następujących ról: Prezenter, Uczestnik i Odbiorca. Domyślnie użytkownik ma przypisaną rolę Uczestnik , jeśli nie przypisano żadnej innej roli.

W poniższych tabelach przedstawiono szczegółowe możliwości mapowane na role. Na wysokim poziomie rola prezentera ma pełną kontrolę, możliwości uczestnika są ograniczone do audio i wideo, podczas gdy użytkownik może odbierać tylko dźwięk, wideo i udostępnianie ekranu.

Możliwość	Rola: prezenter	Rola: Uczestnik	Rola: Konsument
Kontrolki wywołania środkowego
- Włączanie/wyłączanie wideo	✔️	✔️	❌
- Wycisz/Wycisz mikrofon	✔️	✔️	❌
- Wycisz użytkownika zdalnego **	✔️	❌	❌
- Przełączanie między kamerami	✔️	✔️	❌
- Aktywny głośnik	✔️	✔️	✔️
- Wybieranie osoby mówiącej dla połączeń	✔️	✔️	✔️
- Wybieranie mikrofonu dla wywołań	✔️	✔️	❌
— Pokaż stan uczestników (bezczynność, łączenie, połączenie, wstrzymanie, rozłączanie, rozłączanie itp.)	✔️	✔️	✔️
— Pokaż stan połączenia (wczesne nośniki, przychodzące, nawiązywanie połączenia, dzwonienie, połączone, blokada, rozłączanie, rozłączanie	✔️	✔️	✔️
- Pokaż, czy uczestnik jest wyciszony	✔️	✔️	✔️
- Pokaż przyczynę opuszczenia połączenia przez uczestnika	✔️	✔️	✔️
Udostępnianie ekranu
— Ekran udostępniania	✔️ *	❌	❌
— Udostępnianie aplikacji	✔️ *	❌	❌
- Udostępnianie karty przeglądarki	✔️ *	❌	❌
— Uczestnicy mogą wyświetlać udostępniony ekran	✔️	✔️	✔️
Zarządzanie dyżurami
— Usuwanie uczestnika	✔️	❌	❌
Zarządzanie urządzeniami
- Poproś o pozwolenie na używanie dźwięku i/lub wideo	✔️	✔️	❌
- Pobieranie listy aparatów	✔️	✔️	❌
- Ustawianie aparatu	✔️	✔️	❌
- Pobieranie wybranego aparatu	✔️	✔️	❌
- Pobieranie listy mikrofonów	✔️ *	✔️ *	❌
- Ustaw mikrofon	✔️ *	✔️ *	❌
- Pobieranie wybranego mikrofonu	✔️ *	✔️ *	❌
- Pobieranie listy prelegentów	✔️ *	✔️ *	✔️ *
- Ustaw głośnik	✔️ *	✔️ *	✔️ *
- Pobieranie wybranego głośnika	✔️	✔️	✔️
Renderowanie wideo
- Renderowanie wideo w wielu miejscach (kamera lokalna lub strumień zdalny)	✔️	✔️	✔️ (Tylko zdalne)
- Ustawianie/aktualizowanie trybu skalowania wideo	✔️	✔️	✔️ (Tylko zdalne)
- Renderowanie zdalnego strumienia wideo	✔️	✔️	✔️
Dodawanie uczestników PSTN
- Zadzwoń do uczestników za pomocą połączeń telefonicznych	✔️	❌	❌

* Dostępne tylko w internetowym zestawie SDK. Niedostępne w zestawach SDK połączeń z systemami iOS i Android

** Obecnie w publicznej wersji zapoznawczej.

Obsługa zdarzeń

Zdarzenia połączeń głosowych i wideo publikowane za pośrednictwem usługi Event Grid są oznaczone adnotacjami z informacjami o połączeniu pokoju.

• WywołanieStarted jest publikowane po rozpoczęciu połączenia pokoju.
• CallEnded jest publikowany po zakończeniu połączenia pokoju.
• CallParticipantAdded jest publikowany, gdy nowy uczestnik dołącza do rozmowy pokojowej.
• CallParticipantRemoved jest publikowany, gdy uczestnik spada z rozmowy pokojowej.

Przestarzałe funkcje

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

• Pokój "Tylko zaproś", który umożliwia zaproszonym użytkownikom dołączenie do rozmowy z pokojem.
• "Otwórz pokój", który jest mniej bezpieczny. W konfiguracji otwartych pomieszczeń wszyscy użytkownicy usług Azure Communication Services mogli dołączyć do połączenia bez jawnego zaproszenia za pośrednictwem listy Pokój.

Koncepcja "Otwórz pokój" jest teraz przestarzała. W przyszłości pokoje "Tylko zaproś" będą jedynym obsługiwanym typem pokoju.

Znane ograniczenia

• Obecnie możliwości usługi Azure Communication Services Call Automation nie obsługują połączeń z usługami Rooms.

Następne kroki:

• Użyj przewodnika Szybki start, aby utworzyć pokój, zarządzać nim i dołączać do niego.
• Dowiedz się, jak dołączyć do połączenia z pokojem.
• Zapoznaj się z wymaganiami sieci dotyczącymi nośników i sygnałów.
• Analizowanie danych usługi Rooms można znaleźć w temacie : 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ń.