Compartilhar via

Usar o playground para explorar os recursos do Azure Web PubSub

O Playground é uma ferramenta baseada em navegador que ajuda você a usar os recursos de mensagens em tempo real do Azure Web PubSub— nenhum código ou configuração local é necessário. Com apenas alguns cliques, você pode criar clientes, unir grupos e enviar mensagens usando APIs do lado do cliente e do servidor.

Este guia orienta você por dois cenários comuns de mensagens no playground, ao mesmo tempo em que ajuda você a entender conceitos importantes, como conexões, grupos e mensagens.

O que você aprenderá

Você explora dois padrões de mensagens frequentemente usados em aplicativos em tempo real:

  • Mensagens de servidor para grupo: usando a sendToGroup API para transmitir mensagens para todos os clientes em um grupo.
  • Mensagens cliente a grupo: o Azure Web PubSub dá suporte a uma funcionalidade que permite que um cliente em um grupo envie mensagens diretamente para outros clientes no mesmo grupo, sem rotear por meio do servidor de aplicativo, reduzindo a latência.

Conceitos principais

Antes de começarmos, aqui está uma atualização rápida sobre os principais conceitos do Azure Web PubSub com os quais você interage no playground:

  • Hub: uma unidade lógica usada para isolar e organizar a lógica de mensagens. Os clientes sempre se conectam a um hub. Com o playground, o tráfego real passa pelo recurso. Para este tutorial, recomendamos especificar um nome de hub de teste que não se sobreponha ao tráfego de produção.
  • Conexão: uma conexão WebSocket persistente entre um cliente e o serviço Azure Web PubSub.
  • Grupo: um subconjunto de conexões gerenciado pelo servidor. As mensagens enviadas a um grupo são entregues somente às conexões dentro desse grupo.
  • Mensagens: as cargas trocadas entre clientes e o serviço. As mensagens podem ser transmitidas para todos, direcionadas a grupos ou direcionadas para conexões individuais.

Cenário 1: enviar uma mensagem para um grupo do servidor

Nesse cenário, você simula a difusão do lado do servidor usando a sendToGroup API REST. Esse cenário demonstra como o serviço roteia uma mensagem do back-end para todos os clientes em um grupo especificado.

Etapas

  1. No portal do Azure, navegue até o recurso do Azure Web PubSub.
  2. Abra a folha Playground .
  3. Clique em + Adicionar Cliente para criar várias conexões.
  4. Atribuir cada cliente a um grupo (por exemplo, group1).
  5. Na guia Servidor na seção "Publicar mensagens", selecione Enviar para o grupo.
  6. Insira o nome do grupo (group1), uma mensagem de exemplo e invoque a sendToGroup API.
  7. Alterne para a guia Cliente e observe a mensagem aparecer no log de mensagens de cada cliente.

O que você está aprendendo

Você envia mensagens para um grupo de clientes usando APIs RESTful. O Playground demonstra como a comunicação de servidor para grupo funciona sem a necessidade de implantar um back-end. O Azure Web PubSub também fornece SDKs de servidor para C#, JavaScript, Java e Python.

Para visualizar a transmissão de mensagens em ação, tente repetir as etapas com vários clientes. O Playground dá suporte a até cinco clientes simulados simultâneos.

Cenário 2: enviar uma mensagem para um grupo de um cliente

Nesse cenário, você cria um cliente enviando uma mensagem para outros clientes no mesmo grupo, semelhante a um usuário postando uma mensagem em uma sala de chat.

Etapas

  1. No playground, adicione dois ou mais clientes e especifique o mesmo valor para o Initial Groups campo.
  2. Para o cliente que envia a mensagem, selecione Permitir que o cliente envie para todos os grupos.
  3. Alterne para o painel desse cliente, especifique o nome do grupo, insira uma mensagem e clique em Invocar.
  4. Os outros clientes do grupo recebem a mensagem em tempo real.

O que você está aprendendo

Esse cenário mostra o sistema de mensagens cliente a grupo, ideal em aplicativos em que as viagens de ida e volta do servidor introduzem latência desnecessária. É uma parte central do modelo de publicação/assinatura do cliente do Web PubSub.

Dica

Abra várias guias do navegador para simular vários usuários ou dispositivos. Tente combinar mais operações como joinGroup, leaveGroupou sendToConnection. Use nomes de grupo claros para organizar melhor seus experimentos.

Próximas etapas

  • Last updated on