Comece com o chat Azure Web PubSub

Este guia de introdução rápida mostra a forma mais rápida de ver o chat do Web PubSub a funcionar. Geras uma URL de acesso ao cliente no portal do Azure, depois usas o SDK do cliente para te ligares, crias uma sala e envias uma mensagem sem código do servidor.

Pré-requisitos

• Um recurso Azure Web PubSub com armazenamento configurado e Chat ativado. Se ainda não fizeste isto, vê Configurar armazenamento e ativar chat.
• Node.js versão 20 ou posterior.

Obtenha um token de acesso ao cliente no portal

Um cliente estabelece ligação a um hub de chat com um URL de acesso ao cliente que inclui a identidade do utilizador. Para um teste rápido, gera um no portal.

1. No portal Azure, abra o seu recurso Web PubSub.
2. No menu à esquerda, selecione a lâmina Keys , depois Gerador de URLs do Cliente.
3. Defina Hub para o nome do Chat Hub que adicionou, por exemplo chat.
4. Defina ID de Utilizador com qualquer nome, por exemplo alice. O chat usa isto como identidade de utilizador.
5. Copie o URL de Acesso ao Cliente.

Instalar o SDK do cliente

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

Liga-te, cria uma sala e envia uma mensagem

Guarde o código seguinte como index.mjs. Substitui <client-access-url> pelo URL que copiaste 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);

Executa:

node index.mjs

Vê uma saída semelhante a:

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