Comece com o Azure Web PubSub chat

Este guia de início rápido mostra a maneira mais rápida de ver o chat no Web PubSub em funcionamento. Você gera uma URL de acesso ao cliente no portal do Azure, depois usa o SDK do cliente para conectar, criar uma sala e enviar uma mensagem sem código do servidor.

Pré-requisitos

Obtenha um token de acesso ao cliente no portal

Um cliente se conecta a um hub de chat usando uma URL de acesso do cliente que contém a identidade do usuário. Para um teste rápido, gere um no portal.

  1. No portal do Azure, abra seu recurso Web PubSub.
  2. No menu à esquerda, selecione a lâmina Keys , depois Gerador de URL do Cliente.
  3. Defina Hub como o nome do Chat Hub que você adicionou, por exemplo chat.
  4. Defina ID de usuário como qualquer nome, por exemplo alice. O chat usa isso como sua identidade de usuário.
  5. Copie a URL de acesso do cliente.

Captura de tela do Gerador de URL do Cliente no portal Azure, mostrando o hub, ID de usuário e a URL de acesso ao cliente gerada.

Instalar o cliente SDK

Crie um projeto e instale o SDK do cliente.

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

Conecte-se, crie uma sala e envie uma mensagem

Salve o código a seguir como index.mjs. Substitua <client-access-url> pela URL que você copiou do 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);

Execute-o:

node index.mjs

Você vê um resultado semelhante a:

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

Note

Neste Início Rápido, você usava um token de portal. Para produção, emita tokens do seu próprio servidor. Veja Autenticar e conectar clientes.