Korzystanie z placu zabaw do eksplorowania możliwości usługi Azure Web PubSub

Playground to narzędzie oparte na przeglądarce, które ułatwia korzystanie z funkcji obsługi komunikatów usługi Azure Web PubSub w czasie rzeczywistym — nie jest wymagany kod ani konfiguracja lokalna. Za pomocą kilku kliknięć można tworzyć klientów, dołączać grupy i wysyłać komunikaty przy użyciu interfejsów API po stronie klienta i po stronie serwera.

Ten przewodnik przeprowadzi Cię przez dwa typowe scenariusze obsługi komunikatów na placu zabaw, ułatwiając zrozumienie ważnych pojęć, takich jak połączenia, grupy i komunikaty.

Czego się uczysz

Poznasz dwa wzorce obsługi komunikatów często używane w aplikacjach czasu rzeczywistego:

• Komunikacja serwera z grupą: używanie interfejsu API sendToGroup do nadawania komunikatów do wszystkich klientów w grupie.
• Obsługa komunikatów typu klient-grupa: usługa Azure Web PubSub obsługuje funkcję umożliwiającą klientowi w grupie wysyłanie komunikatów bezpośrednio do innych klientów w tej samej grupie — bez routingu przez serwer aplikacji — co zmniejsza opóźnienie.

Najważniejsze pojęcia

Zanim zaczniemy, oto krótkie przypomnienie podstawowych pojęć w usłudze Azure Web PubSub, z którymi będziesz się zapoznawać w środowisku testowym:

• Centrum: jednostka logiczna używana do izolowania i organizowania logiki obsługi komunikatów. Klienci zawsze łączą się z węzłem. W przypadku placu zabaw rzeczywisty ruch przechodzi przez zasób. W tym samouczku zalecamy określenie nazwy hubu testowego, która nie nakłada się na ruch produkcyjny.
• Połączenie: trwałe połączenie protokołu WebSocket między klientem a usługą Azure Web PubSub.
• Grupa: podzestaw połączeń zarządzany przez serwer. Komunikaty wysyłane do grupy są dostarczane tylko do połączeń w tej grupie.
• Komunikaty: ładunki wymieniane między klientami a usługą. Komunikaty mogą być emitowane do wszystkich, kierowane do grup lub kierowane do poszczególnych połączeń.

Scenariusz 1. Wysyłanie komunikatu do grupy z serwera

W tym scenariuszu symulujesz nadawanie po stronie serwera przy użyciu interfejsu sendToGroup API REST. W tym scenariuszu pokazano, jak usługa kieruje komunikat z zaplecza do wszystkich klientów w określonej grupie.

Kroki

1. W witrynie Azure Portal przejdź do zasobu Web PubSub platformy Azure.
2. Otwórz panel Playground.
3. Kliknij pozycję + Dodaj klienta , aby utworzyć wiele połączeń.
4. Przypisz każdego klienta do grupy (na przykład group1).
5. Na karcie Serwer w sekcji "Publikowanie komunikatów" wybierz pozycję Wyślij do grupy.
6. Wprowadź nazwę grupy (group1), przykładowy komunikat i wywołaj sendToGroup interfejs API.
7. Przejdź do karty Klient i obserwuj komunikat wyświetlany w dzienniku komunikatów każdego klienta.

Czego się uczysz

Komunikaty są wysyłane do grupy klientów przy użyciu interfejsów API RESTful. Plac zabaw pokazuje, jak działa komunikacja między serwerem a grupą, bez konieczności wdrażania backendu. Usługa Azure Web PubSub udostępnia również zestawy SDK serwera dla języków C#, JavaScript, Java i Python.

Aby zwizualizować emisję komunikatów w akcji, spróbuj powtórzyć kroki z wieloma klientami. Plac zabaw obsługuje maksymalnie pięciu równoczesnych symulowanych klientów.

Scenariusz 2: Wysyłanie wiadomości do grupy za pomocą klienta

W tym scenariuszu utworzysz klienta wysyłającego wiadomość do innych klientów w tej samej grupie — podobnie jak użytkownik publikujący wiadomość w pokoju rozmów.

Kroki

1. W placu zabaw dodaj co najmniej dwóch klientów i określ tę samą wartość w Initial Groups polu.
2. W przypadku klienta, który wysyła komunikat, wybierz pozycję Zezwalaj klientowi na wysyłanie do wszystkich grup.
3. Przejdź do panelu tego klienta, określ nazwę grupy, wprowadź komunikat i kliknij przycisk Wywołaj.
4. Inni klienci w grupie otrzymują komunikat w czasie rzeczywistym.

Czego się uczysz

W tym scenariuszu przedstawiono wysyłanie komunikatów od klienta do grupy, co jest idealne w aplikacjach, w których przesyłanie danych do i z serwera wprowadza niepotrzebne opóźnienia. Jest to podstawowa część modelu publikowania/subskrybowania klienta Web PubSub.

Dalsze kroki

• Dowiedz się więcej o kluczowych pojęciach w usłudze Azure Web PubSub
• Aby utworzyć przykład lokalny, postępuj zgodnie z przewodnikiem Szybki start
• Zapoznaj się z przewodnikami w sekcji "Przewodniki z instrukcjami" dla typowych zadań podczas opracowywania za pomocą usługi Azure Web PubSub