Guia de início rápido: incorporar o Web PubSub para Socket.IO em seu aplicativo

Este guia de início rápido demonstra como criar um Web PubSub para Socket.IO recurso e incorporá-lo rapidamente em seu aplicativo Socket.IO para simplificar o desenvolvimento, acelerar a implantação e obter escalabilidade sem complexidade.

O código mostrado neste início rápido está em CommonJS. Se você quiser usar um módulo ECMAScript, consulte a demonstração de bate-papo para Socket.IO com o Azure Web PubSub.

Pré-requisitos

Criar um Web PubSub para Socket.IO recurso

Para criar um Web PubSub para Socket.IO, você pode usar o seguinte botão de um clique para criar ou seguir as ações abaixo para pesquisar no portal do Azure.

• Use o botão a seguir para criar um Web PubSub para Socket.IO recurso no Azure

  

• Pesquisar a partir da barra de pesquisa do portal do Azure

  1. Aceda ao portal do Azure.

  2. Procure socket.io, na barra de pesquisa e, em seguida, selecione Web PubSub para Socket.IO.

     

• Pesquisar no Marketplace

  1. Aceda ao portal do Azure.

  2. Selecione o botão Criar um recurso, no canto superior esquerdo do portal do Azure. Digite socket.io na caixa de pesquisa e pressione enter. Selecione o Web PubSub para Socket.IO no resultado da pesquisa.

     

  3. Clique em Criar na página pop-out.

     

Enviando mensagens com bibliotecas Socket.IO e Web PubSub para Socket.IO

Nas etapas a seguir, você cria um projeto Socket.IO e integra com o Web PubSub para Socket.IO.

Inicializar um projeto de nó e instalar os pacotes necessários

mkdir quickstart
cd quickstart
npm init
npm install @azure/web-pubsub-socket.io socket.io-client

Escrever código do servidor

Crie um arquivo e adicione o server.js seguinte código para criar um servidor Socket.IO e integrar com o Web PubSub para Socket.IO.

As cadeias de conexão brutas aparecem neste artigo apenas para fins de demonstração. Em ambientes de produção, proteja sempre as suas chaves de acesso. Use o Azure Key Vault para gerenciar e girar suas chaves com segurança e proteger sua conexão com WebPubSubServiceCliento .

/*server.js*/
const { Server } = require("socket.io");
const { useAzureSocketIO } = require("@azure/web-pubsub-socket.io");

let io = new Server(3000);

// Use the following line to integrate with Web PubSub for Socket.IO
useAzureSocketIO(io, {
    hub: "Hub", // The hub name can be any valid string.
    connectionString: process.argv[2]
});

io.on("connection", (socket) => {
    // Sends a message to the client
    socket.emit("hello", "world");

    // Receives a message from the client
    socket.on("howdy", (arg) => {
        console.log(arg);   // Prints "stranger"
    })
});

Escrever código do cliente

Crie um client.js arquivo e adicione o seguinte código para conectar o cliente com Web PubSub para Socket.IO.

/*client.js*/
const io = require("socket.io-client");

const socket = io("<web-pubsub-socketio-endpoint>", {
    path: "/clients/socketio/hubs/Hub",
});

// Receives a message from the server
socket.on("hello", (arg) => {
    console.log(arg);
});

// Sends a message to the server
socket.emit("howdy", "stranger")

Quando você usa Web PubSub para Socket.IO, <web-pubsub-socketio-endpoint> e path são necessários para o cliente se conectar ao serviço. O <web-pubsub-socketio-endpoint> e path pode ser encontrado no portal do Azure.

1. Vá para a folha de teclas do Web PubSub para Socket.IO

2. Digite o nome do hub e copie o ponto de extremidade do cliente e o caminho do cliente

   

Executar a aplicação

1. Execute o aplicativo do servidor:

   node server.js "<connection-string>"
   

   O <connection-string> é a cadeia de conexão que contém o ponto de extremidade e as chaves para acessar seu Web PubSub para Socket.IO recurso. Você também pode encontrar a cadeia de conexão no portal do Azure

   

2. Execute o aplicativo cliente em outro terminal:

   node client.js