Podstawowe pojęcia dotyczące usługi Azure Web PubSub

Usługa Azure Web PubSub ułatwia tworzenie aplikacji internetowych do obsługi komunikatów w czasie rzeczywistym. Klienci łączą się z usługą przy użyciu standardowego protokołu WebSocket, a usługa uwidacznia interfejsy API REST i zestawy SDK, aby zarządzać tymi klientami.

Terminy

Poniżej przedstawiono kilka ważnych terminów używanych przez usługę:

• Połączenie: połączenie, nazywane również klientem lub połączeniem klienta, jest to relacja logiczna między klientem a usługą Web PubSub. Za pośrednictwem połączenia klient i usługa angażują się w serię interakcji stanowych. Połączenia korzystające z różnych protokołów mogą zachowywać się inaczej, na przykład niektóre połączenia są ograniczone do czasu trwania połączenia sieciowego, podczas gdy inne mogą rozszerzać wiele kolejnych połączeń sieciowych między klientem a usługą.

• Węzeł: Węzeł jest logicznym pojęciem dla zestawu połączeń klienckich. Zazwyczaj używasz jednego centrum w jednym scenariuszu, na przykład centrum czatów lub centrum powiadomień . Gdy połączenie klienta nawiązuje połączenie, łączy się z hubem i w czasie trwania połączenia należy do tego huba. Gdy połączenie klienta połączy się z koncentratorem, koncentrator jest gotowy do działania. Różne aplikacje mogą udostępniać jedną usługę Azure Web PubSub przy użyciu różnych nazw centrów. Chociaż nie ma ścisłego limitu liczby hubów, hub generuje większe obciążenie usługi w porównaniu z grupą. Zaleca się stosowanie wstępnie określonego zestawu koncentratorów zamiast ich dynamicznego generowania.

• Grupa: Grupa jest podzbiorem połączeń do koncentratora. Możesz dodać połączenie klienta do grupy lub usunąć połączenie klienta z grupy w dowolnym momencie. Na przykład gdy klient dołącza do pokoju rozmów lub gdy klient opuszcza pokój rozmów, ten pokój rozmów może być uważany za grupę. Klient może dołączyć do wielu grup, a grupa może zawierać wielu klientów. Grupa jest jak "sesja grupowa", która jest tworzona, gdy tylko ktoś do niej dołączy, i znika, gdy w grupie nie ma nikogo. Komunikaty wysyłane do grupy są dostarczane do wszystkich klientów połączonych z grupą.

• Użytkownik: połączenia z internetowymi usługami PubSub mogą należeć do jednego użytkownika. Użytkownik może mieć wiele połączeń, na przykład gdy jeden użytkownik jest połączony z wieloma urządzeniami lub wieloma kartami przeglądarki.

• Komunikat: Po nawiązaniu połączenia klient może wysyłać komunikaty do aplikacji nadrzędnej lub odbierać komunikaty z aplikacji nadrzędnej za pośrednictwem połączenia protokołu WebSocket. Komunikaty mogą być w formacie zwykłego tekstu, binarnego lub JSON i mają maksymalny rozmiar 1 MB.

• Zdarzenia klienta: zdarzenia są tworzone podczas cyklu życia połączenia klienta. Na przykład proste połączenie klienta protokołu WebSocket tworzy connect zdarzenie, gdy próbuje nawiązać połączenie z usługą, connected zdarzenie po pomyślnym połączeniu z usługą, message zdarzenie, gdy wysyła komunikaty do usługi w trybie sendEvent domyślnym i disconnected zdarzenie, gdy rozłącza się z usługą. Szczegółowe informacje o zdarzeniach klienta przedstawiono w sekcji Protokół klienta.

• Procedura obsługi zdarzeń: program obsługi zdarzeń zawiera logikę do obsługi zdarzeń klienta. Zarejestruj i skonfiguruj programy obsługi zdarzeń w usłudze za pośrednictwem portalu Azure lub interfejsu wiersza polecenia Azure wcześniej. Szczegóły opisano w sekcji Procedura obsługi zdarzeń.

• Odbiornik zdarzeń (wersja zapoznawcza): odbiornik zdarzeń po prostu nasłuchuje zdarzeń klienta, ale nie może wpływać na czas działania klientów poprzez ich odpowiedzi. Szczegóły opisano w sekcji Odbiornika zdarzeń.

• Serwer: serwer może obsługiwać zdarzenia klienta, zarządzać połączeniami klientów lub publikować komunikaty w grupach. Zarówno program obsługi zdarzeń, jak i odbiornik zdarzeń są uważane za po stronie serwera. Szczegółowe informacje o serwerze opisano w sekcji Protokół serwera.

Przepływ pracy

Typowy przepływ pracy korzystający z usługi jest pokazany poniżej:

Jak pokazano na powyższym wykresie przepływu pracy:

1. Klient łączy się z hudem w usłudze przy użyciu transportu protokołu WebSocket. Usługa może przekazywać wiadomości do skonfigurowanego serwera nadrzędnego lub samodzielnie obsługiwać wiadomości, umożliwiając klientom bezpośrednie korzystanie z funkcjonalności publikowania/subskrypcji, w zależności od protokołu używanego przez klienta. Szczegółowe informacje opisano w protokołach klienta.

2. Usługa wywołuje serwer przy użyciu protokołu CloudEvents w różnych zdarzeniach klienta. CloudEvents to ustandaryzowana i niezależna od protokołu definicja struktury i metadanych zdarzeń hostowanych przez Cloud Native Computing Foundation (CNCF). Szczegóły opisano w protokole serwera.

3. Serwer może wywołać usługę przy użyciu interfejsu API REST, aby wysyłać komunikaty do klientów lub zarządzać połączonymi klientami. Szczegóły opisano w protokole serwera