Uso del área de juegos para explorar las funcionalidades de Azure Web PubSub

Playground es una herramienta basada en explorador que le ayuda a usar las características de mensajería en tiempo real de Azure Web PubSub, sin código ni configuración local necesaria. Con tan solo unos clics, puede crear clientes, unirse a grupos y enviar mensajes mediante las API del lado cliente y del lado servidor.

Esta guía le guía a través de dos escenarios comunes de mensajería en el área de juegos, a la vez que le ayuda a comprender conceptos importantes, como conexiones, grupos y mensajes.

Conocimientos que adquirirá

Explorará dos patrones de mensajería que a menudo se usan en aplicaciones en tiempo real:

• Mensajería de servidor a grupo: uso de la sendToGroup API para difundir mensajes a todos los clientes de un grupo.
• Mensajería de cliente a grupo: Azure Web PubSub admite una funcionalidad que permite que un cliente de un grupo envíe mensajes directamente a otros clientes del mismo grupo, sin enrutamiento a través del servidor de aplicaciones, lo que reduce la latencia.

Conceptos clave

Antes de empezar, este es un repaso rápido de los conceptos básicos de Azure Web PubSub con los que interactúa en el entorno interactivo:

• Concentrador: una unidad lógica que se usa para aislar y organizar la lógica de mensajería. Los clientes siempre se conectan a un centro. Con el área de juegos, el tráfico real pasa por el recurso. En este tutorial, se recomienda especificar un nombre del centro de pruebas que no se superponga con el tráfico de producción.
• Conexión: una conexión WebSocket persistente entre un cliente y el servicio Azure Web PubSub.
• Grupo: un subconjunto administrado por el servidor de conexiones. Los mensajes enviados a un grupo solo se entregan a las conexiones dentro de ese grupo.
• Mensajes: las cargas intercambiadas entre los clientes y el servicio. Los mensajes se pueden difundir a todos, dirigidos a grupos o dirigidos a conexiones individuales.

Escenario 1: Enviar un mensaje a un grupo desde el servidor

En este escenario, simulará la difusión del lado servidor mediante la API de REST sendToGroup. En este escenario se muestra cómo el servicio enruta un mensaje desde el back-end a todos los clientes de un grupo especificado.

Pasos

1. En Azure Portal, vaya al recurso Azure Web PubSub.
2. Abra la pestaña Playground.
3. Haga clic en + Agregar cliente para crear varias conexiones.
4. Asigne cada cliente a un grupo (por ejemplo, group1).
5. En la pestaña Servidor de la sección "Publicar mensajes", seleccione Enviar al grupo.
6. Escriba el nombre del grupo (group1), un mensaje de ejemplo e invoque la sendToGroup API.
7. Cambie a la pestaña Cliente y observe que el mensaje aparece en el registro de mensajes de cada cliente.

Lo que estás aprendiendo

Los mensajes se envían a un grupo de clientes mediante las API DE RESTful. El área de juegos muestra cómo funciona la comunicación de servidor a grupo sin necesidad de implementar un back-end. Azure Web PubSub también proporciona SDK de servidor para C#, JavaScript, Java y Python.

Para visualizar la difusión de mensajes en acción, intente repetir los pasos con varios clientes. Playground admite hasta cinco clientes simulados simultáneos.

Escenario 2: Envío de un mensaje a un grupo desde un cliente

En este escenario, se crea un cliente que envía un mensaje a otros clientes del mismo grupo, similar a un usuario que publica un mensaje en un salón de chat.

Pasos

1. En playground, agregue dos o más clientes y especifique el mismo valor para el campo Initial Groups.
2. Para el cliente que envía el mensaje, seleccione Permitir que el cliente envíe a todos los grupos.
3. Cambie al panel del cliente, especifique el nombre del grupo, escriba un mensaje y haga clic en Invocar.
4. Los demás clientes del grupo reciben el mensaje en tiempo real.

Lo que estás aprendiendo

En este escenario se muestra la mensajería de cliente a grupo, que es ideal en las aplicaciones en las que los recorridos de ida y vuelta del servidor presentan una latencia innecesaria. Es una parte fundamental del modelo de publicación y suscripción de cliente de Web PubSub.

Pasos siguientes

• Más información sobre los conceptos clave en Azure Web PubSub
• Para compilar un ejemplo local, siga la guía de inicio rápido.
• Exploración de guías en "Guías paso a paso" para tareas comunes al desarrollar con Azure Web PubSub