Partilhar via

Use a ferramenta "playground" para explorar as capacidades do Azure Web PubSub

O Playground é uma ferramenta baseada em navegador que o ajuda a utilizar as funcionalidades de mensagens em tempo real do Azure Web PubSub — sem necessidade de código ou configuração local. Com apenas alguns cliques, você pode criar clientes, participar de grupos e enviar mensagens usando APIs do lado do cliente e do lado do servidor.

Este guia guia-o por dois cenários comuns de mensagens no playground, ajudando-o a compreender conceitos importantes como ligações, grupos e mensagens.

O que você aprende

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 de cliente para grupo: o Azure Web PubSub dá suporte a um recurso que permite que um cliente em um grupo envie mensagens diretamente para outros clientes no mesmo grupo, sem roteamento pelo servidor de aplicativos, reduzindo a latência.

Conceitos-chave

Antes de começarmos, aqui fica uma rápida recapitulação dos conceitos principais do Azure Web PubSub com que interages 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 seu 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 para um grupo são entregues apenas para as conexões dentro desse grupo.
  • Mensagens: As cargas trocadas entre os clientes e o serviço. As mensagens podem ser transmitidas para todos, direcionadas a grupos ou direcionadas a conexões individuais.

Cenário 1: Enviar uma mensagem para um grupo a partir do servidor

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

Passos

  1. No portal do Azure, navegue até o recurso Azure Web PubSub.
  2. Abrir o painel Playground.
  3. Clique em + Adicionar cliente para criar várias conexões.
  4. Atribua cada cliente a um grupo (por exemplo, group1).
  5. Na guia Servidor na seção "Publicar mensagens", selecione Enviar para o grupo.
  6. Digite 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 funciona a comunicação servidor-grupo sem necessidade de implementar um backend. 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 suporta até cinco clientes simulados em simultâneo.

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

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.

Passos

  1. No playground, adiciona dois ou mais clientes e especifica 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 do 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 mensagens de cliente para grupo, o que é ideal em aplicativos em que viagens de ida e volta do servidor introduzem latência desnecessária. É uma parte essencial do modelo de publicação/subscrição do cliente Web PubSub.

Sugestão

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

Próximos passos

  • Last updated on