Empieza con el chat de Azure Web PubSub

Esta guía de inicio rápido muestra la forma más rápida de comprobar el funcionamiento del chat de Web PubSub. Generas una URL de acceso al cliente en el portal de Azure, luego usas el SDK del cliente para conectarte, crear una sala y enviar un mensaje sin código del servidor.

Prerequisites

• Un recurso de Azure Web PubSub con almacenamiento configurado y chat habilitado. Si aún no lo has hecho, consulta Configurar almacenamiento y habilitar el chat.
• Node.js versión 20 o posterior.

Consigue un token de acceso al cliente desde el portal

Un cliente se conecta a un hub de chat con una URL de acceso de cliente que incluye la identidad del usuario. Para una prueba rápida, genera uno en el portal.

1. En el portal de Azure, abre tu recurso Web PubSub.
2. En el menú izquierdo, selecciona la hoja Keys y luego Generador de URLs del cliente.
3. Establece Hub con el nombre del Chat Hub que añadiste, por ejemplo chat.
4. Configura ID de usuario con cualquier nombre, por ejemplo alice. El chat usa esto como tu identidad de usuario.
5. Copia la URL de acceso al cliente.

Instalación del SDK de cliente

Crea un proyecto e instala el SDK del cliente.

mkdir chat-quickstart
cd chat-quickstart
npm init -y
npm install @azure/web-pubsub-chat-client

Conéctate, crea una habitación y envía un mensaje

Guarde el código siguiente como index.mjs. Sustituye <client-access-url> por la URL que copiaste del portal.

import { ChatClient } from "@azure/web-pubsub-chat-client";

// Paste the client access URL you generated in the portal.
const clientAccessUrl = "<client-access-url>";

async function main() {
  // Connect to chat hub.
  const client = await ChatClient.start(clientAccessUrl);
  console.log(`Connected as ${client.userId}`);

  // Print messages as they arrive.
  client.on("message", (event) => {
    const message = event.message;
    console.log(`${message.createdBy}: ${message.content.text}`);
  });

  // Create a room. You're added to it automatically.
  const room = await client.createRoom("My first room", []);
  console.log(`Created room ${room.roomId}`);

  // Send a message to the room.
  await client.sendToRoom(room.roomId, "Hello, Chat!");

  // Read the room's history back from your storage.
  console.log("History:");
  for await (const message of client.listRoomMessages(room.roomId)) {
    console.log(`  ${message.createdBy}: ${message.content.text}`);
  }

  // Disconnect.
  await client.stop();
}

main().catch(console.error);

Ejecútelo:

node index.mjs

Verá una salida similar a la siguiente:

Connected as alice
Created room <room-id>
alice: Hello, Chat!
History:
  alice: Hello, Chat!

Note

En este inicio rápido usabas un token de portal. Para producción, emite tokens desde tu propio servidor. Consulta Autenticar y conectar clientes.